Themes integration
Astra MCP
Astra keeps its customizer settings in one astra-settings option. WP MCP's theme pair adds an Astra pack while Astra is the active theme family: get-astra-settings reads the writable keys (theme, link, link hover, text and heading colors, and the site content width), and set-astra-settings writes them with each value sanitized per key, colors as hex, rgb or an Astra palette reference. One invalid value refuses the whole batch before anything is written. The option is snapshotted first and Astra's compiled CSS cache is refreshed afterwards, and after a rollback too. Theme writes are opt-in.
In practice
How Astra work goes with an agent.
Astra stores its customizer values as one serialized array in the astra-settings option, and compiles them into a cached stylesheet. That shape decides what an agent can safely do: change a few global values, then make sure the cache is rebuilt so the change shows up. WP MCP covers exactly that slice. The writable keys are the theme, link, link hover, text and heading base colors plus the site content width, and anything outside that list is refused by name. Colors in Astra often hold palette references rather than hex, so those are accepted and written back as they are.
Which colors is the Astra theme using right now, and are any of them palette references?
Runs get-astra-settings, which returns the stored value for each writable key and the allowlist. Values like var(--ast-global-color-0) come back as stored. Nothing is written.
Set the link color to #0e7490 and the link hover color to var(--ast-global-color-1).
Runs set-astra-settings with both keys. Each value is checked per key first, then the astra-settings option is snapshotted, written, and Astra's compiled CSS cache is cleared.
Make the content area 1400 pixels wide.
Runs set-astra-settings with site-content-width. It must be a whole number between 300 and 3000, and anything else is refused before the option is touched.
Set the heading color to a name instead of a hex code, like "navy".
set-astra-settings refuses the whole batch with invalid_setting_value for heading-base-color, because only hex, rgb, rgba or an Astra palette reference are accepted. No snapshot is taken and nothing is written.
What your AI can do
Real Astra operations, every write reversible.
- Read Astra's global colors and content width
- Set colors as hex, rgb/rgba, or an Astra palette reference
- Change the site content width
- Refresh Astra's compiled CSS after writes and rollbacks
- Roll back any settings change exactly
Example prompts
Example Astra prompts.
What are the Astra theme colors right now?
Set the Astra link color to our brand teal and the headings to near-black.
Widen the content area to 1280 pixels.
Under the hood
The Astra calls, under the hood.
theme-read({ operation: "get-astra-settings" }), writable keys + allowlist
theme-write({ operation: "set-astra-settings", args: { settings: { "link-color": "#0e7490" } } }), opt-in; snapshotted
Safety and access
What can be undone on Astra, and what costs what.
Recoverable on Astra
- Every set-astra-settings call snapshots the astra-settings option before writing.
- rollback-operation restores the option byte for byte.
- Astra's compiled CSS cache is cleared after a rollback too, so the old look returns on the next page view.
Astra limits and opt-ins
- Writes are off until the site turns on the wpmcp_enable_theme_write filter.
- Only six keys are writable: five colors and the content width. Fonts, header builder layouts and the rest of the customizer are not touched.
- A site can widen the key list with the wpmcp_theme_framework_pack_allowlist filter, and each new key is mapped to a color or width rule.
Free or Pro: The Astra settings pack is part of the free plugin. get-astra-settings is a plain read. set-astra-settings is a write that stays disabled until the site opts in, and that opt-in is the same switch used for every theme write, so it is not a Pro gate. The Custom Layouts of the Astra Pro add-on are a separate Pro integration with their own operations.
In the free plugin
The Astra integration is in the free plugin.
The core Astra tools ship in the free, GPL plugin with the full snapshot and undo engine, and no trial clock. Pro adds 133 more tools, including Elementor deep editing, the other page builders, the forms adapter pack and, for some integrations, extra operations. The pricing page lists what each tier includes.
Frequently asked
Astra MCP: questions, answered.
Why only a few Astra settings?
The pack is narrow on purpose: colors and content width, the knobs an agent is actually asked for. A site can widen the allowlist with the wpmcp_theme_framework_pack_allowlist filter.
Are theme writes on by default?
No. They stay off until a site enables them with the wpmcp_enable_theme_write filter.
Does this work on an Astra child theme?
Yes. The pack turns on whenever the active theme family is Astra, which includes an Astra child theme. On any other theme family the Astra operations are not offered at all, so an agent never sees them on a Kadence or GeneratePress site.
Does the change show up straight away?
Yes. After the write WP MCP calls Astra's own cache clearing function when it exists, and falls back to Astra's cache class on older releases. The next request regenerates the stylesheet. A page cache or CDN in front of the site may still serve the old HTML until it is purged.
Can I write several settings in one call?
Yes, the settings object takes any number of allowlisted keys. They are validated together, and one bad value rejects the whole call before anything is saved. If it passes, all keys are written in one snapshotted step, so one rollback reverts them all.
Related integrations
More integrations for the same agent.
MCP for Kadence Theme
FreeThemes, 2 tools.
MCP for GeneratePress
ProThemes, 2 tools.
MCP for Blocksy
ProThemes, 4 tools.
MCP for Astra Pro Custom Layouts
ProThemes, 2 tools.
MCP for Kadence Pro Elements
ProThemes, 2 tools.
MCP for GP Premium Elements
ProThemes, 2 tools.
Browse the full Integrations hub, or read more on the WordPress MCP plugin.