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().

agentshell-mcp 1.3.0 protocol 2025-03-26 All tools 9 families

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.

Discovery

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.

ToolFamilyWhat it does
agentshell_apply_themeRevisions, snapshots & profilesApply a profile: merge its design tokens into the live configuration.
agentshell_begin_transactionTransactions & journalOpen a leased change session; configuration writes are buffered, not applied.
agentshell_claim_existing_draftContentRecord a journal claim on a draft that already existed.
agentshell_commit_transactionTransactions & journalValidate and promote the staged state in one atomic write; records a revision.
agentshell_create_draftContentCreate a draft that is journalled: the one content tool allowed inside a transaction.
agentshell_create_pageContentCreate a page with raw HTML content, in any publishable state.
agentshell_create_postContentCreate a post with raw HTML content, in any publishable state.
agentshell_create_snapshotRevisions, snapshots & profilesCapture the whole configuration as a named, restorable snapshot.
agentshell_diff_revisionsRevisions, snapshots & profilesCompare two revisions at the CSS-token level.
agentshell_diff_snapshotRevisions, snapshots & profilesToken-level diff between a snapshot and the live configuration.
agentshell_disable_widgetWidgetsSet a widget to disabled without destroying its registration.
agentshell_edit_publishedContentStage an edit to published content in a private shadow row; the original is untouched.
agentshell_enable_widgetWidgetsSet a widget back to active so zones render it again.
agentshell_explainObserveThe same model as plain text, for a human reading a transcript.
agentshell_export_themeRevisions, snapshots & profilesExport the whole configuration as a portable theme package.
agentshell_get_audit_logObserveAudit history of configuration changes: actor, operation, tokens, revision.
agentshell_get_capabilitiesObserveWhat this installation can do right now, including the screenshot backend.
agentshell_get_configDesign & configurationThe full configuration: zones, design, layout, widgets and CSS variables.
agentshell_get_contentContentFetch one post or page with its raw HTML and the HTML the theme renders.
agentshell_get_design_systemDesign & configurationThe design system in structured groups plus the flat token map.
agentshell_get_journalTransactions & journalRead a transaction's durable content journal without changing anything.
agentshell_get_screenshotVisual verificationFetch a stored capture; retrieval is authorised by capture ownership.
agentshell_get_site_infoObserveBasic site identity: URL, title, language, WordPress version.
agentshell_get_site_settingsSite identity & readingThe site's identity and reading settings: title, tagline, front page, posts per page, comment defaults.
agentshell_get_transactionTransactions & journalThe open transaction: id, label, actor, staged state and lease timers.
agentshell_get_widgetWidgetsOne widget definition by id, including its script, CSS and template.
agentshell_import_themeRevisions, snapshots & profilesImport a theme package and apply it; validated before anything is written.
agentshell_inject_json_blockDesign & configurationAppend a block of raw HTML to a zone without rewriting the rest of it.
agentshell_inspectObserveComplete machine-readable model of the site: shell, design, zones, widgets, content, capabilities.
agentshell_list_revisionsRevisions, snapshots & profilesConfiguration revisions, newest first, with parent, actor and label.
agentshell_list_snapshotsRevisions, snapshots & profilesEvery saved snapshot with name, label, actor and timestamp.
agentshell_list_theme_profilesRevisions, snapshots & profilesEvery saved profile with a short design summary.
agentshell_list_widgetsWidgetsEvery registered widget, file-based or agent-defined, with its lifecycle status.
agentshell_list_zonesDesign & configurationEvery declared zone with its current source type and configuration.
agentshell_preview_themeRevisions, snapshots & profilesA preview URL that renders a profile's tokens without touching the site.
agentshell_preview_transactionTransactions & journalToken-level diff of everything staged against the live configuration.
agentshell_publishContentMove a post or page from draft, pending, private or future to publish.
agentshell_publish_editContentCommit a staged published-content edit, then reconcile the shadow and the claim.
agentshell_publish_edit_reconcileContentIdempotent retry of the reconciliation tail after an interrupted publish.
agentshell_recover_transactionTransactions & journalSettle an expired transaction that holds content work; compensating deletes are verified first.
agentshell_register_navigationNavigationCreate or replace a WordPress menu and optionally assign it to a theme location.
agentshell_register_widgetWidgetsRegister or update an agent-defined widget in the bilateral registry.
agentshell_remove_widgetWidgetsPermanently remove a config-registered widget; file widgets cannot be removed.
agentshell_restore_contentContentBring a page or post back out of the Trash.
agentshell_restore_revisionRevisions, snapshots & profilesRestore a previous revision; the restore is itself recorded as a revision.
agentshell_restore_snapshotRevisions, snapshots & profilesRestore the live configuration from a named snapshot.
agentshell_rollback_transactionTransactions & journalDiscard the staged state. Configuration was never touched, so nothing to undo.
agentshell_save_theme_profileRevisions, snapshots & profilesSave the current design as a named, appliable theme profile.
agentshell_screenshotVisual verificationRender the site in headless Chrome and return the image inline.
agentshell_search_contentContentSearch posts and pages by title or body; an empty query lists recent items.
agentshell_set_css_varDesign & configurationSet one CSS custom property by name.
agentshell_set_custom_cssDesign & configurationReplace the custom stylesheet; it is served as one static, cacheable file.
agentshell_set_designDesign & configurationUpdate colours and typography in one call; only the fields you pass change.
agentshell_set_layoutDesign & configurationGrid areas per breakpoint, grid gap and grid padding.
agentshell_set_paletteDesign & configurationSemantic colour keys: background, surface, text, border, accent, primary, secondary.
agentshell_set_shapeDesign & configurationCorner radius, border width and border style.
agentshell_set_site_settingsSite identity & readingChange the site's identity and reading settings; only the named settings change.
agentshell_set_spacingDesign & configurationThe base spacing unit that drives the whole space scale.
agentshell_set_typographyDesign & configurationFont stack, monospace stack, base size and type scale.
agentshell_trash_contentContentMove a page or post to the Trash; reversible, and never a permanent delete.
agentshell_unpublishContentMove a published post or page back to draft.
agentshell_unregister_widgetWidgetsRemove an agent-defined widget from the registry.
agentshell_update_contentContentUpdate title, content, status, slug or parent of an existing post or page.
agentshell_update_draftContentEdit a draft the current transaction owns; refuses anything it did not create.
agentshell_update_post_contentContentUpdate one post's or page's HTML content.
agentshell_update_zone_compositionDesign & configurationReplace the ordered block list of a vertical zone such as main.
agentshell_update_zone_slotsDesign & configurationReplace the left/center/right slot contents of a tri-slot zone.
agentshell_validateObserveDeterministic doctor over the live configuration: malformed config, unknown zones, bad blocks.
agentshell_validate_transactionTransactions & journalRun 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.

Granularity

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.

Refusals

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.

Evidence

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.