Get the plugin
WP MCP/Integrations/Oxygen MCP

Oxygen MCP · Pro

Oxygen MCP: AI editing for Oxygen Builder, 6 and classic.

An Oxygen MCP server gives an AI agent access to the element tree behind an Oxygen page. WP MCP handles both generations, Oxygen 6 and classic Oxygen 4.x, and never forges the signature classic Oxygen puts on its shortcodes.

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

What it is

What a Oxygen MCP server does.

Oxygen is really two builders with one name. Oxygen 6 runs on the Breakdance engine and keeps a JSON tree in post meta. Classic Oxygen, 4.x and earlier, stores each page twice: a JSON tree and a signed copy in ct_ shortcodes. An MCP server for Oxygen has to tell them apart and keep both stores consistent.

WP MCP reports which format a page uses, reads the tree in either one, and writes one element operation or a whole tree. For classic pages it does what Oxygen's own save does: adds an Oxygen revision, asks Oxygen to generate and sign the shortcode copy, then refreshes the CSS.

Oxygen has two lives on the same web: Oxygen 6 with a node tree, and classic Oxygen 4.x where each page carries a JSON tree plus a shortcode copy signed with the site's key. An agent that treats them alike would either fail or, worse, forge a signature. WP MCP detects which generation a page uses, writes classic pages by keeping the tree and the signed copy consistent through Oxygen itself, and reads pre-4.0 pages without ever writing to them.

Read and change

What WP MCP can read and change in Oxygen.

It can read

  • Which pages are built with Oxygen, and whether each is Oxygen 6 or classic
  • A page's element tree in either format
  • Pre-4.0 pages, read-only, until they are saved in Oxygen 4

It can change

  • Update, add, remove or move one element, or replace the whole tree
  • Classic: keep the JSON tree and the signed shortcode copy consistent, with an Oxygen revision
  • Refresh Oxygen's generated CSS after writes and rollbacks
detect-builderget-builder-contentupdate-builder-contentrollback-operationrollback-session

These are the real ability and operation names the agent calls. TheOxygen (6 and classic 4.x) AI agent tool reference page lists the calls in detail.

Example prompts

Three things to ask first.

Which pages are on Oxygen 6 and which are still classic Oxygen?

Update the heading in the hero section of the homepage to 'Design without limits'.

On /pricing, move the FAQ section below the plans and refresh the CSS.

Which pages are on Oxygen 6 and which are classic?

detect-builder reports the generation per page, and pre-4.0 pages are listed as read-only until they are saved in Oxygen 4.

Update the hero heading on the homepage to "Design without limits".

On Oxygen 6 the node is edited with the content hash from the read, leaving bytes outside the node identical. Oxygen refreshes its CSS afterwards.

Move the FAQ below the plans on /pricing and refresh the CSS.

A move operation on the tree, snapshotted first, then the generated CSS refreshed through the plugin.

Safety

Every Oxygen write has a way back.

Every Oxygen row is post meta, so the post snapshot captures the tree, the classic shortcode copy and the revisions together, and a rollback restores them together. Oxygen 6 writes stay byte for byte identical outside the edited nodes.

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

An Oxygen 6 page that already holds a layout needs the hash the read returned, so a page changed in the editor 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 Oxygen 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

    Oxygen pages on the site. Oxygen has to be loaded for writes: classic Oxygen signs its shortcode copy with the site's key, and Oxygen 6 refreshes its CSS through the plugin.

  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 Oxygen. 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

Oxygen MCP: questions, answered.

What is Oxygen MCP?

It is Oxygen Builder editing for AI agents over the Model Context Protocol. WP MCP exposes Oxygen pages as an element tree that Claude, Cursor or any MCP client can read and change, with a snapshot before each write.

Does Oxygen MCP support Oxygen 6?

Yes. Oxygen 6 keeps its tree in _oxygen_data, and WP MCP reads and writes it node by node. Classic Oxygen 4.x is supported as well, with its signed shortcode copy regenerated by Oxygen itself.

Why does Oxygen have to be active for writes?

Classic Oxygen signs its shortcodes with a key from your site, and only Oxygen's own serializer can produce a valid signature. WP MCP asks Oxygen to produce it rather than forging one.

What about very old Oxygen pages?

Pages from before Oxygen 4.0 hold only signed shortcodes with no JSON tree, so they are read-only. Open and save the page in Oxygen 4 and it becomes editable.

Is an Oxygen edit reversible?

Yes. rollback-operation restores the tree, the shortcode copy and the revisions as they were before the write, and the CSS is refreshed afterwards.

Why does Oxygen need to be loaded for writes?

Classic Oxygen signs its shortcode copy with the site's key, and Oxygen 6 refreshes its CSS through the plugin. WP MCP uses Oxygen for both instead of forging them.

Can the agent edit pages from before Oxygen 4.0?

It can read them. Writes wait until the page has been saved once in Oxygen 4, because the older storage cannot be written safely.

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

Point your AI agent at Oxygen.