List Forms is a WordPress ability from WPForms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List Forms
Read-onlyList WPForms forms filtered by status, with pagination.
Requires the WPForms plugin on WordPress 6.9+ (abilities only register when the wp_register_ability() function exists). Read abilities need the WPForms 'view_forms' or 'view_form_single' capability. The four write abilities (create-form, update-form-settings, add-field, update-field) additionally require the 'Enable MCP Write Access' toggle (the ai-mcp-write-enabled setting under WPForms → Tools → AI MCP) to be turned on, plus the 'create_forms' or 'edit_form_single' capability — without both, they return a 403 error and are hidden from MCP clients entirely.
What it does
This ability returns a paginated list of WPForms forms, each summarized with its ID, title, status, creation date, last-modified date, and author ID. Results can be filtered by status (publish, draft, or trash — defaulting to publish) and paged through with a limit (1-100, default 20) and offset, and the response includes a total count of forms matching the requested status. This gives an AI assistant a quick inventory of a site's forms without opening the WPForms list table in wp-admin.
See it in action
You ask your AI assistant
"List all of my published WPForms forms."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| status | string | No | Filter forms by status: publish, draft, or trash. Defaults to publish. |
| limit | integer | No | Maximum number of forms to return (1-100). Defaults to 20. |
| offset | integer | No | Number of forms to skip, for pagination. Defaults to 0. |
Returns
An object with a forms array (each entry has id, title, status, created, modified, and author) and a total count of forms matching the requested status.
Permission
The current user must have the WPForms 'view_forms' capability (checked via wpforms_current_user_can('view_forms')); otherwise a 403 WP_Error is returned.
More WPForms abilities
Add Field
Add a new field of a given type to an existing WPForms form.
Create Form
Create a new WPForms form, optionally pre-populated with fields and settings.
Describe Editing Schema
Discover which field types, field properties, and form settings can currently be created or edited.
Get Form
Get a single WPForms form's metadata, safe settings, and optionally its fields.
Get Form Stats
Get basic stats for a form; detailed entry statistics require WPForms Pro.
Update Field
Update properties of an existing field on a WPForms form.