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 independent toggle in Page Builders. Theme configuration stays in Themes. The block plugin does not require the matching theme.