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 operationsrollback-operation: Undo a single operation by restoring its pre-change snapshotrollback-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-admincreate-post: Create a post, page, or custom post typedelete-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 undoablediff-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 omittedduplicate-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 pageget-post: Read a single post, page, or custom post typeget-revision: Read a single post revision's fieldslist-post-types: List registered post types (posts, pages, custom post types)list-posts: List/search posts, pages, or custom post typeslist-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 revisionset-post-terms: Assign taxonomy terms to a post (replace, append, or remove)update-blocks: Update a page's block contentupdate-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 taxonomydelete-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 termget-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 parentslist-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 duplicateset-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 refusedupdate-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_offsetsearch-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-blocksget-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) filtersparse-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 summaryserialize-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-identicalduplicate-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-firstinsert-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-identicallist-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-sidemove-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-firstremove-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-operationupdate-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-blockdelete-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 idlist-block-control-types, Pro: List the attribute types a custom-block spec may use and the block.json type each maps tolist-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 nothingupdate-custom-block, Pro: Replace a custom block's spec by id (re-validated before it is stored). Snapshotted: returns an operation_id for rollback-operationvalidate-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 descriptionimport-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-operationinsert-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 sizesresize-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-imageset-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 backsideload-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-operationupdate-media: Update an attachment's title, alt text, caption or descriptionupload-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-operationupload-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 skippedset-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 valueupdate-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 writableupdate-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 unchangedget-user: Read one user's profile detail, including an is_admin flag derived from live capabilities. Never returns the password hashlist-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 secretsupdate-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 IDedit-comment: Edit a comment's content or author name, email, url. Reversibleget-comment: Read one commentlist-comments: List comments by post and status (emails, IPs masked). view:akismet gives Akismet status and spam/pending countsmoderate-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
Navigation menus (9 tools)
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). Undoableassign-menu-to-location: Assign a navigation menu to a registered theme location (the nav_menu_locations theme_mod). Snapshotted; rollback-operation restores the prior assignmentcreate-menu: Create a navigation menu (a nav_menu term). Undoable while unchanged, empty and in no locationdelete-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 rebuildget-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 eachlist-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 menuupdate-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. Undoabledeactivate-plugin: Deactivate a plugin. Refuses protected packages (wpmcp, Elementor). Undoabledelete-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-abledelete-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-ableget-plugin-info: Fetch full wordpress.org plugin directory info for a slug: version, rating, installs, homepage, download link and compatibilityinstall-plugin: Install a plugin from wordpress.org by slug. activate:true needs activate_plugins and is undoableinstall-theme: Install a theme from wordpress.org by slug. activate: true also needs switch_themes and returns rollbackable operation_idslist-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 statelist-themes: List installed themes with active status, parent theme and pending update infosearch-plugins: Search the wordpress.org plugin directory by keyword, with optional tag/author filters and a capped per_pageswitch-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-ableupdate-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 slotdelete-site-part: Trash a site part, freeing its per-part-type slot. Snapshot-first: operation_id rolls it backlist-site-parts: List site parts with their conditions and status, optionally by part_typeresolve-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_idsset-site-part-status: Activate (publish) or deactivate (draft) a site part; only active parts resolve. Snapshot-firstupdate-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 JSadd-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 backapply-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 itbulk-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 batchcreate-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 itcreate-product: Create a simple WooCommerce product via the CRUD layer. rollback-operation on the returned operation_id trashes itcreate-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 unchangedcreate-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 itdelete-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 iddelete-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 termsdelete-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 iddelete-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 parentget-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-safeget-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 paginglist-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 truelist-orders: List WooCommerce orders as safe summary rows (id, number, status, total, currency, date), filterable by status and customer, with paging. HPOS- and CPT-safelist-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 paginglist-tax-rates: List the store's tax classes and tax rates, filterable by class or country, with paging. Read-onlylist-variations: List the variations of one variable WooCommerce product as safe summary rows (id, sku, attributes, prices, stock), with pagingplan-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_hashupdate-coupon: Update a coupon's fields with the same checks as create-coupon. Snapshotted: rollback-operation restores every setting and usage historyupdate-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-safeupdate-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 exactlyupdate-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 locationsupdate-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 rangevalidate-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 flaggedwoo-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-onlywoo-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-onlywoo-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 typesget-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 keysget-seo-status: Which SEO plugin is active, by name and versionupdate-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. Snapshottedupdate-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 proposalgenerate-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 nothingget-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 responseget-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:falseset-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:falseupdate-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
Redirects & broken links (5 tools)
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 itdelete-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 historyfind-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 contentlist-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-onlyupdate-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 contentget-link-map: Summarize the internal-link graph: per-post outgoing and incoming link counts, the orphan list and the most-linked postssuggest-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 rollbackanalyze-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-onlyanalyze-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-onlycheck-contrast, Pro: WCAG contrast ratio of a foreground/background hex pair, with AA/AAA pass/fail for normal and large text. Read-onlyextract-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-onlyfix-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 rollbackfix-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 rollbackset-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 requireget-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 stacklist-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