List SureForms Forms is a WordPress ability from SureForms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List SureForms Forms
Read-onlyRetrieve a paginated list of SureForms forms, filterable by status and title search.
Requires the SureForms plugin on WordPress 6.9+ (the Abilities API is gated behind function_exists('wp_register_ability'), so it degrades gracefully on WP 6.4-6.8). Abilities only register when the 'srfm_abilities_api' option is enabled in SureForms' AI settings, and every ability requires the current user to have the 'manage_options' capability. Abilities that create or modify data additionally require the 'srfm_abilities_api_edit' option to not be explicitly disabled; abilities that permanently delete data additionally require 'srfm_abilities_api_delete' to not be explicitly disabled.
What it does
This ability queries SureForms forms (a custom post type) and returns each form's ID, title, status, publish date, and entry count. You can filter by status (publish, draft, trash, or any), search by title, and page through results with per_page (1-100) and page. Entry counts are computed in a single batched query against the entries table to avoid an N+1 lookup per form. It gives an AI assistant a fast overview of what forms exist on the site before drilling into any one of them.
See it in action
You ask your AI assistant
"List all my published SureForms forms and tell me which ones have the most submissions."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| status | string | No | Filter by form status: publish, draft, trash, or any. Defaults to any. |
| search | string | No | Search forms by title. |
| per_page | integer | No | Number of forms per page (1-100). Defaults to 10. |
| page | integer | No | Page number for pagination. Defaults to 1. |
Returns
An object with a forms array (each item has id, title, status, date, and entry_count), plus total and pages counts.
Permission
Requires the 'manage_options' capability, and the 'srfm_abilities_api' master option must be enabled. This ability has no additional gate option.
More SureForms abilities
Bulk Get Entry Details
Retrieve full submitted data for up to 50 SureForms entries in a single call.
Create SureForms Form
Create a new SureForms form from a title, an array of field definitions, and optional metadata.
Delete Entry
Permanently delete one or more SureForms submission entries.
Delete SureForms Form
Move a SureForms form to trash, or permanently delete it when force is set.
Duplicate SureForms Form
Clone an existing SureForms form, including its fields, metadata, and settings, as a new draft.
Get Entry Details
Retrieve the full submitted data for a single SureForms entry, with field labels resolved.