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.
Connect GravityKit Block MCP: Edit WordPress Blocks One at a Time to your AI client
npx -y @gravitykit/block-mcp connect --site https://example.comInstall the WordPress plugin
Upload the gk-block-mcp ZIP from the releases page under Plugins, Add New, Upload Plugin, or install it with wp plugin install using the release URL and the activate flag.
Connect your assistant
Go to Settings, Block MCP, Connect and pick a client. Claude Desktop gets a one click .mcpb file. For Cursor, Claude Code or ChatGPT Desktop, run the npx connect command and approve in the browser.
Or set up by hand
Create an Application Password, clone the repository, run npm install and register the built server with the WordPress URL, user and password as environment variables.
Tune the settings
Settings, Block MCP controls which blocks agents may write, replacement suggestions and which post types create_post can target.
Client configuration
{
"mcpServers": {
"block-mcp": {
"command": "node",
"args": ["/absolute/path/to/block-mcp/dist/index.cjs"],
"env": {
"WORDPRESS_URL": "https://example.com",
"WORDPRESS_USER": "your-wp-username",
"WORDPRESS_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
}
}
}
}What you can do with it
- Block level editsChange one heading or button without resending the page, keeping the block markers the editor needs to reopen the page cleanly.
- Atomic batchesupdate_blocks validates every item first, so one stale ref aborts the whole batch before anything is saved. One logical change becomes one revision.
- Server side tier policyLegacy blocks are hard rejected on insert with a suggested replacement, while avoid-tier blocks write with warnings.
- Limited service accountConnecting can create a dedicated account that edits content but cannot change site settings or sign in to the dashboard.
- Sanitised writesBlock HTML passes through wp_kses_post, which strips script tags and inline event handlers.
- Rate limitsWrites are capped at 10 per minute per post, and full rewrites at 2 per minute, with an HTTP 429 when exceeded.
Tools it exposes
get_page_blocks
Reads a post's blocks, with outline, search and block type filters.
update_block
Updates one block by flat index or ref.
update_blocks
Applies up to 50 independent updates atomically in one revision.
insert_blocks
Inserts blocks at a position.
delete_block
Removes one or more blocks.
replace_block_range
Swaps N blocks for M blocks in one revision.
edit_block_tree
Runs path or ref based structural operations.
revert_to_revision
Rolls back to a prior revision.
create_post
Creates a post or page from blocks or HTML.
upload_media
Uploads by local path, URL sideload or base64.
list_block_types
Browses block types with preference tiers and nesting rules.
yoast_update_seo
Updates Yoast SEO fields when Yoast is active.
Frequently asked questions
What is GravityKit Block MCP?
It is an MCP server and WordPress plugin from GravityKit that exposes Gutenberg content as a block tree. An agent can edit one block at a time, batch changes in a single revision and roll back, instead of rewriting the whole page.
How do I install Block MCP?
Install the gk-block-mcp plugin from the release ZIP, then go to Settings, Block MCP, Connect. For Cursor, Claude Code or ChatGPT Desktop run npx -y @gravitykit/block-mcp connect with your site URL and approve in the browser.
What does Block MCP require?
Node.js 20 or higher, WordPress 6.0 or higher with Application Passwords enabled, PHP 7.4 or higher and HTTPS. The README states these under its Requirements heading, and the Block Bindings features need WordPress 6.5.
Does Block MCP work with Yoast SEO?
Yes, when Yoast SEO is active on the site. The tools yoast_get_seo, yoast_update_seo and yoast_bulk_update_seo read and write titles, descriptions, focus keywords, canonical URLs, schema types and social card fields.
Can Block MCP edit block theme templates?
Reading templates is supported, and update_template is gated by a site setting that is off by default. The README's limitations section also says block theme templates and widget areas are not yet supported for edits.
Is Block MCP safe for my site?
The README says connecting can create a limited service account, writes are sanitised, and rate limits apply. It still changes real content, so test on staging and use revisions to roll back. Your own account is a higher access option.
What license does Block MCP use?
The README says the WordPress plugin is GPL-2.0-or-later and the MCP server is MIT. GitHub lists the repository license as not detected, so confirm the exact terms in the repository before you reuse any of the code.
What are alternatives to Block MCP?
For REST based content tools see InstaWP mcp-wp. For core site management see WP MCP Ultimate. For Elementor pages see MCP Abilities Elementor, and for builder editing see Respira WordPress MCP.


