A brief becomes a real page.Astra MCP integration
Astra MCP: adjust your theme with the settings in view.
Connect Claude, Cursor or another MCP client to Astra through free EMCP. Inspect the theme’s current colors, fonts, layout and supported header/footer settings before applying a scoped change. Astra must be active; Spectra block editing has its own integration and does not require this theme.
Free integrationActive Astra
An Astra content-width change
| Step | Check |
|---|---|
| Read Astra’s layout group | Inspect site-content-width, its current value and the field metadata returned by astra-read. |
| Prepare one width change | Show the proposed value before enabling Astra Write. Submit only the supported setting, leaving unrelated Astra options in place. |
| Check the saved width | Read the setting back and inspect a representative page. Astra’s dynamic CSS cache is cleared after the write. |
A practical place to start
Change Astra’s content width with the current settings in view.
- 01
Read Astra’s layout group
Inspect site-content-width, its current value and the field metadata returned by astra-read.
- 02
Prepare one width change
Show the proposed value before enabling Astra Write. Submit only the supported setting, leaving unrelated Astra options in place.
- 03
Check the saved width
Read the setting back and inspect a representative page. Astra’s dynamic CSS cache is cleared after the write.
Built for Astra
Work with Astra’s supported Customizer settings
Astra keeps its Customizer values in the shared astra-settings option. EMCP reads a curated set of those values through astra-read and updates supported keys through astra-write. Each returned field includes its type, label and group, so your assistant can explain the existing setting before proposing an edit.
For a layout request, ask for the layout group or the specific site-content-width key. For a typography task, inspect fields such as body-font-family and font-size-body; the font-size value is structured, so a plain number is not a substitute for the returned shape.
A width change without replacing the whole option
A useful first task is to compare the current content width with a proposed 1200px layout. Have your AI read the setting, show the proposed change, and submit only that key after review. Unsupported keys are reported in skipped. Read the result back rather than assuming every requested field was accepted.
Theme writes apply immediately and clear Astra’s dynamic CSS cache. Inspect an article, a landing page and a small-screen layout after a site-wide adjustment. A successful response establishes the stored value; it does not establish that every page looks right.
Connect Astra to your assistant
Install free EMCP with Astra active. In EMCP Tools → Tools → Themes, inspect the Astra switches, enable the write tool only when needed, and save your changes. Connect Claude Code, Claude Desktop or Cursor, then reconnect after changing tool access. Both Astra tools require theme-management permissions.
Choose Spectra for page content
Changing the theme’s width or colors is different from inserting a block into one page. Use the independent Spectra integration for Gutenberg content. Spectra does not require Astra, and editing its blocks does not require replacing the Astra settings option.
Read the Astra tool reference for the allowlist and operation parameters.
Get connected
Put Astra in your AI’s toolkit.
- 1
Activate the native dependency
Activate the Astra theme. Included in free EMCP.
- 2
Inspect tool access
Use Themes for theme settings. Enable only the required writes.
- 3
Keep block editing separate
Enable spectra independently in Page Builders when you need its Gutenberg tools.
Then connect Claude Code, Claude Desktop, or Cursor to use the Astra tools enabled on your site. Compare Free and Pro access.
A few useful details
Before you connect.
Questions about Astra, supported operations, and the workflow on your site.
Which Astra settings can my AI change?
The curated allowlist includes colors, typography, layout and selected header/footer fields. Read the live setting metadata before writing; unsupported keys are returned as skipped.
Does Astra MCP also edit Spectra blocks?
No. These tools configure the active Astra theme. Spectra has a separate free Gutenberg integration and can be used on another theme.
Does a theme write wait for page publication?
No. Supported theme settings take effect immediately, and Astra’s dynamic CSS cache is cleared. Review the proposed change before applying it to a live site.
Your tools. Your WordPress site.