Blocksy MCP · Pro
Blocksy MCP: theme settings, extensions and blocks from one agent.
A Blocksy MCP server lets an AI agent restyle a Blocksy site and manage what Blocksy Companion loads, from a prompt. WP MCP Pro writes Blocksy's own theme mods, switches extensions through the companion's own manager, and rebuilds Blocksy's dynamic CSS after each change.
Self-hosted · snapshot before every write · one-click undo
› Set Blocksy palette color 1 to our brand blue and use it for links
theme-read get-blocksy-settings, palette read
⛨ Blocksy theme mods
theme-write set-blocksy-settings, color1 and linkColor
✓ Palette and links updated. Dynamic CSS rebuilt; rollback-operation restores both.
What it is
What a Blocksy MCP server does.
Blocksy keeps its look in theme mods that it reads whole: an eight-slot color palette, text, link and heading colors with hover states, and a base typography array. Header and footer content sits in builder placements. A Blocksy MCP server has to write into those structures the way the customizer does, or the theme falls back to defaults.
WP MCP Pro follows those rules. A font change seeds the typography array from the theme's default base font before writing, header and footer edits go to the default builder section and refuse if the placements were never saved, and every write ends with Blocksy's cache wiped and its dynamic CSS refreshed so the site shows the new values at once.
Read and change
What WP MCP can read and change in Blocksy.
It can read
- The eight palette colors and the text, link, link hover and heading colors
- The base font family and size, site width and narrow container width
- Header logo height and footer copyright text
- Blocksy Companion extensions, with whether each is Pro, available and on
- Companion block schemas and the patterns Blocksy registers
It can change
- Set palette slots and text, link and heading colors, including palette references (opt-in)
- Change base font, font size and container widths (opt-in)
- Set the header logo height and footer copyright text (opt-in)
- Switch Companion extensions on or off in one batch (opt-in)
- Insert and update blocksy blocks, schema-checked, and import patterns
These are the real ability and operation names the agent calls. TheBlocksy AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
Set the Blocksy base font to Inter at 17px and the site width to 1400.
Which Blocksy Companion extensions are on, and which could this site switch on?
Change the footer copyright line to this year's company name.
Safety
Every Blocksy write has a way back.
set-blocksy-settings snapshots the theme mods before writing and set-blocksy-extensions snapshots the blocksy_active_extensions option. rollback-operation restores either exactly and refreshes Blocksy's dynamic CSS, as the forward write does. Companion block writes snapshot the whole post.
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.
Whole batch or nothing
One invalid value, an unknown extension id, or a Pro extension the site has no plan for refuses the whole call before anything is written.
Free or Pro
Part of WP MCP Pro.
All Blocksy support is part of WP MCP Pro: the theme settings pack, the Blocksy Companion extension toggles and the companion block tools. Pro also keeps unlimited snapshot history with an active licence, where the free plugin keeps the last 20. The free plugin's general Gutenberg tools still edit any block by raw markup.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect Blocksy MCP in four steps.
- 01Install 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.
- 02Check the requirement
Blocksy as the active theme, Blocksy Companion for extensions and blocks, and WP MCP Pro. Theme and extension writes stay off until the site turns on the wpmcp_enable_theme_write filter.
- 03Connect 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.
- 04Ask for the change
Describe what you want done in Blocksy. 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
Blocksy MCP: questions, answered.
What is Blocksy MCP?
It is the Blocksy theme and Blocksy Companion made editable by AI agents over the Model Context Protocol. WP MCP Pro lets Claude, Cursor or any MCP client change Blocksy's design settings, toggle Companion extensions and work with its blocks.
Is Blocksy MCP free?
No. The Blocksy settings pack, extension toggles and companion block tools are part of WP MCP Pro.
Can a link color point at a palette slot?
Yes. Text, link, link hover and heading colors accept var(--theme-palette-color-N) as well as hex, rgb or rgba. The eight palette slots themselves take color values, not references.
Why does a footer edit get refused on a fresh site?
Blocksy's default header and footer structure lives inside the theme until the builder is saved once in the customizer. Save it once and the edit works; until then there is nothing safe to change.
Can it switch on a Blocksy Pro extension?
When the site has it. list-blocksy-extensions marks each extension as available or not, and asking for one that is not available refuses the batch with extension_unavailable.
Does Blocksy 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 Blocksy tools are available in every client the same way.
Keep exploring
MCP for Blocksy →
Blocksy theme settings, Blocksy Companion extensions and companion blocks from a prompt, every write snapshotted and reversible.
Kadence MCP →
A Kadence MCP server lets an AI agent work across the whole Kadence stack: the theme's global settings, the Kadence Blocks library, and Kadence Pro's hooked Elements.
GenerateBlocks MCP →
A GenerateBlocks MCP server lets an AI agent build with GenerateBlocks and tune the GeneratePress theme around it.
Spectra MCP →
A Spectra MCP server lets an AI agent add and edit Spectra blocks, the uagb block library from the makers of Astra.
JetEngine MCP →
A JetEngine MCP server lets an AI agent read the custom fields JetEngine defines and fill them in across your listings.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.