Publish Workflows Abilities

WordPress Abilities API tools so MCP agents can find files inside editorial workspaces.

Use these before a generic media or post search when someone asks where a project file lives.

Ability index

Category: publish-workflows
Meta: show_in_rest: true, MCP public tools, readonly / idempotent
Access: same as Workspaces REST — the current user must own the workspace or be a watcher (administrators can access all).
Source: includes/class-ability.php, includes/class-ability-categories.php, includes/workspaces/class-workspace-search.php

prc-publish-workflows/search-workspaces

Call this first. Example user ask: “where is the Christian icon file for the religious projections project”.

Each match includes:

• workspace.url — admin screen (index.php?page=prc-publish-workflows-workspaces&workspace={id})
• items[] — collected items whose labels, filenames, or URLs matched; items[].url is the best openable link (file URL, permalink, or stored link)
• matchedOn — title, description, and/or items

Always show both the item URL and the workspace URL. If a workspace matches and items is empty, call get-workspace with that id to list every collected item.

If the plugin is inactive on the target site, the ability returns plugin_inactive_on_site.

prc-publish-workflows/get-workspace

Returns { id, title, description, url, items } for one accessible workspace. url is the workspace admin screen. Each item includes url, viewUrl, and editUrl.

Related

• REST API
• User guide
• Architecture