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.”