Get the plugin
WP MCP/Documentation/Tools Reference

Tools Reference

WP MCP currently registers 407 abilities in the canonical test environment: 274 free and 133 Pro. Every tool below is registered as a WordPress ability named wpmcp/<tool-name> via the official Abilities API, each with its own permission_callback (content tools require edit_posts; sensitive domains are gated by stronger capabilities).

Every mutating tool routes through Safe_Mutation::run(), so it is snapshotted before it runs and can be undone with rollback-operation or rollback-session, except the small set of deliberately risky operations that are disabled by default and honestly say so in their descriptions. See The safety model for how the engine works.

This page is generated from the plugin source and its ability manifest; the descriptions below are the exact ones the AI agent sees.

Safety & history (3 tools)

  • list-operations: List recent safety snapshot operations
  • rollback-operation: Undo a single operation by restoring its pre-change snapshot
  • rollback-session: Undo all operations from a session by restoring each object's pre-session snapshot

Content & pages (16 tools)

  • count-content: Counts so a job can be sized before it starts: posts per public type by status, media by MIME family, comments by status, terms per taxonomy, users per role. From core counting APIs, so figures match wp-admin
  • create-post: Create a post, page, or custom post type
  • delete-post: Delete a post, page or CPT entry. Trash by default. force:true deletes permanently, is off until the wpmcp_enable_delete_post filter opts in, needs confirm:true. Both undoable
  • diff-revisions: Diff two revisions of a post, or one revision against the post's current state: a unified diff per changed field (title, content, excerpt) rather than two full documents. Unchanged fields are omitted
  • duplicate-post: Copy a post, page or CPT entry (content, meta but _edit_lock and _wp_old_slug, terms, builder data; children optional) as a draft unless status is set. stage:true: one linked draft to edit; publish_stage: writes it over the original (same ID, URL, comments; refused if the original changed, unless force; undo: rollback-operation); discard_stage deletes it
  • get-page: Read a page
  • get-post: Read a single post, page, or custom post type
  • get-revision: Read a single post revision's fields
  • list-post-types: List registered post types (posts, pages, custom post types)
  • list-posts: List/search posts, pages, or custom post types
  • list-revisions: List a post's revisions (id, author, date, change excerpt)
  • list-taxonomies: List registered taxonomies (categories, tags, custom taxonomies)
  • restore-revision: Restore a post to a given revision
  • set-post-terms: Assign taxonomy terms to a post (replace, append, or remove)
  • update-blocks: Update a page's block content
  • update-post: Partially update a post, page, or custom post type

