WPForms MCP · Pro
WPForms MCP: connect an AI agent to your WPForms data.
A WPForms MCP server lets an AI agent read your forms and what they collect. WP MCP lists forms, reads fields and notification settings, and on WPForms Pro reads entries and moves them between active, spam and trash, with a snapshot of the exact row first.
Self-hosted · snapshot before every write · one-click undo
› Show the last 10 entries on form 3 and flag the spam
wpforms-read list-entries, form 3
⛨ before-image of each entry row
wpforms-write update-entry-status, spam
✓ 3 entries flagged as spam. Each is one click from restored.
What it is
What a WPForms MCP server does.
WPForms keeps forms through its own form handler and, on WPForms Pro, keeps submissions through its entry handler. A WPForms MCP server presents both to an agent, so questions like 'what fields does the signup form have' or 'who is notified' get a direct answer instead of a trip through wp-admin.
WP MCP is honest about the Lite and Pro split. WPForms Lite stores no entries, so on Lite the entry operations answer wpforms_entries_unavailable while the form operations keep working. Nothing fails silently and nothing is invented.
WPForms comes in two shapes that behave differently: Lite, which stores no entries, and Pro, which does. WP MCP is explicit about that. Form, field and notification reads work on both, and the entry operations on Lite report that entries are unavailable instead of failing. On Pro, the entry status write goes through WPForms' own entry handler and is snapshotted as a before-image of exactly one row in the wpforms_entries table. Notification and confirmation edits work on both editions once the site opts in.
Read and change
What WP MCP can read and change in WPForms.
It can read
- WPForms forms, with id and title
- A form's fields, notification settings and confirmations
- On WPForms Pro: entries and their field values
It can change
- Edit a notification's subject, message, sender, reply-to, name or enabled state (opt-in)
- Change a notification's recipient (opt-in, needs confirm:true)
- Edit a confirmation's type, message, page or redirect url (opt-in, needs confirm:true)
- On WPForms Pro: move an entry between active, spam and trash
These are the real ability and operation names the agent calls. TheWPForms AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
What fields does the Newsletter signup form have, and which are required?
Who gets an email when the Contact form is submitted?
Go through this week's entries on the Support form and group them by topic.
What fields does the Newsletter signup form have, and which are required?
wpforms-read with list-forms returns the form and its fields; this works on WPForms Lite as well.
Who gets an email when the Contact form is submitted?
The form's notification settings are read and the recipients reported; nothing is written.
Go through this week's entries on the Support form and flag the spam.
On WPForms Pro, list-entries reads them and update-entry-status moves spam entries, each with a before-image and restorable.
Safety
Every WPForms write has a way back.
The status move goes through WPForms' own entry handler and is snapshotted as a before-image of exactly that row in the wpforms_entries table, so rollback-operation restores it. A notification or confirmation edit snapshots the form's posts row first, and rollback-operation restores it. Entry deletion is not offered.
Snapshot before every write
No tool that writes can skip it. The before-state is saved first, the change is applied second.
One-click undo
Restore a single change with rollback-operation or a whole agent run with rollback-session, from the agent or from wp-admin.
No entry deletion
Entry writes are limited to a reversible status move. An agent cannot permanently delete a WPForms entry.
Free or Pro
Part of WP MCP Pro.
WPForms support is part of the WP MCP Pro forms pack. On the WPForms side, form, field and notification reads work with WPForms Lite; entries need WPForms Pro, because Lite does not store them.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect WPForms MCP in four steps.
- 01Install WP MCP
Upload the free wpmcp plugin and activate it. It needs WordPress 6.9 or newer and PHP 8.1 or newer, and it runs entirely on your own server.
- 02Check the requirement
WPForms active. Entries need WPForms Pro. Notification and confirmation edits are off until the site enables them with the wpmcp_enable_forms_write filter.
- 03Connect your client
Add the site to Claude Code, Claude Desktop, Cursor or any MCP client with a WordPress application password, or the WP-CLI stdio bridge locally. OAuth 2.1 with full or read-only access is there too, once the site owner switches it on.
- 04Ask for the change
Describe what you want done in WPForms. WP MCP snapshots the target, makes the change, and leaves a Restore button next to it in wp-admin.
Step-by-step guides: Claude,Claude Code andCursor. The docscover the safety model in full.
Frequently asked
WPForms MCP: questions, answered.
What is WPForms MCP?
It is WPForms data made available to AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read forms, fields, notifications and, on WPForms Pro, entries.
Does WPForms MCP work with 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.
Can the agent delete entries?
No. Entry deletion is not offered; the entry write is a reversible status move.
Can it build or edit forms?
It cannot build forms or change their fields. Once the site opts in it can edit notifications, a notification's recipient and confirmations, each undone with rollback-operation.
Is WPForms MCP free?
It is part of the WP MCP Pro forms pack. The free plugin includes Contact Form 7 support.
What do I get on WPForms Lite?
Forms, fields and notification settings. Lite stores no entries, so entry operations report that entries are unavailable.
Can entries be deleted?
No. Deletion is not offered for WPForms, so an agent cannot permanently remove a WPForms entry. The entry write is a reversible status move.
Does WPForms MCP work with Claude, Claude Code and Cursor?
Yes. Claude Code and Cursor connect to WP MCP over HTTP with a WordPress application password, and Claude Desktop uses the desktop bundle from the WP MCP Connection screen. Clients that can only sign in with OAuth, such as the claude.ai custom connector, need OAuth switched on first with one line in wp-config.php, because it ships off. Once connected, the WPForms tools are available in every client the same way.
Keep exploring
MCP for WPForms →
Read WPForms forms, fields, notifications, confirmations and entries over MCP, move entries between active, spam and trash, and edit notifications and confirmations on opt-in, undoably.
Gravity Forms MCP →
A Gravity Forms MCP server lets an AI agent read what your forms collect and how they are wired: fields, notifications, confirmations, entries and notes.
Contact Form 7 MCP →
A Contact Form 7 MCP server lets an AI agent answer the questions you normally click around for: which forms exist, who each one emails, what came in this week.
Yoast SEO MCP →
A Yoast SEO MCP server lets an AI agent read and write the fields in the Yoast box under every post, without anyone opening those posts one by one.
ACF MCP →
An ACF MCP server lets an AI agent understand your content model and work with it: see which fields a post type has, fill them in, or add a new field group.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.