Get the plugin
WP MCP/Integrations/BeTheme MCP

BeTheme MCP · Pro

BeTheme MCP: AI editing for BeTheme and BeBuilder.

A BeTheme MCP server gives an AI agent the BeBuilder layout behind a BeTheme page. WP MCP reads it as sections with an outline, edits single elements by their uid, and stores the result the way BeTheme's own save does.

Self-hosted · snapshot before every write · one-click undo

What it is

What a BeTheme MCP server does.

BeTheme keeps a page's BeBuilder layout in post meta, in whichever format its builder-storage option asks for: a base64-encoded serialized array, or the array itself. Around that sit a preview copy for the visual builder, an SEO copy, local styles and a generated CSS file. An MCP server for BeTheme has to keep all of them consistent.

WP MCP reads the layout as its sections with an outline by uid, so an agent can find the right wrap or item without loading everything. A write follows BeTheme's own save: the preview copy is kept in step, the stale page-object cache is dropped, and the SEO copy, local styles and CSS file are rebuilt through the theme.

BeTheme's BeBuilder lays a page out as sections, wraps and items, and each item carries a uid. That is the addressing WP MCP uses: you ask for a change to one item, the agent edits that uid, and BeTheme's own save logic rebuilds the local styles and the CSS file. The CSS file is not a database row, so a plain restore would leave it stale; WP MCP rebuilds it again after a rollback, keeping the page matched to what is stored.

Read and change

What WP MCP can read and change in BeTheme.

It can read

  • Which pages are built with BeTheme's BeBuilder
  • A page's sections with an outline by uid, plus a content hash

It can change

  • Update, add, remove or move one element by uid, or replace the whole layout
  • Add from a saved BeBuilder template
  • Publish the page live
  • Rebuild the SEO copy, local styles and CSS file after a write or a rollback
detect-builderget-builder-contentupdate-builder-contentrollback-operationrollback-session

These are the real ability and operation names the agent calls. TheBeTheme (BeBuilder) AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

Is the homepage built with BeTheme? Outline its sections for me.

Change the heading in the first BeBuilder section on /about to 'Our story since 2009'.

Add our saved 'Team grid' template under the intro section and publish the page.

Is the homepage built with BeTheme? Outline its sections for me.

get-builder-content returns the sections with an outline by uid and a content hash; nothing is written.

Change the heading in the first BeBuilder section on /about to "Our story since 2009".

One item is updated by uid under a snapshot, then styles and the CSS file are rebuilt through the theme.

Add our saved "Team grid" template under the intro and publish the page.

The saved BeBuilder template is added, the page published, and the SEO copy and local styles rebuilt.

Safety

Every BeTheme write has a way back.

The layout, the preview copy and the local styles are all post meta, so the post snapshot restores them exactly. The CSS file is not a database row, so WP MCP rebuilds it through the theme after the write and again after a rollback.

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.

Content-hash guarded

Once a BeTheme page holds a layout, a write needs the hash the read returned, so a page edited in BeBuilder since then is refused rather than overwritten.

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 BeTheme MCP in four steps.

  1. 01
    Install 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.

  2. 02
    Check the requirement

    BeTheme active. Reads work on the stored layout row; writes are stored the way BeTheme's save works, so the theme has to be loaded.

  3. 03
    Connect 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.

  4. 04
    Ask for the change

    Describe what you want done in BeTheme. 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

BeTheme MCP: questions, answered.

What is BeTheme MCP?

It is BeTheme page editing for AI agents over the Model Context Protocol. WP MCP exposes BeBuilder layouts to Claude, Cursor or any MCP client and writes element-level changes back in BeTheme's own storage format.

Is BeTheme MCP the same as BeBuilder MCP or Muffin Builder MCP?

It covers the same thing: the page builder that ships inside BeTheme. WP MCP reads and writes the layout that builder stores for each page.

Does BeTheme have to be active?

For writes, yes. Storing a layout the way BeTheme does includes rebuilding its SEO copy, local styles and CSS file, which needs the theme loaded. Reads work on the stored row.

Can an agent publish a BeTheme page?

Yes. Publish is one of the operations, alongside update, add, remove and move, and adding from a saved template.

Is the change reversible?

Yes. rollback-operation restores the layout, preview copy and styles from the snapshot and rebuilds the CSS file.

Can the agent change BeTheme options?

It can read them. Theme options are read-only here; the supported edits are page layout changes through BeBuilder.

Does BeTheme have to be loaded for writes?

Yes. Reads work on the stored layout row, but writes are stored the way BeTheme's own save works, so the theme has to be loaded.

Does BeTheme 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 BeTheme tools are available in every client the same way.

Point your AI agent at BeTheme.