Spectra MCP · Pro
Spectra MCP: Spectra blocks that render styled, written by AI.
A Spectra MCP server lets an AI agent add and edit Spectra blocks, the uagb block library from the makers of Astra. WP MCP writes them with the same selector settings Spectra's editor gives a new block, so they show up styled on the front end.
Self-hosted · snapshot before every write · one-click undo
› Add a Spectra info box section under the hero on the homepage
block-suites-read list-suites, get-block-schemas
⛨ post saved
block-suites-write insert-block, spectra, assets cache cleared
✓ Section added. It renders with its styles.
What it is
What a Spectra MCP server does.
Spectra builds each post's CSS and JS from its block attributes once, and caches the result in post meta. Most of its blocks are registered only in the editor, which means a server-side tool cannot simply ask WordPress what a Spectra block looks like. An MCP server for Spectra has to bridge both gaps.
WP MCP reads Spectra's block schemas from the attribute defaults each block declares, gives new blocks the unique id and selectors the editor would, and drops Spectra's cached page assets after every write and rollback so the page regenerates them.
Spectra is the block library most often installed alongside Astra, and it has a quirk that trips up anything not made for it: most of its blocks are registered only in the editor, so a server cannot ask WordPress what a block looks like, and its CSS is generated once and cached in post meta. A block pasted in as raw markup tends to render unstyled. WP MCP reads the attribute defaults each block declares, applies the editor's selector settings, and drops the cached assets after each write.
Read and change
What WP MCP can read and change in Spectra.
It can read
- Which block suites are active on the site
- Spectra block schemas, including editor-only blocks
- Registered patterns that use Spectra blocks
It can change
- Insert and update Spectra blocks with the editor's selector settings
- Clear Spectra's cached page assets after writes and rollbacks
- Import a pattern in one undoable write
These are the real ability and operation names the agent calls. TheSpectra AI agent tool reference page lists the calls in detail.
Example prompts
Three things to ask first.
List the Spectra blocks used on the homepage.
Change the label on the Spectra call-to-action button to 'Get the guide'.
Import a testimonials pattern that uses Spectra onto the About page, under the team section.
List the Spectra blocks used on the homepage.
block-suites-read lists the active suites and the blocks in use; nothing is written.
Change the label on the Spectra call-to-action button to "Get the guide".
update-block changes the attribute under a post snapshot, with the expected_hash from the read, and clears Spectra's cached page assets.
Import a testimonials pattern that uses Spectra onto the About page.
The pattern is imported in one undoable write; if you roll it back, the cached assets are cleared again so the styles match.
Safety
Every Spectra write has a way back.
Spectra writes go through the surgical block engine with a post snapshot per call. Because Spectra's generated CSS is a cache in post meta, WP MCP drops it after the write and after a rollback, so the page always regenerates styles from the content that is actually stored.
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.
Freshness checked
A block write carries an expected_hash from the read, so a post edited in the block editor since then is refused instead of overwritten.
Free or Pro
Part of WP MCP Pro.
The dedicated Spectra support is part of WP MCP Pro. On the free plugin, the general Gutenberg block tools can still edit uagb blocks by raw markup, without the selector handling and cache clearing that make them render styled.
WP MCP Pro starts at $49 a year for one site. See pricing for what each tier includes.
How to connect
Connect Spectra 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
Spectra active.
- 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 Spectra. 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
Spectra MCP: questions, answered.
What is Spectra MCP?
It is Spectra block editing for AI agents over the Model Context Protocol. WP MCP lets Claude, Cursor or any MCP client insert and update uagb blocks and import patterns, with a snapshot before every write.
Why do Spectra blocks inserted by other tools render unstyled?
Spectra caches each post's generated CSS and gives new blocks selector settings in its editor. WP MCP applies the same settings and clears the cache after each write, so the page regenerates its styles.
Does it work with Astra?
Spectra support works with any theme. WP MCP also ships separate Astra integrations for the theme's own settings.
Is Spectra MCP free?
The dedicated Spectra support is Pro. The free Gutenberg tools can edit uagb blocks by raw markup.
Can I undo a Spectra edit?
Yes. rollback-operation restores the post exactly, and the cached assets are cleared again so the styles match.
Why not just edit Spectra blocks as raw markup?
The free Gutenberg tools can, but without the selector settings and cache clearing the blocks may render unstyled. The dedicated Spectra support is what makes them render with their styles.
What stops the agent overwriting my own edits?
A block write carries an expected_hash from the read. If the post was edited in the block editor since then, the write is refused instead of applied.
Does Spectra 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 Spectra tools are available in every client the same way.
Keep exploring
MCP for Spectra →
Dedicated Spectra support: styled block writes, plugin settings, page CSS you can inspect and rebuild, and pattern import, all 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.
Divi MCP →
A Divi MCP server lets an AI agent open a Divi page the way the builder stores it and change it for you.
Bricks MCP →
A Bricks MCP server lets an AI agent read and write the element data behind a Bricks Builder page.
Browse all integrations, comparefree and Pro, read the docs, or see how the WordPress MCP server works.