Abilities for AI agents

Four abilities let an AI agent read what Purplish can do, set a block's design and add a pattern.

For Purplish 1.3.3. Works on block and classic themes.

Docs menu

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

AbilityWhat it does
purplish/get-design-catalogLists Purplish's blocks, the options it adds to each block with the values they take, and its patterns.
purplish/get-page-designsLists every block on a page, post, template or template part that can take Purplish options, with its path and saved options.
purplish/set-block-designGives one block Purplish options, or clears them. Every value is checked against the catalog.
purplish/insert-patternAdds a Purplish pattern at the start or end of a page, or right after a block.

Where agents reach them:

ChoiceWhat 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 AdapterWith 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.

Still stuck? Ask in the support forum.