Breakdance MCP · Pro
Breakdance MCP: AI editing for Breakdance, node by node.
A Breakdance MCP server gives an AI agent the JSON document behind a Breakdance page. WP MCP reads that tree, changes only the nodes you asked about, and stores the row exactly the way Breakdance stores it.
Self-hosted · snapshot before every write · one-click undo
› Move the FAQ section to the bottom of the pricing page
get-builder-content node tree
⛨ document and CSS cache rows saved
update-builder-content operation move, CSS refreshed
✓ Section moved. Every other node is unchanged.
What it is
What a Breakdance MCP server does.
Breakdance saves a page as a JSON tree inside its _breakdance_data post meta, with generated CSS cache rows next to it. An MCP server for Breakdance reads that tree for the agent and takes node-level edits back, so a prompt like 'change the hero subheading' becomes one precise write.
Breakdance sites often use third-party or custom elements. WP MCP does not need to know an element to keep it safe: nodes it was not asked to change are stored byte for byte as they were.
Breakdance stores a page as one JSON document with a CSS cache beside it, and the risk in editing it is custom elements and responsive overrides an agent has never seen. WP MCP keeps the tree intact outside the nodes you ask about: unknown and custom elements are written back exactly as stored. Page snapshots also record how many elements and responsive overrides the page had, so a before-and-after comparison is quick.
Read and change
What WP MCP can read and change in Breakdance.
It can read
- Which pages are built with Breakdance
- A page's node tree, sections and elements
It can change
- Update, add, remove or move one node by id
- Replace the whole tree in one write
- Refresh the page's generated CSS through Breakdance after a write
These are the real ability and operation names the agent calls. TheBreakdance AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
List the sections on the Breakdance homepage in order.
Change the hero heading and subheading on /launch to match this copy.
Remove the countdown from the offer page and refresh its CSS.
List the sections on the Breakdance homepage in order.
get-builder-content returns the node tree of sections and elements; nothing is written.
Change the hero heading and subheading on /launch to match this copy.
update-builder-content changes those nodes by id and refreshes the generated CSS through Breakdance. The page is snapshotted first.
Remove the countdown from the offer page.
The node is removed and the CSS refreshed. rollback-operation restores the exact document and cache rows.
Safety
Every Breakdance write has a way back.
The Breakdance document and its CSS cache are post meta rows, so the post snapshot holds them before each write and rollback-operation restores the exact rows. Page snapshots also record how many elements and responsive overrides the page had, which makes a before and after easy to compare.
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.
Byte for byte outside the edit
Only the addressed nodes change. Elements WP MCP has never seen, including custom ones, are written back exactly as they were stored.
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 Breakdance 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
Breakdance pages on the site. Keep Breakdance active so the generated CSS refreshes right after an edit.
- 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 Breakdance. 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
Breakdance MCP: questions, answered.
What is Breakdance MCP?
It is Breakdance page editing for AI agents over the Model Context Protocol. WP MCP exposes the page's document tree to Claude, Cursor or any MCP client and writes node-level changes back, snapshotted first.
Does Breakdance need to be active?
Reads and writes work on the stored rows. The CSS refresh goes through Breakdance, so keep it active if you want an edit to show up styled straight away.
What about custom Breakdance elements?
They are kept exactly as stored. WP MCP only rewrites the nodes an operation addresses.
Can I roll back a Breakdance change?
Yes. rollback-operation restores the document and cache rows as they were before the write, and rollback-session unwinds an entire agent run.
Does this also cover Oxygen 6?
Oxygen 6 runs on the same engine and is supported too, with its own storage key. See the Oxygen MCP page for the details.
Will custom Breakdance elements survive an edit?
Yes. Elements WP MCP has never seen are written back exactly as they were stored, byte for byte outside the nodes addressed.
Should Breakdance stay active?
Yes. Keep it active so the page's generated CSS refreshes right after an edit.
Does Breakdance 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 Breakdance tools are available in every client the same way.
Keep exploring
MCP for Breakdance →
Read and edit Breakdance layouts node by node over MCP, byte for byte outside the edit, every write reversible.
Oxygen MCP →
An Oxygen MCP server gives an AI agent access to the element tree behind an Oxygen page.
Bricks MCP →
A Bricks MCP server lets an AI agent read and write the element data behind a Bricks Builder page.
Beaver Builder MCP →
A Beaver Builder MCP server lets an AI agent work on the rows, columns and modules of a Beaver Builder page.
Cornerstone MCP →
A Cornerstone MCP server lets an AI agent read and edit the element list behind a Cornerstone page, the builder used by X and Pro from Themeco.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.