Agent Warden gives agents abilities to manage the whole site through MCP: content of every type, terms, comments, users, media, the logo, typography and fonts, custom CSS, templates, patterns, menus, widgets, settings, themes, and plugins. Every change runs under the agent's policy and appears in the activity log in plain language. It can be undone, except where this page says otherwise.
An agent can use an ability only when its policy allows it. The Site designer template allows the design abilities and holds the ones visitors notice at once; the Site maintainer template holds plugin and theme changes.
Content#
| Ability |
What it does |
agentwarden/list-post-types |
The content types agents can write: posts, pages, and public custom post types. |
agentwarden/list-posts, agentwarden/get-post |
Lists and reads content. |
agentwarden/create-draft |
Creates a draft. Takes block markup, and a page's slug, parent_id, menu_order, featured_media_id, and template. Never publishes. |
agentwarden/update-post |
Changes those fields on a draft the agent wrote. |
agentwarden/update-any-post |
Changes the same fields on any post or page, including published ones and ones other people wrote. |
agentwarden/publish-post, agentwarden/unpublish-post |
Publishes, or returns to draft. |
agentwarden/schedule-post |
Publishes at a future date and time. |
agentwarden/set-post-visibility |
Public, private, or password protected. |
agentwarden/set-post-options |
Comments and pingbacks open or closed, sticky, and post format. |
agentwarden/update-post-meta |
Custom fields registered for the REST API. |
agentwarden/trash-post, agentwarden/restore-post, agentwarden/delete-post |
Moves to the trash, restores, or deletes permanently from the trash. |
agentwarden/list-revisions, agentwarden/restore-revision |
Lists revisions and restores one. |
| Ability |
What it does |
agentwarden/list-terms, agentwarden/save-term, agentwarden/delete-term |
Lists, creates, renames, nests, and deletes categories, tags, and custom taxonomy terms. The default category cannot be deleted. |
agentwarden/set-post-terms |
Sets the terms on a post. |
agentwarden/list-comments |
Lists pending, approved, spam, or trashed comments. |
agentwarden/moderate-comment |
Approves, holds, marks as spam, or trashes. |
agentwarden/reply-comment |
Replies as the agent. |
agentwarden/delete-comment |
Deletes permanently. |
Users#
| Ability |
What it does |
agentwarden/list-users |
Lists users, the roles agents may give, and whether agents may change each user. |
agentwarden/create-user |
Creates a user with a password nobody sees, optionally emailing them an invitation. |
agentwarden/update-user |
Changes email, names, website, biography, or role. |
agentwarden/delete-user |
Deletes a user and gives their posts to someone else. |
Agents manage ordinary accounts, never the people who run the site:
- No agent can give the Administrator role, or any role that can manage options, users, plugins, themes, or files.
- On a single site, Editors can post unfiltered HTML, so agents cannot give that role by default. A developer can allow it with the
agentwarden_agent_assignable_roles filter.
- Agents cannot change or delete administrators, editors, or other agents, and never set or see passwords.
Site identity and settings#
| Ability |
What it does |
agentwarden/get-site-identity, agentwarden/update-site-identity |
Title, tagline, logo, and site icon. Upload the image with upload-media first. |
agentwarden/set-homepage |
Latest posts or a static page, and which pages are the homepage and posts page. |
agentwarden/get-settings, agentwarden/update-settings |
Timezone, language, date and time formats, week start, default category and format, posts per page, feeds, permalinks, search engine visibility, privacy policy page, discussion and moderation, avatars, and media sizes. |
No ability changes the site address, admin email, user registration, or default role.
| Ability |
What it does |
agentwarden/list-media |
Lists the media library. |
agentwarden/upload-media |
Adds a file from a public URL or from base64 data. The site's allowed file types and size limit apply. |
agentwarden/update-media |
Changes a file's title, alternative text, caption, or description. |
agentwarden/edit-image |
Flips, rotates, or crops an image into a new media item. The original stays as it was. |
agentwarden/delete-media |
Deletes a media item and its files. The site logo and icon cannot be deleted. |
Design#
| Ability |
What it does |
agentwarden/get-design |
Active theme, the colours, fonts, and font sizes the theme offers, the site-wide styles, and custom CSS. |
agentwarden/update-global-styles |
Block themes. Changes site-wide typography, colours, spacing, and element styles in theme.json form. |
agentwarden/get-custom-css, agentwarden/update-custom-css |
Reads, replaces, or appends to the custom CSS. Works with every theme. CSS containing < is refused. |
agentwarden/list-fonts, agentwarden/install-font, agentwarden/delete-font |
The font library. Installs a font family from https font file URLs and makes it available to the site's styles. |
agentwarden/list-block-patterns |
The theme's block patterns, with their markup. |
agentwarden/list-saved-patterns, agentwarden/save-pattern, agentwarden/delete-pattern |
Patterns saved on the site, synced or not. |
| Ability |
What it does |
agentwarden/list-templates, agentwarden/get-template |
Block themes. Templates such as the page layout, and template parts such as the header and footer. |
agentwarden/create-template |
Creates a new template, which pages can use through their template field, or a new template part. |
agentwarden/update-template |
Replaces a template's block markup, the way the Site Editor saves it. |
agentwarden/reset-template |
Removes the site's changes, so the theme's original applies again. |
agentwarden/list-navigation, agentwarden/save-navigation, agentwarden/delete-navigation |
Block theme navigation menus. |
agentwarden/save-menu, agentwarden/delete-menu |
Classic theme menus, nested, with their locations. |
agentwarden/list-widgets, agentwarden/save-widget, agentwarden/remove-widget |
Classic theme sidebars and widgets. |
Themes and plugins#
| Ability |
What it does |
agentwarden/list-themes, agentwarden/activate-theme |
Lists installed themes, and switches the active one. |
agentwarden/install-theme, agentwarden/update-theme, agentwarden/delete-theme |
Installs from WordPress.org, updates, or deletes a theme that is not in use. |
agentwarden/list-plugins, agentwarden/activate-plugin, agentwarden/deactivate-plugin |
Lists installed plugins and turns them on or off. |
agentwarden/install-plugin, agentwarden/update-plugin, agentwarden/delete-plugin |
Installs from WordPress.org, updates, or deletes an inactive plugin. |
agentwarden/get-updates, agentwarden/set-auto-updates |
Available updates, and automatic updates for plugins, themes, and major WordPress versions. |
Some limits:
- Plugins and themes are installed only by their WordPress.org slug, never from an uploaded or remote zip.
- Agent Warden cannot update itself. Agent Warden and the MCP Adapter cannot be deactivated or deleted by an agent.
- When the server needs FTP credentials to write files, these abilities refuse.
Hard blocks and undo#
| Ability |
Hard block |
Undo |
update-site-identity, set-homepage, update-settings |
Settings |
Yes |
publish-post, unpublish-post, schedule-post, set-post-visibility, save-pattern |
Publishing |
Yes. A publish may already have notified subscribers. |
delete-post, delete-term, delete-comment, delete-pattern, delete-navigation, delete-menu, delete-font |
Deleting |
Yes. Deleting a font removes font files that were uploaded rather than linked. |
create-user, update-user |
Users |
Yes. Invitation and email-change emails cannot be recalled. |
delete-user |
Users, and deleting |
Yes, with the reassigned posts. |
activate-theme, deactivate-plugin, set-auto-updates |
Plugins and themes |
Yes. Anything a theme's or plugin's own code did outside the database stays done. |
activate-plugin, install-plugin, update-plugin, install-theme, update-theme |
Plugins and themes, and irreversible |
No. Files change on disk, and a plugin's activation code can do anything. |
delete-plugin, delete-theme |
Plugins and themes, deleting, and irreversible |
No |
delete-media |
Deleting, and irreversible |
No. The files are removed. |
upload-media, edit-image |
None |
Yes. The files stay on disk. |
moderate-comment |
None |
Yes. Approving may already have emailed the post's author. |
| Everything else |
None |
Yes |
Changes that cannot be undone are refused during a dry run. Read Undo and conflicts for how undo handles changes a person made afterwards.
Not available to agents#
- Theme and plugin PHP. Agents cannot edit theme or plugin PHP, or any file.
- Core updates. Agents cannot update WordPress core directly. Turn on automatic updates with
set-auto-updates instead.
- Import, export and data requests. Agents cannot import or export content, or handle privacy data requests.
- Multisite network. Agents cannot manage the network.
- Users with elevated access. Agents cannot manage administrators or application passwords, or give anyone unfiltered HTML.
Each of these could hand an agent the whole site or could not be undone.