Governed ability

Update navigation

aafm/update-navigationGuarded write

Update navigation is a governed ability in Agent Abilities for MCP, a free WordPress plugin that runs an MCP server on your site.

Replaces the links of one block-theme navigation menu by id with the list you send: each item a label and a URL, with optional children up to three levels deep and 100 items in all. The whole navigation is replaced, including any blocks list-navigations names under other_blocks. Each link is saved as a plain custom link, so per-link settings such as open in a new tab, rel, CSS classes and a link's binding to a page or post are not kept. URLs must be http, https, mailto or tel links, a path starting with /, or an anchor starting with #. A navigation owned by a page builder is refused. Navigation edits are not recorded in change history, so this cannot be undone here; When the site keeps revisions, WordPress saves the new version as a revision, so the earlier version can be restored only if it was already kept as a revision; restoring one brings back the links it holds. Requires the edit-theme-options capability. Off by default.

How it is governed

The same model as every ability in the plugin, stated for this one.

  • Off until you enable it

    Like every ability, Update navigation ships switched off. You turn it on one at a time, and an update never switches on a tool it serves.

  • Guarded write

    Writes stay conservative, and the plugin re-checks the capability before the call runs.

  • Capability gated

    A connection only sees Update navigation if the user you connected can run it, and the plugin checks that capability again before it executes.

  • Every call audited

    The call is written to the log in your own database, denials included, with the argument keys and the identifiers it touched, never free-text content.

Update navigation is one of the 11 governed Menus abilities. Browse the other Menus abilities in the catalog.

See it in action

An illustrative run. Your real calls and data stay on your own site.

agent-abilities · auditGoverned
YouUpdate navigation on this site.
RunRunning aafm/update-navigation
GateAllowedcapability re-checked before running
Auditaafm/update-navigation · principal: editor · args: id, items
ResultApplies the change, then writes the call to the audit log.

Try it with a prompt

Example requests you could paste to your agent.

  1. Replace the header navigation with Home, Shop, Blog and Contact.
  2. Add a Guides link under Resources in the footer navigation.
  3. Point the Contact link in the main navigation at /contact-us/.

These are illustrative example prompts. The agent runs them as the user you connected, checked against that user's capabilities and written to your audit log.

Frequently asked

Short answers for Update navigation.

Does it keep the settings on each link?

No. The whole navigation is replaced with the list you send, including any blocks List navigations names under other_blocks, and each link is saved as a plain custom link. Per-link settings such as open in a new tab, rel, CSS classes and a link's binding to a page or post are not kept.

What limits apply?

Up to three levels and 100 items. URLs must be http, https, mailto or tel links, a path starting with /, or an anchor starting with #. A navigation owned by a page builder is refused, and the tool needs the edit-theme-options capability.

Can I undo it?

Not from the Changes tab, which does not record this tool. When the site keeps revisions, WordPress saves the new version as a revision, so an earlier version can be restored only if it was already kept as a revision.

Back to all abilities

Governed by default, from the first call.

Update navigation is off until you enable it, scoped to the user you connect, and logged like everything else. Turn on only what you need.

Every ability off until you enable it, capability-gated on every call.