Taxonomy terms (6 tools)

  • create-term: Create a category, tag or custom taxonomy term. Snapshot-first; rollback-operation reverses the creation. Refuses an existing slug, a missing parent, or a parent on a non-hierarchical taxonomy
  • delete-term: Delete a term, snapshot-first. Rolling back restores it at its original term_id and term_taxonomy_id and refiles the posts that were in it. Reports objects affected; refuses a taxonomy's default term
  • get-term: Read one term by term_id or slug, with its meta and full ancestor chain. Ancestors disambiguate a hierarchical taxonomy, where several same-named terms sit under different parents
  • list-terms: List terms in a taxonomy with search, parent filter, ordering and pagination. Empty terms are INCLUDED unless hide_empty is set (the opposite of core's default), so a partial list never leads to creating a duplicate
  • set-term-meta: Write or delete a term meta value, snapshot-first (whole term plus meta map captured, so rollback is exact). value:null deletes the key, staying distinct from an empty string. Protected keys are refused
  • update-term: Update a term's name, slug, description or parent, snapshot-first. Refuses a slug held by another term, and refuses reparenting onto itself or a descendant: core permits that and the resulting cycle makes the taxonomy unrenderable

Site content search (2 tools)

  • reindex-search: Build or rebuild the search-content index. The index updates on save; use this for the first build or after bulk or out-of-band changes. Cursor-based: each call indexes up to batch_size posts and returns next_offset
  • search-content: Search all site text, incl. what post_content search misses: Elementor and Bricks settings, block attributes, template parts, reusable blocks and nav menus. Each hit has a location (block path, element id or menu item id) and a snippet. Read-only; hits re-checked against read_post. Empty index: run reindex-search

Gutenberg blocks (5 tools)

  • convert-html-to-blocks: Convert raw HTML to Gutenberg block markup: h1-h6, p, img, ul/ol, blockquote, pre/code, hr and table map to core blocks; anything else is wrapped in core/html so nothing is lost. Pure transform, never touches a post; write it with update-blocks
  • get-block-type: Return full detail for a single registered block type by name: its attributes schema, declared supports and block-context wiring (uses_context, provides_context)
  • list-block-types: List registered block types: name, title, category, is_dynamic and attribute names. Optional category (exact) and search (substring on name) filters
  • parse-blocks: Parse block markup into its block tree via parse_blocks(). Takes "blocks" (raw markup) or "id" (parses that post's post_content). Each node reports blockName, attrs, recursively parsed innerBlocks, and an innerHTML summary
  • serialize-blocks: Serialize a block tree (parse-blocks shape) back into block markup via serialize_blocks(). A pure transform that never touches a post; write the result with update-blocks

Surgical block edits & patterns (7 tools)

  • add-block: Insert ONE block ("" markup) into a post at path (zero-based indexes into the parse-blocks tree; the last may equal the sibling count to append). Needs expected_hash (content_hash from parse-blocks); stale reads refused. Snapshot-first; other blocks stay byte-identical
  • duplicate-block: Duplicate the block at path (deep copy, inserted immediately after the original within the same parent) and return the copy's new_path. Needs expected_hash (content_hash from parse-blocks); stale reads refused. Snapshot-first
  • insert-pattern: Insert a registered block pattern's blocks into a post at path (add-block's path semantics; whitespace filler dropped). Needs expected_hash (content_hash from parse-blocks); stale reads refused. Snapshot-first; existing blocks stay byte-identical
  • list-patterns: List registered block patterns: name, title, description, categories. Optional search (substring on name or title). Markup is not returned; insert-pattern inserts it server-side
  • move-block: Move the block at from_path to position to_index among its own siblings (same parent only; compose remove-block + add-block to move across parents). Needs expected_hash (content_hash from parse-blocks); stale reads refused. Snapshot-first
  • remove-block: Remove ONE block by path (zero-based indexes into the parse-blocks tree, descending innerBlocks); nested removals keep the container. Needs expected_hash (content_hash from parse-blocks); stale reads refused. Snapshot-first; undo: rollback-operation
  • update-block: Update ONE block by path (zero-based indexes into the parse-blocks tree, through innerBlocks): replace attrs (whole) and/or inner_html (leaf blocks only; a container's children by their own paths). Needs expected_hash (content_hash from parse-blocks); stale reads refused. Snapshot-first; other blocks stay byte-identical

Composite page builds (1 tool)

  • build-page: Compose a page from ONE declarative spec: title, a recursive sections/blocks tree, media (existing attachment ids), optional menu placement. One atomic, recoverable operation: the spec is strictly validated (node-path errors, bounded size/nodes/depth) before any write, a mid-build failure removes everything it created, and success returns one operation_id whose rollback-operation removes the page and its menu placement. Markup is composed deterministically; nothing in the spec is evaluated or executed. dialect "gutenberg" (default, free) builds block markup; "elementor" (PRO, needs Elementor) an _elementor_data element tree. dry_run=true validates and composes WITHOUT writing, reporting element counts per node type, nesting depth, markup size, unknown widget types, coerced atomic props and every referential problem at once

Custom block builder (8 tools, 8 Pro)

  • create-custom-block, Pro: Create a custom Gutenberg block from a data spec (title, attributes, template with {{name}} placeholders). Validated, stored as a wpmcp_block post and registered at runtime; a render_callback interprets the template (no code generation, no eval). Remove with delete-custom-block
  • delete-custom-block, Pro: Delete a custom block by moving it to the trash. Snapshotted: returns an operation_id for rollback-operation (restore-post also works)
  • get-custom-block, Pro: Read one custom block's stored spec by id
  • list-block-control-types, Pro: List the attribute types a custom-block spec may use and the block.json type each maps to
  • list-custom-blocks, Pro: List the custom blocks on this site (id, name, title, active/inactive)
  • set-block-status, Pro: Enable (publish) or disable (draft) a custom block by id. Snapshotted: returns an operation_id for rollback-operation; a no-op status change writes nothing
  • update-custom-block, Pro: Replace a custom block's spec by id (re-validated before it is stored). Snapshotted: returns an operation_id for rollback-operation
  • validate-block-spec, Pro: Statically validate a custom-block spec (title, attributes, template) without storing it

Media library & stock images (12 tools, 1 Pro)

  • delete-media: Delete a Media Library attachment. Off until the wpmcp_enable_delete_media filter opts in; needs confirm:true. force:true deletes permanently, snapshotted (undoable)
  • get-media: Read a Media Library attachment: title, URL, every registered size and missing_sizes, dimensions, mime type, alt text, caption and description
  • import-stock-image: Sideload a stock search result into the Media Library. SSRF-guarded: https only, host allowlist (wpmcp_remote_media_allowed_hosts filter) checked first, no redirects, size caps, bytes must verify as an image. Stores attribution and license. Undo: rollback-operation
  • insert-stock-image, Pro: Run import-stock-image's SSRF-guarded import, then insert the image into the post's builder content as a Gutenberg image block. Returns two operation ids, each undoable on its own (insert, import)
  • list-media: List Media Library attachments, filtered by type ("image" or a mime like "image/png"), after/before dates and search, paged newest first with total/pages. missing_sizes:true adds each image's ungenerated registered sizes
  • resize-media: Regenerate the given registered image sizes of an attachment from its original and report each file (name, dimensions, URL). Omit sizes to fill the missing ones; media_ids: up to 20 attachments. Snapshot-first with a file backup (undoable)
  • search-stock-images: Search openly-licensed stock images: openverse (keyless, Creative Commons), pexels and unsplash (own key via set-stock-key). Results carry license, license_url, attribution and source_url for import-stock-image
  • set-stock-key: Store (or clear with an empty api_key) your own pexels or unsplash API key. Keys are encrypted at rest with a site-salt-derived key and never echoed back
  • sideload-image: Add an image to the Media Library from a url, or from a prompt via the site's AI provider (ratio e.g. 16:9). Undo: rollback-operation
  • update-media: Update an attachment's title, alt text, caption or description
  • upload-media: Upload a file to the Media Library from base64 data, an https url, or grant:true (returns a one-use upload URL and curl, for large files). Type sniffed from the bytes, not mime_type; executables and SVG refused; capped at the upload limit. Undo: rollback-operation
  • upload-svg: Add an SVG to the Media Library from markup or an allowlisted URL. A fail-closed sanitizer rejects script, foreignObject, event handlers and external references; only sanitized markup is stored. Rollback deletes it

Options & post meta (4 tools)

  • get-option: Read one wp_options value by name. Refuses sensitive/core option names (auth keys, salts, siteurl, home, active_plugins and secret/password/token-shaped names)
  • get-post-meta: Read a post's meta, either the full map or a single key. Protected meta (a leading underscore, or is_protected_meta) is always skipped
  • set-post-meta: Set a single meta key/value on a post. Refuses protected meta keys (a leading underscore, or is_protected_meta). Snapshotted via object_type post; rollback-operation restores the prior value
  • update-option: Update one wp_options value. Refuses get-option's denylist; off unless filter wpmcp_enable_option_write is on. Keeps an array/object option's type unless allow_type_change. Undoable

Site settings (2 tools)

  • get-settings: Read WordPress site settings (general, reading, writing, discussion, media, permalinks), each with its group, type and whether it is writable
  • update-settings: Update WordPress site settings from a strict allowlist. Validates/coerces each value (enum, int range, bool), rejects unsafe permalink structures, skips read-only or non-allowlisted keys and still applies the valid subset

Users (4 tools)

  • create-user: Create a new non-admin user. Auto-generates a strong password (never returned) and emails the new user so they can set their own. Rejects admin and unknown roles; defaults to subscriber. Undoable while it has no content and is unchanged
  • get-user: Read one user's profile detail, including an is_admin flag derived from live capabilities. Never returns the password hash
  • list-users: List WordPress users as safe summary rows (id, username, display name, email, roles, registration date). Display name and email are masked (masked: true): use get-user for full values. Never returns password hashes or other secrets
  • update-user: Update a non-admin user's profile fields (display name, email, url, nickname, first/last name, description). Refuses admin-capable users. Never changes role or password. Snapshotted so the change can be rolled back

Comments (5 tools)

  • delete-comment: Permanently delete a comment, or empty_spam:true for up to 100 spam. Off until the wpmcp_enable_delete_comment filter opts in; needs confirm:true. Rollback restores under a new ID
  • edit-comment: Edit a comment's content or author name, email, url. Reversible
  • get-comment: Read one comment
  • list-comments: List comments by post and status (emails, IPs masked). view:akismet gives Akismet status and spam/pending counts
  • moderate-comment: Set a comment's status: approve, unapprove, spam, not_spam (Akismet learns), trash, untrash, or recheck (Akismet rechecks pending; confirm:true). ids[] for up to 100. Reversible
  • add-menu-item: Add an item to a navigation menu (custom link by title and url, or an object link via type, object, object_id). Undoable
  • assign-menu-to-location: Assign a navigation menu to a registered theme location (the nav_menu_locations theme_mod). Snapshotted; rollback-operation restores the prior assignment
  • create-menu: Create a navigation menu (a nav_menu term). Undoable while unchanged, empty and in no location
  • delete-menu: Delete a navigation menu (a nav_menu term). Off until the wpmcp_enable_delete_menu filter opts in; needs confirm:true. Not automatically reversible: the menu name and items are returned for a manual rebuild
  • get-menu: Read one navigation menu with its ordered items (id, title, url, type, parent, order)
  • list-menu-locations: List the theme's registered menu locations and the menu (if any) assigned to each
  • list-menus: List the site's navigation menus as safe summary rows (id, name, slug, item count)
  • remove-menu-item: Remove an item from a navigation menu. Snapshotted as a post; rollback-operation resurrects it at its original id, re-attached to its menu
  • update-menu-item: Update a navigation menu item's title, url, parent, or position. Snapshotted as a post; rollback-operation restores the prior values exactly

Plugins & themes (13 tools)

  • activate-plugin: Activate an installed plugin. Undoable
  • deactivate-plugin: Deactivate a plugin. Refuses protected packages (wpmcp, Elementor). Undoable
  • delete-plugin: Permanently delete an installed plugin's files. Disabled by default (wpmcp_enable_delete_plugin filter) and needs confirm:true. Refuses protected or active plugins. Not rollback-able
  • delete-theme: Permanently delete an installed theme's files. Disabled by default (wpmcp_enable_delete_theme filter) and needs confirm:true. Refuses the active theme (or its active parent). Not rollback-able
  • get-plugin-info: Fetch full wordpress.org plugin directory info for a slug: version, rating, installs, homepage, download link and compatibility
  • install-plugin: Install a plugin from wordpress.org by slug. activate:true needs activate_plugins and is undoable
  • install-theme: Install a theme from wordpress.org by slug. activate: true also needs switch_themes and returns rollbackable operation_ids
  • list-plugins: List installed plugins with active status, protected-package flag and pending update info; updates:true lists core, plugin and theme updates with auto-update state
  • list-themes: List installed themes with active status, parent theme and pending update info
  • search-plugins: Search the wordpress.org plugin directory by keyword, with optional tag/author filters and a capped per_page
  • switch-theme: Activate an installed theme. Snapshots the prior template/stylesheet options (undoable)
  • update-plugin: Update an installed plugin to the latest wordpress.org version. Disabled by default (wpmcp_enable_update_plugin filter) and needs confirm:true. File changes are not rollback-able
  • update-theme: Update an installed theme to the latest wordpress.org version. Disabled by default (wpmcp_enable_update_theme filter) and needs confirm:true. File changes are not rollback-able

Theme builder (headers, footers, 404) (6 tools)

  • create-site-part: Create a header, footer or 404 site part, shown where an include rule matches and no exclude rule does; not the Elementor theme-template tools. Capped per part type; wpmcp/delete-site-part frees a slot
  • delete-site-part: Trash a site part, freeing its per-part-type slot. Snapshot-first: operation_id rolls it back
  • list-site-parts: List site parts with their conditions and status, optionally by part_type
  • resolve-site-part: Which site part wins for a context (most specific, then priority), with every candidate and why. post_id alone fills post_type and term_ids
  • set-site-part-status: Activate (publish) or deactivate (draft) a site part; only active parts resolve. Snapshot-first
  • update-site-part: Edit a site part; omitted fields are kept, part_type is fixed. Snapshot-first: operation_id rolls it back

Custom CSS & JavaScript (2 tools, 2 Pro)

  • add-custom-js, Pro: Store the site-wide JS snippet printed in wp_footer (replaces the previous one; js="" + replace=true clears). XSS-CLASS SURFACE, off by default: needs WPMCP_ALLOW_JS_INJECTION or wpmcp_allow_js_injection, plus unfiltered_html and manage_options. Snapshot-first; closing the gate stops rendering stored JS
  • add-scoped-css, Pro: Store CSS printed in wp_head only on one post/page (post_id required). Pass css, or selector plus bare declarations; element_id (Elementor) scopes it to .elementor-element-. Appends; replace=true overwrites, css="" + replace=true clears. Site-wide: add-custom-css. Needs edit_css and manage_options. Refuses script-capable CSS (markup, expression(), script or data: URLs, @import), even obfuscated. Snapshot-first per page

WooCommerce (32 tools, 3 Pro)

  • add-order-note: Add an internal or customer-facing note to a WooCommerce order. Additive only; nothing to roll back
  • apply-product-import: Apply a plan-product-import plan: same rows and mode plus its plan_hash. Refused if the store or rows changed; confirm:true above the threshold. rollback-session on its session_id undoes it
  • bulk-update-products: Update up to 50 products and variations in one call; each item {id, ...fields} as update-product/update-variation take them, same rules and permission checks. Per item: ok, operation_id or error; one failure does not stop the rest. rollback-session on the returned session_id undoes the batch
  • create-coupon: Create a coupon. Refuses a code already in use, an unknown discount_type, a percent over 100 or an invalid email restriction. Status defaults to draft. rollback-operation trashes it
  • create-product: Create a simple WooCommerce product via the CRUD layer. rollback-operation on the returned operation_id trashes it
  • create-tax-rate: Create a tax rate. rate is a percentage from 0 to 100; country must be a known ISO code or "" for all; class must be standard or an existing class. rollback-operation deletes it while unchanged
  • create-variation: Add a variation to a variable product. attributes maps each variation attribute to one of its options ("" or omitted = any); unknown attributes or options are refused. Prices, sku, status and stock follow update-variation's rules. rollback-operation trashes it
  • delete-coupon: Delete a coupon (trash by default, force for permanent). Disabled until the site opts in via the wpmcp_enable_delete_coupon filter; needs confirm:true. Snapshotted: rollback-operation restores it at the same id
  • delete-product: Delete a WooCommerce product (trash by default, force for permanent). Off until the wpmcp_enable_delete_product filter opts in; needs confirm:true. Snapshotted: rollback resurrects a force-deleted product at its id with price, stock and terms
  • delete-tax-rate: Delete a tax rate. Disabled until the site opts in via the wpmcp_enable_delete_tax_rate filter; needs confirm:true. Snapshotted: rollback-operation restores it at the same id
  • delete-variation: Permanently delete a product variation (there is no variation trash). Disabled until the site opts in via the wpmcp_enable_delete_variation filter; needs confirm:true. Snapshotted: rollback-operation resurrects it at the same id, attached to its parent
  • get-coupon: Read one coupon's full settings by id or code (limits, restrictions, usage)
  • get-order: Read full detail for one WooCommerce order (status, billing email, payment method, line items, customer note). HPOS- and CPT-safe
  • get-product: Read full detail for one WooCommerce product (prices, stock, description, categories, tags)
  • get-sales-report: Read-only sales summary over a date range: order count, gross sales, items sold and top products by quantity. Aggregated over wc_get_orders() (HPOS- and CPT-safe)
  • list-coupons: List coupons as summary rows (id, code, status, type, amount, usage, expiry), with code search, status filter and paging
  • list-low-stock-products: List products and variations at or below a managed-stock threshold (default: the store's low-stock setting) or out of stock, as rows whose ids feed update-product/update-variation. Page while has_more is true
  • list-orders: List WooCommerce orders as safe summary rows (id, number, status, total, currency, date), filterable by status and customer, with paging. HPOS- and CPT-safe
  • list-product-categories: List WooCommerce product categories (the product_cat taxonomy) as summary rows (id, name, slug, parent, count)
  • list-products: List WooCommerce products as safe summary rows (id, name, sku, price, stock status), filterable by search, status, type, or category, with paging
  • list-tax-rates: List the store's tax classes and tax rates, filterable by class or country, with paging. Read-only
  • list-variations: List the variations of one variable WooCommerce product as safe summary rows (id, sku, attributes, prices, stock), with paging
  • plan-product-import: Plan a product import; writes nothing. Rows: sku, name, type (simple/variable), regular_price, sale_price, stock, categories, attributes, variations, images (media ids or https URLs), status. Per row: create, update (diff), skip or error; plus a plan_hash
  • update-coupon: Update a coupon's fields with the same checks as create-coupon. Snapshotted: rollback-operation restores every setting and usage history
  • update-order-status: Change a WooCommerce order's status, validated against the store's registered statuses. Snapshotted via the wc_order object type so rollback-operation restores the prior status exactly. HPOS- and CPT-safe
  • update-product: Update a WooCommerce product's fields (price, stock, description, etc.). stock_status is accepted only while stock is unmanaged and never on a variable product. Snapshotted as a post; rollback-operation restores the prior price and stock exactly
  • update-tax-rate: Update a tax rate with the same checks as create-tax-rate; postcodes and cities replace the whole list. Snapshotted: rollback-operation restores the row and its locations
  • update-variation: Update a WooCommerce variation: regular_price, sale_price, sku, status (publish/private), manage_stock, stock_quantity and stock_status (only while stock is unmanaged). Snapshotted; rollback-operation restores price and stock, keeps it attached to its parent and re-syncs the parent's price range
  • validate-coupon: Check whether a coupon code would be accepted: published, expiry, usage limits, and (when email or subtotal is given) per-customer limit, email allow-list and spend rules. Each rule reports pass, fail or skipped; cart-dependent rules are flagged
  • woo-ops, Pro: List WooCommerce ops (e.g. orders.get) by domain: products, variations, orders, refunds, coupons, customers, reviews, reports, shipping, taxes, webhooks, settings, gateways, system-status. Each op: mode, route, path params, capability, confirm, enabled, snapshot type, full-rollback flag. Read-only
  • woo-read, Pro: Run one read op from woo-ops as an in-process wc/v3 request as the current user, gated by op capability and governance (wpmcp/woo-{op}, dots as dashes). Path params fill the route, the rest are query. Returns the raw wc/v3 body (may include personal data; secrets redacted); 20 per page, max 50. Read-only
  • woo-write, Pro: Run one woo-ops write op or a batch of up to 25 as in-process wc/v3 requests as the current user, gated like woo-read. Path params fill the route, the rest are the body (query for deletes). Changes to existing state are snapshotted (operation_id for rollback-operation); creates return recoverable:false and an undo_op. Refunds are not recoverable and call the gateway only with api_refund:true. Deletes and refunds need the wpmcp_woo_op_enabled filter and confirm:true. A batch prechecks every item, refuses whole on any failure and shares one session_id for rollback-session

SEO metadata (5 tools)

  • get-crawler-files: robots.txt (served output, physical file, managed rules), llms.txt, and the served sitemap (core or SEO plugin) with its post types
  • get-seo-meta: Read a post's SEO title, meta description, focus keyword, canonical URL, and robots flags (noindex/nofollow) via the active SEO plugin's postmeta keys
  • get-seo-status: Which SEO plugin is active, by name and version
  • update-crawler-files: Add robots.txt rules per User-agent, build llms.txt, or exclude post types, taxonomies or posts from the core sitemap (lists replace). Refused if a file or SEO plugin owns it. Snapshotted
  • update-seo-meta: Set a post's SEO title, meta description, focus keyword, canonical URL and/or robots flags (noindex/nofollow) via the active SEO plugin's postmeta keys. Snapshotted as a post; rollback-operation restores the prior values exactly

SEO depth: term SEO, social meta, schema (6 tools, 6 Pro)

  • generate-meta-tags, Pro: Propose a post's title, description, canonical, robots, OpenGraph and Twitter tags from SEO plugin fields or the post record, each with its source. Read-only proposal
  • generate-schema-markup, Pro: Generate schema.org JSON-LD (Article, WebPage, LocalBusiness or Product) for a post from title, dates, author, excerpt or SEO description, featured image, permalink and, for Product, the WooCommerce record. Proposal only: writes nothing
  • get-social-meta, Pro: Read a post's OpenGraph and Twitter overrides (title, description, image) from the active SEO plugin as one field set. Plugins with unmapped social storage return a structured unsupported response
  • get-term-seo-meta, Pro: Read a term's SEO fields (as get-seo-meta) by taxonomy plus term_id or slug. Fields the plugin lacks on terms are in unsupported_fields; no term storage returns supported:false
  • set-social-image, Pro: Set a post's OpenGraph and/or Twitter image from an attachment_id or image_url via the active SEO plugin. Snapshotted, undo with rollback-operation. Unmapped plugins return supported:false
  • update-term-seo-meta, Pro: Set a term's SEO fields (as update-seo-meta) by taxonomy plus term_id or slug. Snapshotted; rollback-operation undoes it. Fields the plugin lacks on terms return in skipped_fields
  • create-redirect: Create a managed redirect from a source path to a target URL or target_post_id (which survives slug changes). Chains are flattened to one hop and loops refused; the stored target is reported. Snapshotted; rollback-operation removes it
  • delete-redirect: Delete one managed redirect. The whole row is snapshotted first, so rollback-operation brings the same redirect back; use update-redirect with enabled:false instead to stop it firing while keeping its hit history
  • find-broken-links: Scan published content for internal links that are dead, point at a non-public post or go through a redirect. background:true queues a batched scan; poll it with scan_id. Proposes fixes, changes no content
  • list-redirects: List this site's managed redirects (source path, resolved target, status code, enabled, hit count), plus pending suggestions raised when a published post was deleted or moved. Filter by enabled state or a search string. Read-only
  • update-redirect: Change one managed redirect: its source, target/target_post_id, status code, enabled state or notes. Only the fields you pass change. Retargeting re-runs chain flattening and loop detection. Snapshotted and reversible

Internal linking (3 tools)

  • find-orphan-posts: List published posts or pages that have zero incoming internal links (orphans), by scanning the most-recent posts for links that resolve to this site's own content
  • get-link-map: Summarize the internal-link graph: per-post outgoing and incoming link counts, the orphan list and the most-linked posts
  • suggest-internal-links: Suggest related published posts a given post should link to, ranked by shared categories/tags and title keyword overlap, excluding posts it already links to

Content analysis (accessibility, SEO, contrast) (8 tools, 8 Pro)

  • add-alt-text-from-context, Pro: Write missing image alt text in a post from filename, nearest heading or title. Keeps existing alt unless overwrite_existing=true; skips decorative images. Dry run unless apply=true; one snapshot, one rollback
  • analyze-accessibility, Pro: Scan a post's HTML for WCAG issues (missing alt text, heading jumps, empty or vague link text, unlabeled form controls): scored findings with element locations. Read-only
  • analyze-seo, Pro: op score (default; post_id): on-page SEO 0-100 with findings (title/meta length, headings, words, alt, links, keyword density, readability). op keywords: volume, difficulty, CPC, intent. op backlinks (target domain or URL): link counts. Both use your provider key (set-seo-data-key), cached. Read-only
  • check-contrast, Pro: WCAG contrast ratio of a foreground/background hex pair, with AA/AAA pass/fail for normal and large text. Read-only
  • extract-content, Pro: A post's plain text and structure (headings, word count, link and image counts). keywords=N adds the top N terms and 2-3 word phrases, title and headings weighted. Read-only
  • fix-color-contrast, Pro: Raise failing inline text/background color pairs in a post to a target WCAG ratio by lightness only (hue kept); before/after color, ratio, level per pair. Dry run unless apply=true; one snapshot, one rollback
  • fix-link-text, Pro: Replace empty or generic internal link text ("click here", "read more") with the destination title (WCAG 2.4.4, SEO). Skips external links and anchors with markup. Dry run unless apply=true; one snapshot, one rollback
  • set-seo-data-key, Pro: Save SEO data provider credentials for analyze-seo (empty api_key clears); dataforseo: "login:password". Encrypted, never echoed

Elementor catalog (free) (4 tools)

  • get-global-settings: Read the Elementor kit's global colors, typography, spacing and layout. Returns the settings_hash the global color and typography writes require
  • get-widget-schema: The settings schema for one Elementor widget type: curated typed params (defaults, enums, responsive hints, required plugin) for cataloged widgets, or with full:true (and for non-cataloged widgets) the full introspected control stack
  • list-widgets: List Elementor registered widget types (name, title, categories, icon, tier, availability), annotated from the curated catalog (purpose, cataloged flag). Filter by tier (free/pro), category or case-insensitive search (name, title, catalog keywords)
  • regenerate-elementor-css: Rebuild Elementor CSS; all needs confirm

Previous: The Safety ModelNext: Tools Reference, part 2All documentation