Documentation menu

What agents can change

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.

Categories, tags, and comments#

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.

Media#

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.

Templates, navigation, and widgets#

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.