Beaver Builder MCP server, with undo on every edit.

A Beaver Builder MCP server lets Claude, ChatGPT or Cursor read and edit Beaver Builder rows, columns and modules on a live WordPress site. With Respira every edit lands on a copy first, and you can undo it for 90 days.

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

Support
Full
Beaver Builder tools
Core set
Latest release touching it
mcp-8.7.2
Releases touching it
69

Respira is an independent MCP server. Not affiliated with, endorsed by, or sponsored by Beaver Builder LLC.

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

  • Row, column, and module CRUD via the standard respira_find_element + respira_update_element flow.
  • All 41 modules Beaver Builder 2.10 registers are known by the fields Beaver itself declares, so the agent is never told a module or setting name Beaver does not have.
  • The add_* tools (heading, text, button, image, video, lists, counters, progress bars, tabs, accordions, sliders, pricing tables, menus and more) render on the page: checked one by one against Beaver Builder 2.10.2.
  • Top-level font fields ({ family, weight }) are normalized to PHP arrays, not stdClass, keeps the Visual Editor from re-serializing on save (the v7.0.25 rule).
  • Where a Beaver Themer layout applies, read and set without wp-admin (plugin 9.3.1+): entire site, the blog, post types, archives, terms, individual pages and their descendants, search, 404 and excludes, with conflicts decided by Themer itself and one-call undo (wordpress_get_template_conditions, wordpress_set_template_conditions). Proven by real page requests on Themer 1.5.3 with Beaver Builder 2.11.1.
  • Saved rows and saved templates: list + insert with automatic ID remapping.
  • Beaver Builder Lite and the full plugin both detected.

Where a human still steps in

  • Custom third-party Beaver modules without a content-field map fall back to raw-field writes. They work, but lose smart formatting. Custom map entries can be requested.
  • Beaver Builder Assistant Pro features (cloud library, brand kits) are out of scope for the MCP. Edit assets through Beaver's own UI.
  • Template conditions change the live site at once, so a person has to agree first. Themer has no front page location: use the page id, or the blog for a latest-posts front page. All Singular, All Archives, Parent and term parent rules stay untouched but cannot be created through Respira. User and logic rules are kept and reported, not edited, and conflicts are checked on sample pages for a logged-out visitor.

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

Beaver Builder 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

Three prompts you can paste right now.

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

  1. Rebrand button colors site-wide

    Find every Beaver Builder button module across all published pages. Change the background color from #006eff to #0a5cd5. Snapshot each page first.
  2. Fix heading hierarchy

    For every page built with Beaver, list any case where an H3 appears before any H2 on the same page. Group by URL.
  3. Apply a saved row across landing pages

    For every page in the "/lp-" prefix, insert the saved row "footer-cta" at the bottom of the layout. Skip pages that already contain it.

More recipes, per builder, in the Prompt Book.

Connect a Beaver Builder site in two minutes.

Pick your client and paste. The site URL and key come from your setup page, or from Respira › Setup in wp-admin. 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 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.

  • Top-level font fields must stay PHP arrays, not stdClass. Respira normalizes this automatically since v7.0.25. If you write to Beaver via custom code outside Respira, mirror the same convention or the Visual Editor will lose font settings on save.

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 Beaver Builder 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, or write to word@respira.press with the first error line.

What changed for Beaver Builder lately.

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

  1. mcp-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.
  2. 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.
    • An image built on a Beaver Builder page shows the image. A generic image sent to build_page or inject_builder_content on Beaver became a Photo module without saying where its picture comes from, so Beaver showed its 1x1 placeholder with no alt text, an image sent as url became the photo's link, and the response still said the image renders.
  3. 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.
  4. 9.2.4 Oct 14, 2026
    • WPBakery pages with many addon elements can be read and edited again. On a WPBakery site running The7 with Ultimate VC Addons, Revolution Slider, Go Pricing and WooCommerce, every builder tool failed: finding an element, reading the page's structure, duplicating it, and every edit, even a one word change on a small draft.
  5. 9.2.0 Oct 13, 2026
    • Every builder says what it can write. get_builder_info now carries write_capabilities for every builder: whether it builds pages, adds elements or only edits text, and whether a new element is native, written as core blocks, or partial.

All 69 releases that touched Beaver Builder

Questions people ask about Beaver Builder and MCP.

Is there an MCP server for Beaver Builder?

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

Which tools does it use for Beaver Builder?

Beaver Builder 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 Beaver Builder 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.

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.