Get the plugin
WP MCP/Integrations/Forms

Forms integration

WPForms AI agent tool reference

WPForms stores forms through wpforms()->form and, on WPForms Pro, submissions through its entry handler. WP MCP Pro exposes both as a wpforms-read and wpforms-write pair: list forms, read a form's fields, notification settings and confirmations, list and read entries, and move an entry between active, spam and trash through the handler's own update. That write is snapshotted as a before-image of exactly that row in the wpforms_entries table, so rollback-operation restores it. Once a site opts in with the wpmcp_enable_forms_write filter, the agent can also edit a notification, change its recipient (confirm:true) and edit a confirmation (confirm:true), each snapshotted as the form's posts row and undone with rollback-operation. On WPForms Lite, which stores no entries, the entry operations answer wpforms_entries_unavailable while the form operations keep working.

wpforms-readwpforms-writelist-formslist-entriesupdate-entry-status

In practice

How WPForms work goes with an agent.

WPForms splits its data between two places. Forms are posts whose content is a JSON definition, decoded through wpforms()->form, while entries exist only on WPForms Pro, in a table the plugin's entry handler manages. WP MCP Pro mirrors that split. Form, field and notification reads work on any edition, and the entry operations check for entry storage first and answer wpforms_entries_unavailable on Lite instead of failing midway. An agent can therefore tell, from the first call, whether there is any submission data to triage.

What fields does the Newsletter signup form have, and are any required?

Runs wpforms-read with list-fields for that form_id. Each field returns its id, type, label, whether it is required, and the choices for choice fields. It works on WPForms Lite and Pro and is read only.

Is the admin notification on for the Contact form, and what are the reply-to and subject?

Runs list-notifications, which returns each notification's name, enabled state, recipient, sender, reply-to, subject and template, plus whether notifications are switched on for the form at all. Read only.

Show the last 10 entries on form 3, and read the full detail of the two that look odd.

Runs list-entries with page_size 10, then get-entry for each. A full entry includes values, status, starred and viewed flags, date, IP address and user agent. Needs WPForms Pro entry storage and manage_options.

Move entry 41 to spam, then change your mind and bring it back.

Runs update-entry-status with spam through the WPForms entry handler, after a before-image of that row in wpforms_entries. rollback-operation then restores the entry, or a second call sets status active.

What your AI can do

Real WPForms operations, every write reversible.

  • List WPForms forms with id and title
  • Read a form's fields, notification settings and confirmations
  • Edit a notification and change its recipient (opt-in, reversible)
  • Edit a confirmation message, page or redirect (opt-in, confirm:true, reversible)
  • On WPForms Pro: list and read entries
  • On WPForms Pro: move an entry between active, spam and trash, reversibly

Example prompts

Example WPForms prompts.

What fields does the Newsletter signup form have?

Who gets notified when the Contact form is submitted?

Show me the last 10 entries on form 3 and flag the spam.

Under the hood

The WPForms calls, under the hood.

wpmcp, wpforms

wpforms-read({ operation: "list-entries", args: { form_id: 3 } }), needs WPForms Pro

wpforms-write({ operation: "update-entry-status", args: { entry_id: 41, status: "spam" } }), row snapshotted, reversible

Safety and access

What can be undone on WPForms, and what costs what.

Recoverable on WPForms

  • update-entry-status takes a before-image of exactly that row in the wpforms_entries table.
  • rollback-operation restores the entry's previous status.
  • Moving an entry back to active is also available as an ordinary call with status active.

WPForms limits and opt-ins

  • On WPForms Lite there are no entries, so the entry operations answer wpforms_entries_unavailable while the form reads keep working.
  • Entry deletion is not offered. The entry write is a status move between active, spam and trash.
  • Notification and confirmation edits are off until the site opts in with the wpmcp_enable_forms_write filter; set-notification-recipients and update-confirmation need confirm:true. Each snapshots the form's posts row and is undone with rollback-operation.
  • Forms and fields are read only here.
  • Every entry operation needs manage_options because entries are personal data.

Free or Pro: The WPForms integration is Pro on the WP MCP side: wpforms-read and wpforms-write register only with a WP MCP Pro licence and while WPForms is active. Separately, entries need WPForms Pro, since WPForms Lite stores none. That gives three cases: WPForms Lite gets form, field, notification and confirmation reads plus the opt-in notification and confirmation edits, WPForms Pro adds entries and the status move, and the free WP MCP plugin does not expose WPForms.

Part of WP MCP Pro

The WPForms integration is part of WP MCP Pro.

One Pro licence unlocks the WPForms tools and every other Pro integration on this site: Elementor deep editing, the other page builders, the forms adapter pack and more, 133 Pro tools in all. The free plugin still covers the rest of WordPress and the full snapshot and undo engine, so you can try the safety model before you buy.

Frequently asked

WPForms MCP: questions, answered.

Does it work on WPForms Lite?

The form, field and notification reads do. WPForms Lite stores no entries, so the entry operations report that entries are unavailable rather than failing.

With WPForms, can the agent delete entries?

No. Entry deletion is not offered for WPForms; the entry write is a reversible status move. The other writes edit notifications and confirmations, off until the site opts in.

What does an agent see on WPForms Lite?

Forms, their decoded field definitions and their notification settings. Any entry call returns wpforms_entries_unavailable with a message that entry storage is not part of WPForms Lite, so the agent can report that cleanly instead of treating it as a broken integration.

How does the status filter on entries work?

list-entries accepts spam or trash as a filter. With no filter it lists every entry newest first, each with its status, so an agent sees spam and trash alongside active ones. Paging uses page_size (default 20, maximum 100) and an offset. The write accepts active, spam or trash.

Does get-entry include submitter details?

Yes. A full entry carries submitted field values, status, starred and viewed flags, date, IP address and user agent. That is why every entry operation needs manage_options. Treat the output as personal data when you paste it elsewhere or share the conversation.

Will the WPForms integration show me whether notifications are enabled?

Yes. list-notifications returns each notification with its enabled state, plus whether notifications are switched on for the form as a whole. That distinction explains the common case where a notification is set up correctly but the form-level toggle is off.

Is there an AI agent for WPForms?

Yes, through WP MCP rather than WPForms itself. An agent you choose, such as Claude or Cursor, can list WPForms forms with id and title. WP MCP is a separate plugin, not a built-in AI feature of WPForms. On the undo side: update-entry-status takes a before-image of exactly that row in the wpforms_entries table.

Point your AI at WPForms.