Get the plugin
WP MCP/Integrations/Blocksy MCP

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

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
get-blocksy-settingsset-blocksy-settingslist-blocksy-extensionsset-blocksy-extensionsinsert-blockimport-pattern

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.

  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

    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.

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

Point your AI agent at Blocksy.