MCP server

GravityKit Block MCP: Edit WordPress Blocks One at a Time

GravityKit Block MCP pairs a WordPress plugin with an MCP server so an agent can read and edit Gutenberg content as an addressable block tree, not raw HTML.

Run
npx -y @gravitykit/block-mcp connect --site https://example.com
View on GitHub

Stars, license and last push from GitHub. Install count as reported by the open skills directory.

What is Block MCP?

Block MCP is an MCP server plus WordPress plugin from GravityKit. It exposes Gutenberg content as a structured block tree so an agent can change a single block, insert or move blocks and roll back revisions, keeping block markers intact.

Block MCP is a two part tool. A WordPress plugin adds a REST API at gk-block-api/v1, and a TypeScript stdio MCP server exposes that API as tools. The agent signs in as a normal WordPress user with an Application Password.

Its pitch is block level editing. Instead of rewriting a page body, an agent reads the blocks, targets one by index or stable ref, and changes only that block, preserving the block comment markers the editor relies on.

What it adds for an agent

  • Read, update, insert, delete and replace blocks, with atomic batch updates in one revision.
  • Stable block refs that survive other inserts and deletes.
  • A preference tier policy that rejects legacy blocks on insert and suggests replacements.
  • Optimistic concurrency so two agents do not silently overwrite each other.
  • Yoast SEO read and write tools when Yoast is active.

Who it is for

Best for

  • Content teams that edit Gutenberg pages through an agent over several turns.
  • Sites that care about clean block markup and tidy revision history.
  • Developers who want server side limits on which blocks an agent may write.

Not for

  • Block theme templates and widget areas for writes. The README lists these as not yet supported.
  • Builders that do not store Gutenberg blocks in post content.

Use it with UiChemy

Block MCP edits Gutenberg pages that already exist. UiChemy Composer has its own MCP that works on your own WordPress site. To create pages first, see AI to WordPress for agencies or the Figma MCP server. Click Get Started on uichemy.com.