Beaver Builder MCP · Pro
Beaver Builder MCP: an AI agent for your Beaver Builder pages.
A Beaver Builder MCP server lets an AI agent work on the rows, columns and modules of a Beaver Builder page. WP MCP reads the layout as a node tree, writes changes the way Beaver Builder publishes them, and will not throw away a colleague's unpublished draft.
Self-hosted · snapshot before every write · one-click undo
› Change the hero button text on the Beaver Builder landing page
get-builder-content node tree of rows, columns, modules
⛨ layout, draft and settings saved
update-builder-content operation update by node id, cache cleared
✓ Button updated. The editor opens on what is live.
What it is
What a Beaver Builder MCP server does.
Beaver Builder keeps a page as a map of nodes in post meta: the published layout, the editor's working draft, a settings twin for each, and an enabled flag. An MCP server for Beaver Builder gives an agent that map as a tree and accepts changes addressed by node id.
The detail that matters on a team site is the draft. If someone has unpublished changes open in the Beaver Builder editor, writing over the draft would discard them, and writing beside it would be overwritten on their next publish. WP MCP refuses the write until that draft is published or discarded.
Beaver Builder keeps a published layout and an editor draft side by side, which is the detail that decides whether an AI edit is safe. If a colleague has unpublished changes in the draft, writing over the published layout would silently discard their work. WP MCP checks for that first: a page whose draft differs from its published layout is refused until the draft is published or discarded. When it does write, it writes both together and clears the layout asset cache.
Read and change
What WP MCP can read and change in Beaver Builder.
It can read
- Which pages are built with Beaver Builder
- A page's node tree of rows, columns and modules
It can change
- Update, add, remove or move one node by id
- Replace the whole node tree in one write
- Write the published layout and the draft together and clear the layout asset cache
These are the real ability and operation names the agent calls. TheBeaver Builder AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
Is the About page built with Beaver Builder? List its rows and modules.
Update the heading module in the first row of the landing page to 'Get your free audit'.
Remove the empty column from the second row of /contact.
Is the About page built with Beaver Builder? List its rows and modules.
detect-builder and get-builder-content return the node tree of rows, columns and modules.
Update the heading module in the first row of the landing page to "Get your free audit".
update-builder-content changes one node by id, writes the published layout and the draft together, and clears the asset cache.
Remove the empty column from the second row of /contact.
The node is removed after a snapshot of the layout rows, and rollback-operation puts both published and draft back.
Safety
Every Beaver Builder write has a way back.
All of Beaver Builder's layout rows are post meta, so the post snapshot holds the published layout, the draft and their settings before any write, and rollback-operation restores them exactly. The layout asset cache is cleared so the front end rebuilds from what is stored.
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.
Unpublished drafts are protected
A page whose editor draft differs from its published layout is refused until the draft is published or discarded. An agent never silently overwrites work in progress.
Free or Pro
Part of WP MCP Pro.
The three builder tools (detect-builder, get-builder-content, update-builder-content) are part of WP MCP Pro. The free plugin still covers the rest of the site, including Gutenberg block editing, posts, pages, media, menus and the full snapshot and rollback engine, so you can try the safety model before you pay for builder editing.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect Beaver Builder 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
Beaver Builder pages on the site.
- 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 Beaver Builder. 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
Beaver Builder MCP: questions, answered.
What is Beaver Builder MCP?
It is Beaver Builder layout editing exposed to AI agents over the Model Context Protocol. With WP MCP, Claude, Cursor or any MCP client can read a page's node tree and change one node or the whole tree, snapshotted first.
What if someone is editing the page in Beaver Builder at the same time?
If the page's draft differs from its published layout, the write is refused. Publish or discard the draft, then run the change again.
Does an MCP edit publish immediately?
Yes. WP MCP writes the published layout and, when the page has a draft, the draft too, so the page and the editor agree. That is the same thing Beaver Builder does when you click publish.
Is the text copy in post_content updated?
No. Beaver Builder renders that copy on its own publish, and rendering a new one needs the plugin's front end, so it is left alone. The page renders from the layout, which is what gets edited.
Is Beaver Builder MCP free?
It is part of WP MCP Pro. The free plugin covers Gutenberg and the rest of the site with the same undo engine.
What happens if someone has an unpublished draft open?
The write is refused for that page. The agent reports that the draft differs from the published layout, and you publish or discard the draft before it can proceed.
Are nodes addressed by position or by id?
By id. Beaver Builder gives every node an id, so the agent addresses the node itself rather than counting rows and columns.
Does Beaver Builder 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 Beaver Builder tools are available in every client the same way.
Keep exploring
MCP for Beaver Builder →
Read and edit Beaver Builder layouts node by node over MCP, published the way Beaver Builder publishes, every write reversible.
WPBakery MCP →
A WPBakery MCP server turns the vc_row shortcodes behind your pages into something an AI agent can read and edit safely.
Breakdance MCP →
A Breakdance MCP server gives an AI agent the JSON document behind a Breakdance page.
Thrive Architect MCP →
A Thrive Architect MCP server gives an AI agent the layout behind a Thrive page or landing page.
Oxygen MCP →
An Oxygen MCP server gives an AI agent access to the element tree behind an Oxygen page.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.