Builder integration · Gutenberg

Run an MCP server for Gutenberg.

Block-aware editing for the WordPress Block Editor. Read, write, and snapshot every core block without flattening structure.

Respira gives AI coding agents a structure-aware way to read and write Gutenberg content through a duplicate-first workflow. Page and element writes are snapshotted, and changes can be reviewed before going live.

Live status

What ships today for Gutenberg

Everything below is read from this repo at build time: tool registrations come from the MCP server adapter files; changelog entries are filtered from the same source the /releases timeline uses.

Tools

uses core tools

Latest touch

7.2.3

Jun 6, 2026

Releases

10

touching Gutenberg

Support

Full support

level

Last 5 releases mentioning Gutenberg

View all 10 releases that touched Gutenberg →

What works

Capabilities shipped today

Concrete features in the current MCP server release. Tool names link directly to the adapter.

  • Block tree reads with respira_read_page return the actual block structure, not just rendered HTML.
  • Per-element writes via respira_find_element + respira_update_element preserve block attributes and innerBlocks.
  • Full-page replacement via respira_update_page works for raw HTML imports (Word doc → blocks), with snapshot rollback on every write.
  • Pattern, reusable block, and template-part awareness through standard WP REST endpoints.
  • Custom blocks register via the same path as core blocks. If the block exposes a REST shape, Respira can edit it.

Known limits

Where you still need a human pass

Honest list of edges. If you hit one of these, the snapshot workflow gives you a clean rollback path.

  • Block validation errors in the editor still need a human round-trip. Respira writes the markup; if the block schema rejects it on next edit, the user sees a validation prompt.
  • Some block-locking patterns (locked templates, restricted block transforms) are honored at write time but not surfaced as a tool-level error yet.
  • Synced patterns inserted as references update on the next page render — no live preview from the MCP side.

Tools

Gutenberg uses the universal toolset

Gutenberg edits run through Respira's universal tools: respira_find_element, respira_update_element, respira_update_page (for full-page replacement only), respira_get_snapshot, and respira_create_page_duplicate. See the complete tool catalog.

Example prompts

Three prompts you can paste right now

Each one assumes Respira is connected to your WordPress site through the MCP server below. Copy a prompt, paste into your MCP client, run.

Update a hero headline across 20 posts

For every post in the "campaign-q3" category, find the first heading block and replace its content with "Ship faster, ship calmer." Snapshot each one before the change.

Convert a Word doc into native blocks

Read the HTML at https://drive.example.com/post.html and convert it to native Gutenberg blocks (paragraph, heading, list, image). Create a new draft post titled "Q3 product update".

Audit image alt text across the site

List every image block on every published post or page where the alt attribute is empty. Group by post title.

Setup

Connect Respira's MCP server

Drop this into your MCP client config (Claude Desktop, Cursor, Codex, Windsurf — any MCP-compatible client). Generate an API key from your Respira dashboard first.

Gutenberg MCP server config

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

Other builder MCPs

Connect a Gutenberg site to Respira in two minutes.

Free trial, no card. Edit your site from your favorite AI coding assistant through a snapshot-protected MCP server.