Get the plugin
WP MCP/Documentation/Tools Reference, part 3

Maintenance mode (3 tools)

  • disable-maintenance: Turn maintenance mode off: sets enabled=false on the wpmcp_maintenance option (message and retry_after are preserved for a later re-enable). Snapshotted; rollback-operation restores the prior state
  • enable-maintenance: Turn maintenance mode on (wpmcp_maintenance option: enabled, message, retry_after seconds). Logged-out visitors and users without manage_options get a 503 with the message until disabled. Snapshotted; rollback-operation restores the prior state
  • get-maintenance-status: Whether the site is gated: WP MCP maintenance mode (message, Retry-After), core .maintenance, coming soon and maintenance plugins

Site context (3 tools)

  • get-page-snapshot: One-call page digest from stored post_content: structure counts, outline, media and link inventory, builder detection, SEO-lite signals (content_coverage flags builder page gaps). Heavy sections (global_tokens, responsive_overrides) opt-in via sections. Size-capped
  • get-rendered-html: Visitor-view HTML of a site page (post_id or url/path), chunked
  • get-site-context: Orientation payload: site name, URL, tagline, WordPress and PHP versions, theme, active plugins, public post types with counts, taxonomies, user count, locale, timezone, multisite and active integrations. No admin email

REST passthrough (2 tools)

  • call-rest: Run an internal REST request on any local route; returns status and body. The route's permission_callback runs as the current user, so access cannot widen. GET/HEAD always run; writes need the wpmcp_enable_rest_writes filter (default off) and confirm:true, and are not snapshotted (recoverable:false)
  • list-rest-routes: List routes on this site's REST server (core and plugin namespaces): path, methods and a short args summary. Optional namespace and search filter by substring; limit caps rows (default 50, max 200). Read-only: never executes a route

Onboarding & connection info (2 tools)

  • get-connection-info: How to connect an MCP client here: the MCP endpoint URL and ready-to-paste snippets for Claude Code, Cursor and Claude Desktop, each using an Application Password placeholder. Never returns a real credential. Read-only
  • list-tool-catalog: List abilities by domain: tier, operation, capability, read-only/destructive hints, counts. Filters: domain, tier, search (name, description or op name; op hits in matched_operations). Read-only

Tool dispatch (compact mode) (3 tools)

  • call-tool: Invoke any wpmcp tool by name with an arguments object (reaches tools compact mode hides). The target's own checks (capability, governance, identity scope, license, rate limit, input validation, snapshot/rollback) apply as if called directly, never widening access. Refuses non-wpmcp tools and the meta-tools
  • get-tool-schema: Read one wpmcp tool's full contract by name: exact input schema, complete description, MCP annotations and domain/operation/tier. Read-only; list-tools finds names
  • list-tools: List every tool: name, summary, domain, operation, tier. Filters: domain, search (as list-tool-catalog). full:true adds descriptions and MCP annotations; schemas: get-tool-schema. Read-only. Compact mode: finds unlisted tools

Governance & scoped identities (6 tools)

  • create-identity: Create or overwrite (by name) a scoped identity that, once active (wpmcp_current_identity filter), narrows abilities beyond capability and Governance. Optional domains/operations/abilities allowlists, mode (allow default, or deny), exposure (full/compact, overrides site-wide mode), allowed_ips (IPs/CIDRs; other clients refused)
  • delete-identity: Delete a scoped identity by name. Returns an error if no identity with that name exists
  • get-governance-settings: Return the stored governance toggle maps (ability, domain, operation) and site_wide mode: explicit enable/disable decisions layered on top of the wpmcp_{ability,domain,operation}_enabled filters
  • list-governance-audit-log: List governance-decision audit log entries (ability, active identity or "none", allowed/denied, timestamp, source: mcp/rest/server/cli/php), newest first. Optional limit (default 20) and source filter
  • list-identities: List every registered scoped identity
  • update-governance-settings: Batch-update stored governance toggles by ability, domain and operation, e.g. {ability: {"wpmcp/delete-post": false}, domain: {"database": false}}. Undoable; refuses unknown names and disabling the governance or undo tools. site_wide audits ability calls outside MCP; enforce also refuses abilities toggled off by name. auto_enable_new_tools: updates switch their new safe tools on

