List Forms is a WordPress ability from Fluent Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List Forms
Read-onlyFind and filter forms with compact rows so the agent can discover the form_id it needs for other tools.
Needs the Fluent Forms MCP server switched on in FluentForm → Settings → MCP, and WordPress 6.9+ so wp_register_ability() exists (abilities are only registered when the function is present). Reaching the server also requires a logged-in WordPress user holding at least one FluentForm capability. Each ability additionally checks a specific FluentForm capability (e.g. fluentform_dashboard_access, fluentform_forms_manager, fluentform_entries_viewer, fluentform_manage_entries, fluentform_view_payments, fluentform_settings_manager) via the plugin's own Acl system, and every write ability requires a two-step dry_run → confirm_token round-trip through WriteGuard before anything is persisted. Note (from source comments): a WordPress role granted FluentForm access via the Role Manager passes every per-ability capability check, including delete-submission and bulk delete_permanently — the real boundary for such a user is 'has FluentForm access, restricted to their form scope', not per-tool separation; only individually-assigned 'specific forms' managers are gated the way each ability's declared capability implies.
What it does
Returns a paginated, filterable catalogue of the caller's accessible forms — id, title, status, type, and entry count for each — so an agent can locate the form_id required by list-submissions, get-form-stats, and every other form-scoped tool without opening the admin UI. Results can be searched by title, filtered by status (published or unpublished), and sorted ascending or descending by id; a "specific forms" manager only ever sees their assigned forms, enforced by FormAccess scoping on the underlying query, not by client-side filtering.
See it in action
You ask your AI assistant
"List all my published forms, newest first."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| search | string | No | Matches form title. |
| status | string | No | Filter by form status: published or unpublished. |
| sort_by | string | No | Sort direction by form id: ASC or DESC. Defaults to DESC. |
| page | integer | No | Page number. Defaults to 1. |
| per_page | integer | No | Results per page. Defaults to 15, maximum 100. |
Returns
A paginated envelope with a summary message, a forms array (id, title, status, type, entries, created_at), and paging metadata (page, per_page, total, total_pages).
Permission
Requires the fluentform_forms_manager or fluentform_dashboard_access capability.
More Fluent Forms abilities
Add Submission Note
Attach an internal staff note to one entry; not visible to the submitter.
Bulk Update Submissions
Apply one action — read, unread, trashed, favorite, unfavorite, or permanent delete — to up to 200 entries at once.
Create Form
Create a new form from a title and an ordered list of fields, or a basic contact form by default.
Create or Update Email Notification
Create a new email notification or update an existing one — including its recipient.
Delete Submission
Permanently delete one entry and its uploaded files.
Get Form
Load one form's full detail, including its field schema, so the agent knows the exact field keys used in submissions.