Reference
Every tool, nine families.
This is the complete inventory served by tools/list on the plugin that is running this site. Filter it by family with the control below — the filtering is a widget, registered through MCP, hydrating from data-* attributes and never calling fetch().
How a call is shaped
Every tool is a JSON-RPC method call. The daemon carries it to the WordPress REST route, the plugin checks the actor's capabilities, and the result comes back as ordinary JSON — including an atomicity block that states exactly what the write did and did not guarantee.
→ {
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"name": "agentshell_create_page",
"arguments": { "title": "Capabilities", "content": "…", "status": "publish" }
},
"id": 1
}
← {
"id": 1,
"result": {
"id": 12,
"title": "Capabilities",
"status": "publish",
"slug": "capabilities",
"edit_url": "https://…/wp-admin/post.php?post=12&action=edit"
}
}
The id in the result is a real WordPress post id. Content written through these tools is ordinary WordPress content: editable in the admin, indexable, and revocable by the same tools that created it.
Do not guess the surface
tools/list— the inventory, straight from the server.agentshell_get_capabilities— what this installation supports, right now.agentshell_inspect— the live model of this site.
Tool names are stable across releases: new tools get added, none are renamed or removed. The count on this page was read from the server, not from documentation.
The inventory
Every tool on this installation.
Family counts: content 14, design 13, history 13, transactions 8, widgets 7, observe 6, visual 2, navigation 1.
| Tool | Family | What it does |
|---|---|---|
agentshell_apply_theme | Revisions, snapshots & profiles | Apply a profile: merge its design tokens into the live configuration. |
agentshell_begin_transaction | Transactions & journal | Open a leased change session; configuration writes are buffered, not applied. |
agentshell_claim_existing_draft | Content | Record a journal claim on a draft that already existed. |
agentshell_commit_transaction | Transactions & journal | Validate and promote the staged state in one atomic write; records a revision. |
agentshell_create_draft | Content | Create a draft that is journalled: the one content tool allowed inside a transaction. |
agentshell_create_page | Content | Create a page with raw HTML content, in any publishable state. |
agentshell_create_post | Content | Create a post with raw HTML content, in any publishable state. |
agentshell_create_snapshot | Revisions, snapshots & profiles | Capture the whole configuration as a named, restorable snapshot. |
agentshell_diff_revisions | Revisions, snapshots & profiles | Compare two revisions at the CSS-token level. |
agentshell_diff_snapshot | Revisions, snapshots & profiles | Token-level diff between a snapshot and the live configuration. |
agentshell_disable_widget | Widgets | Set a widget to disabled without destroying its registration. |
agentshell_edit_published | Content | Stage an edit to published content in a private shadow row; the original is untouched. |
agentshell_enable_widget | Widgets | Set a widget back to active so zones render it again. |
agentshell_explain | Observe | The same model as plain text, for a human reading a transcript. |
agentshell_export_theme | Revisions, snapshots & profiles | Export the whole configuration as a portable theme package. |
agentshell_get_audit_log | Observe | Audit history of configuration changes: actor, operation, tokens, revision. |
agentshell_get_capabilities | Observe | What this installation can do right now, including the screenshot backend. |
agentshell_get_config | Design & configuration | The full configuration: zones, design, layout, widgets and CSS variables. |
agentshell_get_content | Content | Fetch one post or page with its raw HTML and the HTML the theme renders. |
agentshell_get_design_system | Design & configuration | The design system in structured groups plus the flat token map. |
agentshell_get_journal | Transactions & journal | Read a transaction's durable content journal without changing anything. |
agentshell_get_screenshot | Visual verification | Fetch a stored capture; retrieval is authorised by capture ownership. |
agentshell_get_site_info | Observe | Basic site identity: URL, title, language, WordPress version. |
agentshell_get_site_settings | Site identity & reading | The site's identity and reading settings: title, tagline, front page, posts per page, comment defaults. |
agentshell_get_transaction | Transactions & journal | The open transaction: id, label, actor, staged state and lease timers. |
agentshell_get_widget | Widgets | One widget definition by id, including its script, CSS and template. |
agentshell_import_theme | Revisions, snapshots & profiles | Import a theme package and apply it; validated before anything is written. |
agentshell_inject_json_block | Design & configuration | Append a block of raw HTML to a zone without rewriting the rest of it. |
agentshell_inspect | Observe | Complete machine-readable model of the site: shell, design, zones, widgets, content, capabilities. |
agentshell_list_revisions | Revisions, snapshots & profiles | Configuration revisions, newest first, with parent, actor and label. |
agentshell_list_snapshots | Revisions, snapshots & profiles | Every saved snapshot with name, label, actor and timestamp. |
agentshell_list_theme_profiles | Revisions, snapshots & profiles | Every saved profile with a short design summary. |
agentshell_list_widgets | Widgets | Every registered widget, file-based or agent-defined, with its lifecycle status. |
agentshell_list_zones | Design & configuration | Every declared zone with its current source type and configuration. |
agentshell_preview_theme | Revisions, snapshots & profiles | A preview URL that renders a profile's tokens without touching the site. |
agentshell_preview_transaction | Transactions & journal | Token-level diff of everything staged against the live configuration. |
agentshell_publish | Content | Move a post or page from draft, pending, private or future to publish. |
agentshell_publish_edit | Content | Commit a staged published-content edit, then reconcile the shadow and the claim. |
agentshell_publish_edit_reconcile | Content | Idempotent retry of the reconciliation tail after an interrupted publish. |
agentshell_recover_transaction | Transactions & journal | Settle an expired transaction that holds content work; compensating deletes are verified first. |
agentshell_register_navigation | Navigation | Create or replace a WordPress menu and optionally assign it to a theme location. |
agentshell_register_widget | Widgets | Register or update an agent-defined widget in the bilateral registry. |
agentshell_remove_widget | Widgets | Permanently remove a config-registered widget; file widgets cannot be removed. |
agentshell_restore_content | Content | Bring a page or post back out of the Trash. |
agentshell_restore_revision | Revisions, snapshots & profiles | Restore a previous revision; the restore is itself recorded as a revision. |
agentshell_restore_snapshot | Revisions, snapshots & profiles | Restore the live configuration from a named snapshot. |
agentshell_rollback_transaction | Transactions & journal | Discard the staged state. Configuration was never touched, so nothing to undo. |
agentshell_save_theme_profile | Revisions, snapshots & profiles | Save the current design as a named, appliable theme profile. |
agentshell_screenshot | Visual verification | Render the site in headless Chrome and return the image inline. |
agentshell_search_content | Content | Search posts and pages by title or body; an empty query lists recent items. |
agentshell_set_css_var | Design & configuration | Set one CSS custom property by name. |
agentshell_set_custom_css | Design & configuration | Replace the custom stylesheet; it is served as one static, cacheable file. |
agentshell_set_design | Design & configuration | Update colours and typography in one call; only the fields you pass change. |
agentshell_set_layout | Design & configuration | Grid areas per breakpoint, grid gap and grid padding. |
agentshell_set_palette | Design & configuration | Semantic colour keys: background, surface, text, border, accent, primary, secondary. |
agentshell_set_shape | Design & configuration | Corner radius, border width and border style. |
agentshell_set_site_settings | Site identity & reading | Change the site's identity and reading settings; only the named settings change. |
agentshell_set_spacing | Design & configuration | The base spacing unit that drives the whole space scale. |
agentshell_set_typography | Design & configuration | Font stack, monospace stack, base size and type scale. |
agentshell_trash_content | Content | Move a page or post to the Trash; reversible, and never a permanent delete. |
agentshell_unpublish | Content | Move a published post or page back to draft. |
agentshell_unregister_widget | Widgets | Remove an agent-defined widget from the registry. |
agentshell_update_content | Content | Update title, content, status, slug or parent of an existing post or page. |
agentshell_update_draft | Content | Edit a draft the current transaction owns; refuses anything it did not create. |
agentshell_update_post_content | Content | Update one post's or page's HTML content. |
agentshell_update_zone_composition | Design & configuration | Replace the ordered block list of a vertical zone such as main. |
agentshell_update_zone_slots | Design & configuration | Replace the left/center/right slot contents of a tri-slot zone. |
agentshell_validate | Observe | Deterministic doctor over the live configuration: malformed config, unknown zones, bad blocks. |
agentshell_validate_transaction | Transactions & journal | Run the site doctor against the staged configuration. |
Rows are server-rendered by WordPress. The filter chips you see below them are added by a widget that walks up to the zone scope, finds the nearest preceding block in that zone and enhances it in place — no fetch(), no duplicated data.
Reading the table
Three things worth noticing.
One token at a time
Design is not a blob. set_palette, set_typography, set_spacing, set_shape and set_css_var each move one thing, so an agent can change the accent colour without touching the type scale — and the transaction preview will show you exactly that one token changed.
Tools that say no
Most content tools refuse to run inside an open transaction and name the journal-aware alternative. That is deliberate: an operation that cannot be journalled must not silently perform an untracked write while a transaction is open.
Everything is recorded
Configuration writes become revisions and audit rows. Content writes carry an atomicity block. Journalled content carries an operation id and a recovery marker. If you want to know what an agent did, you can ask.
Next
How the pieces fit together.
Zones, the bilateral widget registry, the data-* hydration law and the no-fetch boundary are the four rules that make the tool surface coherent.