Fluent Forms MCP · Pro
Fluent Forms MCP: forms and submissions, sorted by an AI agent.
A Fluent Forms MCP server lets an AI agent read what a form collects and work through the submissions it received. WP MCP reads forms, fields, email notifications and entries through Fluent Forms' own query builder, and changes a submission's status the way Fluent Forms' entries screen does, with a snapshot of the row first.
Self-hosted · snapshot before every write · one-click undo
› Mark this week's unread Signup submissions as read and flag the spam
fluentforms-read list-entries, form 4, status unread
⛨ before-image of each submission row
fluentforms-write update-entry-status, read and spam
✓ 12 marked read, 4 flagged as spam. Each one is restorable.
What it is
What a Fluent Forms MCP server does.
Fluent Forms keeps forms and their field definitions in one table, email notifications as form meta rows, and submissions in a table with a status column: unread, read, spam or trashed. A Fluent Forms MCP server turns that into calls an agent can make, so 'what came in on the Signup form this week' gets a direct answer.
WP MCP writes the status column and then fires fluentform/after_submission_status_update, the same action Fluent Forms fires from its own screen, so add-ons listening for status changes still react. Deleting a submission is possible too, but it is off by default, needs confirmation, and is refused for any submission with a payment record.
Read and change
What WP MCP can read and change in Fluent Forms.
It can read
- Fluent Forms forms, with id and title
- A form's fields: input name, element type, label and whether it is required
- A form's email notifications: recipient, subject, message and whether each is enabled
- Submissions, newest first, filtered by status and paged, with trashed ones left out unless asked for
- A single submission with its response, serial number, date and IP address
It can change
- Set a submission to unread, read, spam or trashed
- Delete a submission with its values and logs (opt-in, needs confirm:true, restorable)
These are the real ability and operation names the agent calls. TheFluent Forms AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
What does the Signup form collect, and who does its admin notification go to?
List the unread submissions on the Quote form and summarise what people are asking for.
Show me the trashed submissions on form 4 and move back any that look genuine.
Safety
Every Fluent Forms write has a way back.
A status change is snapshotted as a before-image of exactly that submission row, so rollback-operation restores the previous status. A delete snapshots every row it removes, across the submission, its values, logs and meta, and rollback-session puts them all back. An undo cannot reverse what a listening add-on did in response to the status action.
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.
Payment submissions are left alone
Deleting is off until the site opts in, needs confirm:true, and is refused with entry_has_payments when a submission has a Fluent Forms payment, order or subscription record.
Free or Pro
Part of WP MCP Pro.
Fluent Forms support is part of the WP MCP Pro forms pack, and it needs only the free Fluent Forms plugin, not Fluent Forms Pro. With an active licence, Pro keeps unlimited snapshot history for these writes; the free plugin keeps the last 20. Contact Form 7 support is in the free plugin.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect Fluent Forms 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
Fluent Forms active; the free plugin is enough. Deleting a submission is off until the site enables it 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 Fluent Forms. 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
Fluent Forms MCP: questions, answered.
What is Fluent Forms MCP?
It is Fluent Forms data made available to AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client read forms, fields, email notifications and submissions, and change a submission's status.
Do I need Fluent Forms Pro?
No. The integration uses the wpFluent() query builder that the free Fluent Forms plugin ships, so forms, notifications and submissions read the same on either edition.
Which submission statuses can the agent set?
unread, read, spam and trashed, the values Fluent Forms itself uses. A trashed submission stays in the table and can be set back to read.
What happens to uploaded files when a submission is deleted?
They stay on disk. The delete removes the submission's database rows directly, so Fluent Forms' own delete hooks do not run, and every row is snapshotted first so rollback-session can restore it. A snapshot copy remains until it is pruned, so this is not a privacy erasure.
Is Fluent Forms MCP free?
It is part of the WP MCP Pro forms pack. The free plugin includes Contact Form 7, Forminator, SureForms and MetForm support.
Does Fluent Forms 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 Fluent Forms tools are available in every client the same way.
Keep exploring
MCP for Fluent Forms →
Read Fluent Forms forms, fields, notifications and submissions over MCP, change a submission's status, and delete one on opt-in, undoably.
Formidable Forms MCP →
A Formidable Forms MCP server lets an AI agent read your forms, their fields and the entries they collect, and see what happens on submit.
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.
WPForms MCP →
A WPForms MCP server lets an AI agent read your forms and what they collect.
FluentCRM MCP →
A FluentCRM MCP server lets an AI agent look after your email list: find contacts, tag them, sort them into lists, draft a campaign.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.