Where to find it
Purplish registers its abilities with the WordPress Abilities API, so there's nothing to turn on. An agent reaches them through the REST API, or through the MCP Adapter plugin.
The abilities
| Ability | What it does |
|---|---|
| purplish/get-design-catalog | Lists Purplish's blocks, the options it adds to each block with the values they take, and its patterns. |
| purplish/get-page-designs | Lists every block on a page, post, template or template part that can take Purplish options, with its path and saved options. |
| purplish/set-block-design | Gives one block Purplish options, or clears them. Every value is checked against the catalog. |
| purplish/insert-pattern | Adds a Purplish pattern at the start or end of a page, or right after a block. |
Where agents reach them:
| Choice | What it does |
|---|---|
| REST API | /wp-json/wp-abilities/v1/abilities lists them. The two that read run with GET, the two that change a page run with POST. |
| MCP Adapter | With the [MCP Adapter](https://github.com/WordPress/mcp-adapter) plugin, an agent finds them through its discover and execute tools. |
Good to know
- Only Purplish's own options change, and each change saves a revision you can go back to.
- Reading the catalog needs a user who can edit posts. Changing a page needs a user who can edit it, and a template needs one who can edit the theme.
- A page is named by its ID, or a template by its name, like purple//single-product.
- A wrong option or value stops the change and names what the block takes.
- Product details and sale badge text belong to WooCommerce's own abilities.