List Forms is a WordPress ability from Ninja Forms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.
Install Free Plugin →List Forms
Read-onlyList all Ninja Forms forms on the site, optionally filtered by title, with field/action counts.
Requires the Ninja Forms plugin on WordPress 6.9+ for the Abilities API (all 32 abilities are registered only when the wp_register_ability() function exists, via NF_Abilities_Integration::load_abilities_api() running on plugins_loaded). Every ability is gated by the same ninja_forms_ability_can_manage_forms() permission callback, requiring the caller to hold WordPress's manage_options capability or Ninja Forms' own nf_edit_forms capability.
What it does
This ability returns every form on the site (or those whose title partially matches a search string), each with its id, title, created_at timestamp, and — when requested — a field_count and action_count. Results can be capped with limit. It's the lookup step an AI assistant is expected to run before any form-targeting ability (add-field, update-form, delete-form, etc.) whenever the user refers to a form by name rather than by numeric ID, so the assistant can resolve the right form_id instead of guessing.
See it in action
You ask your AI assistant
"List all my Ninja Forms forms with the word 'Contact' in the title."
Inputs
| Name | Type | Required | Description |
|---|---|---|---|
| title | string | No | Partial-match filter on form title. |
| include_fields | boolean | No | Include each form's field_count. Defaults to true. |
| include_actions | boolean | No | Include each form's action_count. Defaults to true. |
| limit | integer | No | Maximum forms to return; 0 means no limit. Defaults to 0. |
Returns
An object with a 'success' boolean, a 'forms' array (each with id, title, created_at, field_count, action_count and settings), a 'count' of matched forms, and a 'message'.
Permission
The current user must have WordPress's 'manage_options' capability or Ninja Forms' own 'nf_edit_forms' capability (checked via the shared ninja_forms_ability_can_manage_forms() permission callback).
More Ninja Forms abilities
Add Action
Add a post-submission action to a form — email, redirect, success message, or save.
Add Calculation
Add a calculator formula to a form for use in calc fields and conditional logic.
Add Field
Add a single field to an existing form, to be called once per field when building out a form.
Create Form
Create a new Ninja Forms form, optionally with fields, actions, and calculations, in a single call.
Delete Action
Permanently delete an action from a form.
Delete Calculation
Permanently delete a calculation from a form.