Astra
New in v3.4.0. Astra stores its customizer settings in a single astra-settings option. EMCP Tools exposes a curated allowlist of that option over two dispatcher tools, so an agent can read and adjust your site’s theme design without you hand-editing the Customizer. Registers only when Astra is the active theme.
How it works
Section titled “How it works”Both tools take { operation, arguments }. Omit operation to get back the list of available operations for that tool, useful for an agent discovering what it can do before calling anything.
emcp-tools/astra-read
Section titled “emcp-tools/astra-read”Operation: get-settings. Reads curated Astra settings with their value plus type/label/group metadata.
Arguments: group (optional: colors, typography, layout, or header-footer) or keys (optional array of specific setting keys). Omit both to return everything on the allowlist.
emcp-tools/astra-write
Section titled “emcp-tools/astra-write”Operation: update-settings. Writes settings by key. Any key not on the allowlist is reported back in skipped, not rejected outright.
Arguments: values, an object of { key: value } pairs.
The allowlist
Section titled “The allowlist”| Key | Group | Type |
|---|---|---|
theme-color | colors | color |
text-color | colors | color |
link-color | colors | color |
link-h-color | colors | color |
body-font-family | typography | string |
font-size-body | typography | array |
font-family-h1…font-family-h6 | typography | string |
site-content-width | layout | number (px) |
site-layout | layout | select |
header-layouts | header-footer | select |
footer-adv | header-footer | select |
footer-sml-layout | header-footer | select |
Call get-settings first, read the returned type/label for a key, then send the same shape back to update-settings.
Permissions
Section titled “Permissions”Both tools are gated on edit_theme_options. Writing takes effect immediately: Astra’s dynamic CSS cache is cleared automatically so the change shows up without a manual “regenerate CSS.”
Independent block integration
Section titled “Independent block integration”In 3.17.0, Spectra has its own tools and an independent switch on EMCP Tools → Page Builders. Theme configuration stays in Themes. The block plugin does not require the matching theme.
In the admin
Section titled “In the admin”Both tools sit under EMCP Tools → Tools → Themes, in the Astra section. Astra Read is on by default and Astra Write ships off. While Astra is not the active theme, both cards carry a Needs Astra badge and cannot be switched on. After changing a switch, choose Save changes in the save bar and reconnect your AI client.