Project memory (3 tools, 3 Pro)

  • memory-propose, Pro: Propose one durable memory entry, stored PENDING and inert (not injected into sessions; severity=block not enforced) until an admin publishes it in wp-admin. severity=block needs at least one target (tool:, post_id:, post_type:); once published, matching calls are refused (enforced, not advisory)
  • memory-recall, Pro: Read this site's APPROVED project memory: published facts, conventions, guardrails, session summaries and enforced block rules. Pending proposals are never returned (only their count), so unapproved suggestions never read back as policy
  • memory-save-summary, Pro: Record what a session changed as a pending session-summary entry. Facts come from that session's snapshot rows, not the supplied prose or any LLM, so it cannot over- or under-claim. Optional takeaways are filed as separate pending proposals

Skills (2 tools)

  • get-skill: Load one skill's full instructions by slug (from list-skills), returned exactly as written. Unknown slugs return a structured error listing the installed slugs
  • list-skills: List installed agent skills (versioned markdown playbooks): slug, name, description, version, tags. Bodies via get-skill. Skills whose required tools are missing are hidden unless include_unavailable is set

Ability bridge (other plugins' abilities) (3 tools)

  • execute-site-ability: Invoke one third-party ability by name with an arguments object. Its own permission callback always runs, plus wpmcp governance, identity scope and rate limiting. Results are reversible:false (bridged writes are outside wpmcp rollback). Refuses wpmcp's own abilities; needs the site bridge opt-in (default off)
  • get-site-ability: Read one third-party ability's full contract by name: description, input and output schemas, meta where provided, and owning plugin. Refuses wpmcp's own abilities (use get-tool-schema). Read-only; list-site-abilities finds names
  • list-site-abilities: Abilities OTHER plugins register via the Abilities API: name, summary, owning plugin, whether an input schema exists and reversible:false (bridged results are outside wpmcp rollback). Optional plugin filter. Needs the ability bridge opt-in (default off)

Gateway credentials (3 tools)

  • gateway-provision: Provision or rotate the site gateway credential. Returns client_id, client_secret and refresh_token once; the previous credential dies immediately. Carries the calling user's capabilities. Requires confirm: true
  • gateway-revoke: Revoke the site gateway credential and every token bound to it. Local, idempotent. Requires confirm: true
  • gateway-status: Whether the site gateway credential exists, its client_id and whether OAuth is enabled. Never returns secrets

WP MCP Cloud: sync & marketplace (12 tools, 12 Pro)

  • cloud-apply-settings, Pro: Apply a posture: a cloud-sync-settings map, or (settings omitted) the last pushed one. Re-filtered to the allowlist; toggles and identities merge, scope fields only; never changes the MCP exposure switch or disables rollback-operation. Paid. Each write snapshotted; applied[i] pairs with operation_ids[i]; matching options listed as unchanged
  • cloud-connect, Pro: Connect this site to WP MCP Cloud: store the cloud url + api key and verify them by fetching the account, which is returned. gateway_consent (default false) permits a gateway credential upload; false withdraws it and kills any the cloud holds
  • cloud-gateway-provision, Pro: Mint the gateway credential bound to a scoped identity (MCP connection, that allowlist only) and upload it. Needs consent=true; replace=true kills a live one. Upload needs cloud-connect gateway_consent. Secrets shown ONCE. Revoke: gateway-revoke
  • cloud-gateway-status, Pro: Gateway credential's bound identity, upload and consent state. No secrets
  • cloud-list-assets, Pro: List the assets (widget/block specs) in this site's WP MCP Cloud account
  • cloud-marketplace-browse, Pro: Browse WP MCP Cloud marketplace widget and block specs, optionally by type and search
  • cloud-marketplace-install, Pro: Install a WP MCP Cloud marketplace listing by slug: validated like validate-widget-spec / validate-block-spec, template run through wp_kses_post, lands INACTIVE until set-widget-status / set-block-status. Refuses a name colliding with a local spec
  • cloud-pull-assets, Pro: Pull this site's WP MCP Cloud builder assets and recreate them as local custom widget/block specs (each validated first; refusals listed under skipped with a reason)
  • cloud-push-assets, Pro: Push this site's custom widget and block specs up to WP MCP Cloud (backup + reuse across sites). Optional type filter (widget|block)
  • cloud-push-settings, Pro: Push the cloud-sync-settings posture plus identity scopes (no secrets) to WP MCP Cloud for cloud-apply-settings elsewhere. Paid. Changes nothing here
  • cloud-status, Pro: Whether this site is connected to WP MCP Cloud, and where
  • cloud-sync-settings, Pro: Preview what would sync to WP MCP Cloud: governance toggles, MCP exposure switch, tool-exposure mode, skills switch. Never secrets or code-level gates (db writes, php exec, cli allowlist)

PHP snippet validation (1 tool)

  • validate-php-snippet: Statically check a PHP snippet without running it: syntax validity (error message and line) and severity-tagged findings (eval, exec, shell_exec, backticks, obfuscation decoders, request-driven input, outbound HTTP)

PHP snippet store (6 tools)

  • create-php-snippet: Store a named PHP snippet, inactive (not Elementor custom code: see create-code-snippet). Never executed; syntax errors or critical static findings refuse it (advisory, not a security boundary). Activation is separate and gated. Snapshot-first, reversible per snippet
  • deactivate-php-snippet: Deactivate a stored PHP snippet by id (reverse of activate-php-snippet). Not gated on the PHP execution opt-in, so an active snippet can always be revoked. Snapshot-first; never executes anything
  • delete-php-snippet: Delete a stored PHP snippet by id (not an Elementor custom-code post: see delete-code-snippet). Snapshot-first, reversible per snippet (restored inactive); never executes anything
  • get-php-snippet: Fetch one STORED PHP SNIPPET by id: code, status and last static-check report (advisory, not proof of safety). Not Elementor custom code (see get-code-snippet)
  • list-php-snippets: List STORED PHP SNIPPETS as summaries (id, name, status, static-check flag, timestamps) without code. Not Elementor custom code (see list-code-snippets)
  • update-php-snippet: Update a stored PHP snippet's name and/or code. New code is re-checked statically (advisory, not a security boundary) and never executed; a code change resets it to inactive. Snapshot-first, reversible per snippet

Guarded WP-CLI (1 tool, 1 Pro)

  • run-wp-cli, Pro: Run an allowlisted wp-cli subcommand (e.g. "core version"); returns stdout, stderr, exit code. Off by default (WPMCP_ALLOW_WP_CLI or wpmcp_allow_wp_cli); refused on production without a separate override; only subcommands on the wpmcp_wp_cli_allowlist filter run; shell metacharacters are rejected first

Async WP-CLI jobs (4 tools, 4 Pro)

  • cancel-cli-job, Pro: Cancel a queued background CLI job: unschedule its WP-Cron event and mark it canceled so it never runs. Errors if the job is unknown or no longer queued (running or terminal)
  • dispatch-cli-job, Pro: Queue an allowlisted wp-cli command as a background job; returns its id (poll get-cli-job). Same gates as run-wp-cli (off by default: WPMCP_ALLOW_WP_CLI or wpmcp_allow_wp_cli; production needs a separate override; allowlisted subcommands and flags; no shell metacharacters), re-checked at run time, so closing them stops queued jobs. timeout seconds (default 300, max 900). Refused while too many jobs are queued or running
  • get-cli-job, Pro: Return a background CLI job by id: status (queued/running/completed/failed/canceled), the dispatched command and, once run, size-capped stdout/stderr, exit code and timed-out flag, or the error that stopped it
  • list-cli-jobs, Pro: List background CLI jobs, newest first, with an optional status filter (queued/running/completed/failed/canceled)

Guarded PHP execution (2 tools, 2 Pro)

  • activate-php-snippet, Pro: Activate a STORED PHP SNIPPET by id (not Elementor custom code): flips the status flag, never executes it. Refused unless PHP execution is enabled (WPMCP_ALLOW_PHP_EXEC or wpmcp_allow_php_exec, default off) and the environment permits it (as run-php-snippet). Every attempt audited. Snapshot-first; rollback restores it inactive
  • run-php-snippet, Pro: Run a guarded arbitrary PHP snippet; returns its return value, output and any thrown error. REMOTE CODE EXECUTION: off by default (WPMCP_ALLOW_PHP_EXEC or wpmcp_allow_php_exec); refused on production or an unrecognized environment unless WPMCP_ALLOW_PHP_EXEC_ON_PRODUCTION is also set; the static validator rejects flagged snippets first (a speed-bump, not a security boundary). Not snapshotted; cannot be undone.

Misc (9 tools, 2 Pro)

  • create-comment: Comment on a post as you. status: approved (moderate_comments) or unapproved. Reversible
  • find-unused-media: Attachments nothing references (featured image, site logo/icon, content, builder data, post/term meta, options) with size on disk and checks run. Pass next_cursor as cursor until done; unattached:true lists parent-0 ones apart
  • get-preview-link: Preview URL for a draft, pending or scheduled post you can edit
  • incident-response: list-app-passwords (no secrets); revoke-app-password (uuid or all); list-sessions (one user, masked, no tokens); end-sessions (user_id or all); rotate-salts (wp-config.php, backup kept; refused if unwritable or defined elsewhere); reinstall-core-files (files scan-security flags, from the checksum-verified official package, never wp-content; undo: rollback-operation); quarantine-file (path, reason: moves it to a private folder; not core, wp-config or WP MCP files; undo: rollback-operation); list-quarantine; restore-quarantined-file (id, overwrite); purge-quarantined-file (id). Quarantine needs the wpmcp_enable_fs_writes opt-in. Writes need confirm:true. Cannot be undone: revoke, end-sessions, rotate-salts (logs out everyone, your cookie session too, not app passwords). Your session and app password stay unless include_current. Other users take edit_users
  • install-package-from-zip, Pro: Install or replace a plugin/theme from a Media Library ZIP. Off by default (wpmcp_enable_zip_install); needs confirm:true and its sha256. Rollbackable
  • manage-updates: Update WordPress core or set plugin/theme auto-updates. type=core applies the offered core update (or pending DB upgrade); needs confirm:true and a full backup (trigger-backup type=full) under 1h old; refuses if expected_version differs from the offer. A core update cannot be snapshot-rolled-back; restore that backup to revert. type=plugin|theme + item + enabled sets auto-update (undoable)
  • optimize-media, Pro: Recompress JPEG/PNG at quality (82), cap the full size at max_edge px and write webp/avif copies of it and each size with the server image editor. No media_id: batches by cursor, or background:true queues a job under one session_id (job_id: progress; +cancel: stop). dry_run estimates. Defers to an optimizer plugin unless force. Undo: rollback-operation. Settings: wpmcp_optimize_uploads, wpmcp_serve_modern_images
  • reply-to-comment: Reply to comment id; as create-comment
  • search-themes: Search wordpress.org themes; filters as in search-plugins

Block Suite (2 tools, 2 Pro)

  • block-suites-read, Pro: Read op on block suite blocks, patterns, settings and page CSS: operation + its args (list-operations lists each op's schema)
  • block-suites-write, Pro: Write op on block suite blocks, patterns, settings and page CSS: operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true

Bundle (2 tools)

  • export-bundle: Export PHP snippets, plus custom block/widget specs where present, as a checksummed JSON bundle for import-bundle; types and ids filter
  • import-bundle: Import an export-bundle: items are re-validated and created inactive; name clashes skip unless on_conflict=rename. Undo with rollback-session

Site Template (2 tools)

  • site-templates-read: List the block theme's templates and parts (source theme/custom, area, customized) or wp_navigation menus; entity plus id reads one as parsed blocks and content_hash. global_styles: theme/user/merged theme.json, variations, fonts (id: dot path narrows). Reports a classic theme
  • site-templates-write: Edit a block theme template or part (id: slug or theme//slug) or wp_navigation menu (id). save: content or blocks, customizing over the theme file; add_block (content: one block)/update_block/remove_block: by path with expected_hash; revert: delete the customization. global_styles (no id): save attrs {dot.path: value|null} to user styles, preset entries by slug; variation: title; revert: reset. Snapshot-first

Previous: Tools Reference, part 2Next: Free vs ProAll documentation