# Breakdance MCP: Agent Connector vs Respira, and using both

> Breakdance 3.0 ships its own MCP, the Agent Connector. What it does, what Respira adds on live sites (a copy first, 90-day undo) and how to run both.

Source: https://www.respira.press/breakdance-mcp

---

# *Breakdance* MCP server, with undo on every edit.

A Breakdance MCP server lets Claude, ChatGPT or Cursor read and edit Breakdance pages on a live WordPress site. Breakdance 3.0 ships its own, the Agent Connector, built for building from a prompt. Respira works next to it: every edit lands on a copy first, and you can undo it for 90 days.

[Start free](https://www.respira.press/signup) [Connect in one command](#setup) 

7 days free. No card. Runs on the AI subscription you already have.

Support

Full

Breakdance tools

Core set

Latest release touching it

9.3.13

Releases touching it

77

Respira is an independent MCP server. Not affiliated with, endorsed by, or sponsored by Soflyy / Breakdance.

## Breakdance MCP in 79 seconds.

 79 seconds, with captions. Also on [YouTube](https://www.youtube.com/watch?v=KVJV9WZbxVQ). 

## Breakdance 3.0 has its own MCP. Respira works next to it.

Breakdance 3.0 ships the Agent Connector. Install it from Breakdance > Settings > Agents & MCP and Claude, ChatGPT, Codex, Cursor or another MCP client builds pages, templates, selectors and variables in Breakdance. Respira is the layer for the edits that follow on live sites, and the same connection for every other builder you run.

__Breakdance Agent Connector compared with Respira__
| Topic | Breakdance Agent Connector | Respira |
| --- | --- | --- |
| Built for | Building from a prompt: the agent writes HTML and CSS, and Breakdance turns it into elements, selectors and Global Blocks. | Editing what is already live: it reads the Breakdance element tree and changes the element you name, leaving the rest as built. |
| Where an edit lands | Written into Breakdance directly. A change to variables keeps the old values as a revision. | On a draft copy of a published page, which goes live when you approve it. A snapshot is taken first, and one restore undoes it for 90 days. |
| What you switch on | Breakdance 3.0, then the Agent Connector from its settings. | The Respira plugin, connected once. Nothing changes inside Breakdance. |
| Your other client sites | Breakdance only. | The same tools on 19 page builders, and WooCommerce through the add-on. |

Use both: let the Agent Connector build a new site or section from a prompt, and connect Respira for the changes after launch on client sites, where a copy to approve and a way back matter.

Their documentation: [Breakdance 3.0 announcement](https://breakdance.com/meet-breakdance-3-0/)

## What works today. What still needs you.

Read from the current MCP server release, first-class reads and writes across the builder structure.

### Works now

- Where a template applies, read and set without wp-admin (plugin 9.3.1+): entire site, front page, the blog, post types, archives, terms, individual pages, authors, dates, search, 404 and excludes, with conflicts decided by Breakdance itself and one-call undo (`wordpress_get_template_conditions`, `wordpress_set_template_conditions`). Proven by real page requests on Breakdance 2.8.3 (free).
- Element tree reads return the actual Breakdance JSON, not just rendered HTML.
- Per-element writes through the structure-aware patch path preserve children and attributes.
- Global Blocks: list, insert by reference, swap underlying definition, references on every page auto-update.
- Global Styles (colors, typography, sizes) read + write through Respira-managed options where Breakdance doesn't expose a native API.
- Snapshot before every write; rollback through the standard recovery tools.
- Breakdance Headers and Footers (theme builder) listed and assignment rules readable.

### Where a human still steps in

- Template conditions change the live site at once, so a person has to agree first. Breakdance gives a template one type, so a front page and some posts need two templates, and that is refused by name. It has no rule that excludes a post type, the front page, search or a 404\. Conditions it cannot name, custom PHP among them, stay untouched, and conflicts are checked on sample pages, not every page. Not tested with WPML. On Breakdance free, a Pro condition always passes, so Respira refuses archive, author and blog rules there; whole types, pages by id and posts by term work. Before Breakdance 2.8 an exclude on a template that covers more than single posts is refused, because it would also hide the template on 404 pages. Breakdance Pro archive rules have not been run on a real Pro licence yet, and Breakdance 3.0 has not been rerun. With a block theme active, a write has to name builder "breakdance".
- Some Breakdance Pro display conditions (cookie-based, query-based) read but only the simple ones (logged-in, role, post type) write today.
- WooCommerce-specific Breakdance elements work for content edits; deeper Woo product-loop tuning still goes through the Breakdance UI.
- Form Builder submissions are visible through `respira_list_custom_posts`; the form configuration itself is read-only via the MCP.

Hit one of these and the snapshot gives you a clean way back.

## Breakdance runs on the universal tools.

 Find, update, move and remove elements, build whole pages, snapshot and roll back. Reads return the builder structure and writes keep it intact. 

[Browse every tool](https://www.respira.press/tools)

## Three prompts you can paste right now.

Each one assumes Respira is connected to a Breakdance site. Paste it into your AI tool and run.

1. ### Audit Global Block usage  
```  
List every Breakdance Global Block on the site, what pages reference it, and how many times each is used. Output a markdown table.  
```
2. ### Swap a Global Block site-wide  
```  
Replace every reference to Global Block "cta-old" with "cta-2026" across all published pages. Snapshot each page first and show me the diff.  
```
3. ### Update a global color  
```  
Change the Breakdance global color "brand-primary" from its current value to #1f6feb. Tell me how many pages and Global Blocks will visually change.  
```

More recipes, per builder, in the [Prompt Book](https://www.respira.press/prompt-book).

## Connect a Breakdance site in two minutes.

Pick your client and paste. The site URL and key come from [your dashboard's MCP setup page](https://www.respira.press/dashboard/mcp), or from **Respira › Settings › API keys & MCP** in wp-admin (New key). Node.js 20 or newer for the local server.

### Claude Code

```
claude mcp add respira-wordpress --env WORDPRESS_URL=https://yoursite.com --env WORDPRESS_API_KEY=respira_your_api_key_here -- npx -y @respira/wordpress-mcp-server@latest
```

Put in your own site URL and key, run it, then check with `/mcp`. Every site at once: pass `--env RESPIRA_CONFIG_B64=…` from your setup page instead of the two values. [The full Claude Code guide](https://www.respira.press/blog/claude-code-wordpress) covers the first edit and undo.

### Claude Desktop and Cursor

```
{
  "mcpServers": {
    "respira-wordpress": {
      "command": "npx",
      "args": ["-y", "@respira/wordpress-mcp-server@latest"],
      "env": {
        "WORDPRESS_URL": "https://yoursite.com",
        "WORDPRESS_API_KEY": "respira_your_api_key_here"
      }
    }
  }
}
```

- Claude Desktop, macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Claude Desktop, Windows: `%APPDATA%\Claude\claude_desktop_config.json`
- Cursor: `.cursor/mcp.json` in your project

The file is `claude_desktop_config.json`, not `config.json`. Every site at once: replace the two `env` values with `RESPIRA_CONFIG_B64` from your setup page.

### Codex

```
codex mcp add respira-my-site --url https://yoursite.com/wp-json/respira/v1/mcp
codex mcp login respira-my-site
```

Run them one at a time. The second opens your browser to sign in to Respira; no key goes in the config. By hand, in `~/.codex/config.toml`, then run the login command:

```
[mcp_servers.respira-my-site]
url = "https://yoursite.com/wp-json/respira/v1/mcp"
```

### Browser sign-in, no key

```
https://yoursite.com/wp-json/respira/v1/mcp
```

Claude Desktop, claude.ai, ChatGPT and Cursor: add a custom connector, paste your site's MCP URL, leave Client ID and Client Secret blank, and approve the sign-in on respira.press. One connector per site.

### Any other client

```
npx add-mcp "npx -y @respira/wordpress-mcp-server@latest"
```

Detects Claude Code, Cursor, Codex, Windsurf and more, and writes the config. Set `WORDPRESS_URL` and `WORDPRESS_API_KEY` afterwards.

### Common errors

The server does not show up in /mcp, or the client says it failed to start.

Cause Node.js is older than 20, or the site URL and key are missing.

Fix Run `npx @respira/wordpress-mcp-server --doctor` in the same shell. It names the missing setting, a bad URL or a refused key. `node -v` must print 20 or newer.

ENOENT errors that mention `/_npx/` or `node_modules`.

Cause The npx cache is damaged, often by an interrupted install.

Fix Run `rm -rf ~/.npm/_npx` and restart the client. Or install once with `npm install -g @respira/wordpress-mcp-server` and use `respira-wordpress-mcp` as the command.

The browser sign-in opens a "Page not found" on `yoursite.com/authorize`.

Cause A Client ID was filled in on the connector, usually the `respira_site_` key.

Fix Remove the connector and add it again with the MCP URL only. Leave Client ID and Client Secret blank. Sign-in happens on respira.press, never on your site.

The MCP address returns 404.

Cause WordPress is on plain permalinks, so `/wp-json/` addresses do not resolve.

Fix In wp-admin open **Settings › Permalinks**, choose **Post name** and save once.

Calls fail with 401, 403, or HTML where JSON belongs.

Cause A firewall, a bot filter or a challenge page answers before WordPress does, or the host strips the Authorization header.

Fix Open **Respira › Troubleshoot** in wp-admin. It runs the checks from the site's own server, names what is in the way and writes a report for your host.

The agent says it saved, and the live Breakdance page looks the same.

Cause The edit is on a draft duplicate, waiting for your approval. That is the default on a published page.

Fix Approve the duplicate in wp-admin under Respira, or from its preview page. Until then the live page stays as it was.

Still stuck? [Troubleshooting in the docs](https://www.respira.press/docs/troubleshooting), or write to [word@respira.press](mailto:word@respira.press) with the first error line.

## What changed for Breakdance lately.

The last 5 releases that mention Breakdance, filtered from the same changelog the releases page reads.

1. [9.3.13](https://www.respira.press/releases#plugin-v-9-3-13) Nov 12, 2026  

  - A <main> with classes of its own keeps them, so the room it leaves under a fixed header is kept, and a footer or other top-level element that holds only text no longer gets its padding twice. On Breakdance its two ends of text no longer run together.
2. [9.3.1](https://www.respira.press/releases#plugin-v-9-3-1) Nov 1, 2026  

  - Snapshots and meta reads no longer show what they should not. get\_snapshot and meta reads no longer return custom PHP from Breakdance and Oxygen template settings, a Bricks template password, or the raw rows of a delete snapshot.
  - Restoring a whole Oxygen 6 template brings its conditions back , as it does on Breakdance. Divi snapshots now hold Divi's real template keys.
  - Oxygen classic or Breakdance with a block theme active: a write needs builder "oxygen" or "breakdance" in the request.
3. [mcp-8.7.2](https://www.respira.press/releases#mcp-v-8-7-2) Nov 1, 2026  

  - Template conditions (plugin 9.3.1+): wordpress\_get\_template\_conditions and wordpress\_set\_template\_conditions read and set where a site template applies, in the same plain words on every builder with the builder's own value beside them.
4. [9.2.7](https://www.respira.press/releases#plugin-v-9-2-7) Oct 15, 2026  

  - A generic section on a Beaver Builder page shows its content. The shape agents send to every builder, a section holding a heading and text, was saved on Beaver with "section" and "text" as module names. Beaver has neither, so the page showed nothing but its title while the write said success.
5. [9.2.6](https://www.respira.press/releases#plugin-v-9-2-6) Oct 15, 2026  

  - A heading sent with a title shows its words on Breakdance, Oxygen 6 and Beaver Builder. Most agents send a heading as type heading with its words in title. Breakdance stored them where its Heading does not read, so the heading was empty; Oxygen 6 wrote its placeholder "Heading"; Beaver kept them in a field its heading module ignores.

[All 77 releases that touched Breakdance](https://www.respira.press/releases?builder=breakdance)

## Questions people ask about Breakdance and MCP.

Breakdance has its own MCP now. Do I still need Respira? 

Breakdance 3.0's Agent Connector is made for building: an agent turns a prompt into Breakdance pages, templates and selectors. Respira is made for editing live sites: a change to a published page lands on a copy you approve, a snapshot gives 90 days of undo, and the same connection covers your sites on other builders. You can connect both to one site.

Is there an MCP server for Breakdance? 

Yes. Respira is an independent MCP server that reads and writes Breakdance in its own format, with first-class reads and writes across the builder structure. It is not made by the Breakdance team.

Which tools does it use for Breakdance? 

Breakdance runs through the universal tools: find, update, move and remove elements, build pages, snapshot and roll back. Reads return the builder structure, and writes keep it.

What happens when the agent gets an edit wrong? 

Nothing on the live page. The agent edits a copy first, you approve it inside WordPress, and every write is snapshotted with 90 days of undo.

Do I need a developer or a terminal? 

No. Sign in with your browser from Claude, ChatGPT or Cursor and approve the connection once. Coding tools get a one-line command.

Does it work with a Breakdance site that also runs WooCommerce? 

Yes. The WooCommerce add-on adds 104 store tools on the same connection, with the same duplicate-first approval flow.

Looking for the Breakdance overview, with visuals and the conversion story? [Breakdance features](https://www.respira.press/integrations/breakdance)

## The other builders, same server.

- [ ! Gutenberg Full ](https://www.respira.press/gutenberg-mcp)
- [ ! Elementor Full ](https://www.respira.press/elementor-mcp)
- [ ! Divi Full ](https://www.respira.press/divi-mcp)
- [ ! Bricks Deep ](https://www.respira.press/bricks-mcp)
- [ ! WPBakery Partial ](https://www.respira.press/wpbakery-mcp)
- [ ! Oxygen Full ](https://www.respira.press/oxygen-mcp)
- [ ! Beaver Builder Full ](https://www.respira.press/beaver-mcp)
- [ ! Flatsome Full ](https://www.respira.press/flatsome-mcp)
- [ ! Kadence Blocks Full ](https://www.respira.press/kadence-mcp)
- [ ! Spectra Full ](https://www.respira.press/spectra-mcp)
- [ ! GenerateBlocks Full ](https://www.respira.press/generateblocks-mcp)
- [ ! GreenShift Full ](https://www.respira.press/greenshift-mcp)
- [ ! Brizy Partial ](https://www.respira.press/brizy-mcp)
- [ ! Visual Composer Partial ](https://www.respira.press/visual-composer-mcp)
- [ ! Thrive Architect Text edits ](https://www.respira.press/thrive-mcp)
- [ ! SeedProd Read only ](https://www.respira.press/seedprod-mcp)
- [ YOOtheme Pro Full ](https://www.respira.press/yootheme-mcp)
- [ ! Avada Full ](https://www.respira.press/avada-mcp)

[Everything the WordPress MCP does](https://www.respira.press/mcp)[WooCommerce MCP](https://www.respira.press/addons/woocommerce)

## Start with one site. Free for 7 days.

Maker is €9 a month after the trial. No card for the trial, and it runs on the AI plan you already have, so there is no extra AI bill.

[Start free](https://www.respira.press/signup) [Email Mihai](#)
