Get Form 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 →

Get Form

Read-only
WPForms Forms wpforms/get-form

Get a single WPForms form's metadata, safe settings, and optionally its fields.

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 retrieves full detail for one WPForms form by ID: its title, status, dates, author, a safe subset of settings (form title, description, submit button text, and the ajax/honeypot/antispam flags), and, when include_fields is true (the default), an array of the form's fields with each field's id, type, label, description, required flag, and size. Because it exposes the form's full structure in one call, an AI assistant can review or reason about an existing form's configuration before suggesting or making changes.

See it in action

You ask your AI assistant

"Show me the full configuration of form ID 42, including all of its fields."

Inputs

Name Type Required Description
form_id integer Yes The ID of the form to retrieve.
include_fields boolean No Whether to include field configuration in the response. Defaults to true.

Returns

An object with the form's id, title, status, created and modified dates, author ID, a safe settings object (form_title, form_desc, submit_text, ajax_submit, honeypot, antispam), and, if requested, a fields array.

Permission

The current user must have the WPForms 'view_form_single' capability for the given form_id; otherwise a 403 WP_Error is returned. A missing or invalid form_id also returns an error.

Newsletter

The AI + WordPress space moves fast. Keep up.

New tools, workflow ideas, and product updates — be the first to know what's next.

No spam, unsubscribe anytime.