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

Elementor deep editing (33 tools, 33 Pro)

  • add-custom-css, Pro: Add site-wide custom CSS via core Additional CSS (no Elementor Pro needed). Appends; replace=true overwrites, css="" + replace=true clears. Needs edit_css. Snapshot-first when the Additional-CSS post exists (undo: rollback-operation)
  • add-widget, Pro: Add a widget to a page's _elementor_data under parent_id (or top level) at an optional position. Cataloged widget_types (list-widgets) take typed params validated before any write; other registered widgets take raw settings. Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • apply-template, Pro: Copy a library template's content into a page with fresh ids that never collide, appended (default, optionally under parent_id at position) or replacing the whole page (mode=replace). Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • create-code-snippet, Pro: Create an Elementor Custom Code snippet. location: wp_head, wp_body_open or wp_footer. Off by default: needs wpmcp_allow_js_injection + unfiltered_html. Renders via Elementor Pro Custom Code. Undo: delete-code-snippet
  • create-popup, Pro: Create an Elementor popup (elementor_library post, type popup), optionally seeded with elements and trigger/display settings. Not snapshotted (creates only); configure further with set-popup-settings, remove with delete-post
  • create-theme-template, Pro: Create an Elementor theme-builder template: a header, footer, single, archive, loop-item, search-results or error-404 elementor_library post, optionally seeded with elements and display conditions. Not snapshotted (creates only); remove with delete-theme-template
  • delete-code-snippet, Pro: Delete an Elementor Custom Code snippet by moving it to the trash (reversible through WordPress trash / restore-post), mirroring the default delete-post path
  • delete-theme-template, Pro: Delete an Elementor library template by moving it to the trash (reversible through WordPress trash / restore-post), mirroring the default delete-post path
  • detect-elementor-version, Pro: Report the Elementor and Elementor Pro versions, supports_atomic (Elementor 4.0+) and atomic_tools_registered: the four atomic write tools register only on a builder that renders atomic elements, so check before assuming they exist
  • export-page, Pro: Export a page's Elementor content to a portable structure (content element tree + page_settings + type + version), the envelope import-template accepts, so a design can move between pages or sites
  • export-template, Pro: Export an elementor_library template as the portable envelope import-template accepts (element tree, page_settings, conditions, type, version), so it round-trips between sites intact
  • generate-widget, Pro: Generate a widget of any cataloged type (list-widgets / get-widget-schema) into a page's _elementor_data under parent_id or top level, with a seedable element id. Unknown types and invalid settings are refused before any write. Undo: rollback-operation
  • get-custom-css, Pro: Read the site's WordPress core Additional CSS
  • get-elementor-data, Pro: A page's parsed Elementor tree (id, elType, widgetType, settings, children). Large pages: summary=true (skeleton with labels and child/descendant counts), max_depth (cut nodes report truncated_children) or element_id for one subtree. Reports total/returned_elements, truncated; data_hash covers the whole page, so windowed reads are a valid expected_hash
  • get-theme-template, Pro: Read one Elementor library template: its type, display conditions and element count
  • import-template, Pro: Create an elementor_library template from an export-page or export-template envelope, also across sites. Element ids are regenerated; the envelope's page_settings and display conditions apply when present. Not snapshotted (creates only); remove with delete-post
  • list-code-snippets, Pro: List the Elementor Custom Code snippets stored on this site (elementor_snippet posts) with their location, priority and code
  • list-dynamic-tags, Pro: List registered Elementor dynamic tags (name, title, group), optionally by group. Most come from Elementor Pro, so the list is short or empty without it
  • list-global-classes, Pro: List the Elementor v4 global CSS classes of the active kit in stored order (empty when the feature has not been used), with the state_hash the global class write tools require as expected_hash
  • list-theme-templates, Pro: List Elementor theme-builder templates (header, footer, single, archive, ...), optionally filtered to one template_type, each with its display conditions
  • move-element, Pro: Reparent an element by id: remove it and append it as a child of a new parent in the page's _elementor_data. Refuses moves into itself or its descendants. Undo: rollback-operation (post snapshot)
  • remove-element, Pro: Remove an element (and its children) from a page's _elementor_data by id. Undo: rollback-operation (_elementor_data is ordinary postmeta the post snapshot captures)
  • replace-system-colors, Pro: Atomically replace all four Elementor system color slots (primary, secondary, text, accent) on the active kit: each exactly once with a valid hex color, or nothing is written. No "title" keeps the current one. Needs expected_hash from get-global-settings. Undo: rollback-operation
  • replace-system-typography, Pro: Atomically replace all four Elementor system typography slots (primary, secondary, text, accent) on the active kit: each exactly once, or nothing is written. Each entry needs at least one typography_* field; unknown keys are refused; a font enables custom typography; no "title" keeps the current one. Needs expected_hash from get-global-settings. Undo: rollback-operation
  • resolve-theme-template, Pro: Which Elementor theme-builder template wins for a location (header, footer, single, archive, ...): every candidate with its conditions, specificity and matching excludes, plus the winner. post_type/post_id resolve against a real target, else only specificity counts
  • save-as-template, Pro: Save a page's Elementor content as a reusable elementor_library template of template_type (page, section, container, header, footer, single, archive, popup, ...; default page). Not snapshotted (creates only); remove with delete-post
  • set-dynamic-tag, Pro: Bind an Elementor dynamic tag to an element setting, written into settings[dynamic][setting_key] in Elementor's [elementor-tag ...] format; other bindings are kept. Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • set-popup-settings, Pro: Set an Elementor popup's trigger/display settings (open/close triggers, timing, advanced rules), merged into the popup's _elementor_page_settings. Snapshot-first; undo: rollback-operation
  • set-template-conditions, Pro: Set where an Elementor theme template renders: conditions as part arrays (["include","singular","post"]) or slash strings ("include/general"), through Elementor Pro's conditions manager when present, else the same _elementor_conditions meta. Snapshot-first; undo: rollback-operation
  • update-element, Pro: Update an Elementor element's settings by id, merging the given settings into its existing settings. Writes the page's _elementor_data, snapshot-first; undo: rollback-operation
  • update-global-colors, Pro: Update the active Elementor kit's global colors: system_colors entries patch the four system tokens by _id (color/title); custom_colors entries update one by _id or append. Colors must be hex. Needs expected_hash from get-global-settings. Undo: rollback-operation
  • update-global-typography, Pro: Update the active Elementor kit's global typography: system_typography entries patch the four system tokens by _id; custom_typography entries update one by id or append. typography* fields merge in; setting a font enables custom typography so the token renders. Needs expected_hash from get-global-settings. Undo: rollback-operation
  • update-widget, Pro: Patch a cataloged widget's settings by element id from typed params (add-widget's schema; see get-widget-schema), validated and merged. Non-cataloged widgets are refused toward update-element. Needs expected_hash from get-elementor-data. Undo: rollback-operation

Elementor structural suite (8 tools, 8 Pro)

  • add-container, Pro: Create an Elementor layout element (container by default, or section/column) at top level or under parent_id, optional position. Columns need a parent; widgets are never parents. Needs expected_hash from get-elementor-data; stale reads refused. Undo: rollback-operation
  • batch-update, Pro: Apply N Elementor element settings updates atomically under ONE snapshot: every {element_id, settings} is validated first, one unknown id refuses the batch, and any failure rolls it all back. Needs expected_hash from get-elementor-data. One rollback-operation undoes it
  • duplicate-element, Pro: Deep-copy an Elementor element and its subtree with fresh ids, inserted right after the original. New ids use Elementor's 7-char hex format and are unique on the page. Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • find-element, Pro: Search a page's Elementor tree by el_type, widget_type, setting_key + setting_value and/or css_class (AND-combined, at least one). Each match reports element_id, types, navigator label and ancestor path; returns the current data_hash to chain a mutation
  • reorder-elements, Pro: Reorder the children of one Elementor parent (or the top level without parent_id) to an explicit id order, which must be an exact permutation of the current children. Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • set-element-label, Pro: Set an Elementor element's navigator label (stored as the _title setting); an empty label clears the custom name. All other settings survive untouched. Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • update-container, Pro: Merge settings into an Elementor container, section or column by id: given keys are set, others survive. Widgets are refused (use update-element). Needs expected_hash from get-elementor-data. Undo: rollback-operation
  • update-page-settings, Pro: Merge settings into a page's Elementor page settings (_elementor_page_settings): given keys are set, others survive. Post field keys (post_title, post_status, template, ...) are refused, use the post tools. Needs expected_hash = settings_hash from get-elementor-data. Undo: rollback-operation

Elementor v4 atomic elements (4 tools, 4 Pro)

  • add-atomic-widget, Pro: Add an Elementor 4.0+ atomic widget (e-* widgetType, e.g. e-heading, e-paragraph, e-button, e-image) to a page. Friendly params (title, content, text, image_url, alt, link) become typed $$type props for known types; any type also takes raw $$type-wrapped settings.
  • add-div-block, Pro: Add an Elementor 4.0+ atomic div-block (e-div-block) to a page under parent_id (or top level), optional position.
  • add-flexbox, Pro: Add an Elementor 4.0+ atomic flexbox (e-flexbox) to a page under parent_id (or top level), optional position.
  • update-atomic-widget, Pro: Update an Elementor 4.0+ atomic widget's settings by element id. Friendly params map to typed $$type props for known types (only those passed change); raw $$type-wrapped settings also work.

Elementor global classes (4 tools, 4 Pro)

  • create-global-class, Pro: Create an Elementor v4 global class (Class Manager) with a label and styles; returns its g- id. Pass friendly "styles" and/or raw $$type "props", optional breakpoint/state; validated against Elementor's schema, so a property it would drop is refused. Needs expected_hash from list-global-classes. Undo: rollback-operation
  • delete-global-class, Pro: Delete an Elementor v4 global class by g- id. Without confirm:true it is a dry run listing every post using the class; with it, the class set is snapshotted, then the class deleted (rollback-operation restores it). Needs expected_hash from list-global-classes
  • reorder-global-classes, Pro: Set the order of Elementor v4 global classes, which is their CSS source order and decides ties at equal specificity. Pass order: [g-id, ...]; omitted classes follow in current order and unknown ids are refused. Needs expected_hash from list-global-classes. Undoable
  • update-global-class, Pro: Update an Elementor v4 global class by g- id: rename it and/or merge styles into one breakpoint + state variant (replace_variant:true replaces it), so other responsive or hover rules survive. Needs expected_hash from list-global-classes. Undo: rollback-operation

Elementor global variables (4 tools, 4 Pro)

  • create-global-variable, Pro: Create an Elementor v4 global variable; returns its e-gv- id. label is the CSS variable name (letters, digits, - _). value: hex/rgb()/hsl() color, font family, size like 16px, or any CSS for custom-size (sizes need Elementor Pro). Needs expected_hash from list-global-variables. Undoable
  • delete-global-variable, Pro: Delete an Elementor v4 global variable by e-gv- id. Without confirm:true it is a dry run listing the posts and classes using it. Needs expected_hash from list-global-variables. Undoable
  • list-global-variables, Pro: List Elementor v4 global variables (color, font, size design tokens) with the state_hash the write tools need as expected_hash
  • update-global-variable, Pro: Update an Elementor v4 global variable by e-gv- id: label, value, or size/custom-size switch (no other type change). Needs expected_hash from list-global-variables. Undoable

Brand kits (4 tools, 4 Pro)

  • apply-brand-kit, Pro: Apply a brand kit to the active Elementor kit (system colors, swatches, the four system typography tokens, logo) as ONE snapshotted operation. Without confirm:true it only returns the per-token diff and settings_hash; with it, expected_hash must match. Any invalid entry refuses the whole kit. Undo: rollback-brand-kit or rollback-operation
  • get-brand-kit, Pro: Return one brand kit in the shape apply-brand-kit writes: system slots as hex, named swatches with id, typography mapped to Elementor typography* fields. Entries failing validation are listed in "invalid" and make the kit unappliable
  • list-brand-kits, Pro: List brand kits (bundled presets plus any from the wpmcp_brand_kits option or filter): slug, category, source, the four system colors, font families, logo flag. Filter by category, source (bundled/site) or search
  • rollback-brand-kit, Pro: Undo a brand-kit apply by restoring its single snapshot (palette, swatches, typography, logo). Defaults to the most recent apply not yet rolled back; pass operation_id to target a specific apply

Custom widget builder (9 tools, 9 Pro)

  • compile-custom-widget, Pro: Compile a published custom-widget spec into a native Elementor widget; the plugin, never the agent, writes and lints the PHP. Off unless wpmcp_enable_widget_compiler is on; needs edit_files, honors DISALLOW_FILE_EDIT. set-widget-status disables it
  • create-custom-widget, Pro: Create a custom Elementor widget from a data spec (title, controls, template with {{name}} placeholders), stored as a wpmcp_widget post. Without unfiltered_html the template is wp_kses_post-filtered (template_filtered: true)
  • delete-custom-widget, Pro: Move a custom widget to the trash (reversible via restore-post)
  • get-custom-widget, Pro: Read a custom widget's stored spec by id
  • list-control-types, Pro: List the control types a custom-widget spec may use and their Elementor controls
  • list-custom-widgets, Pro: List this site's custom widgets (id, name, title, active/inactive)
  • set-widget-status, Pro: Enable (publish) or disable (draft) a custom widget by id
  • update-custom-widget, Pro: Replace a custom widget's spec by id (re-validated; same wp_kses_post gate as create)
  • validate-widget-spec, Pro: Validate a custom-widget spec without storing it

Page builders: Bricks, Divi, WPBakery, Beaver Builder, Breakdance, Oxygen, Avada, Thrive (3 tools, 3 Pro)

  • detect-builder, Pro: Post builder: elementor|bricks|divi|wpbakery|avada|beaver-builder|breakdance|oxygen|oxygen-classic|thrive|cornerstone|gutenberg|classic
  • get-builder-content, Pro: Bricks elements; Divi|WPBakery|Avada shortcodes, Thrive HTML, oxygen-classic JSON, Divi 5 blocks, Cornerstone elements (last 6 with paths); Beaver Builder|Breakdance|Oxygen nodes; BeTheme sections by uid. Or scope design_system|templates|catalog (element: its controls) for builder bricks|breakdance|oxygen|divi|wpbakery|avada|thrive|cornerstone|betheme
  • update-builder-content, Pro: Bricks JSON; Divi|WPBakery|Avada shortcodes, Thrive HTML; oxygen-classic|Beaver Builder|Breakdance|Oxygen|Cornerstone JSON tree. All but Bricks|Divi 4: operation update(path,attrs,text), add(to,index,element), remove(path), move(path,to,index); to ''=top. WPBakery|Oxygen|Thrive|Cornerstone: also publish, restore(path: revision id). WPBakery|Avada|Oxygen|Thrive|Cornerstone: element {template}; need expected_hash. Avada|Oxygen|Thrive: save_template(path,element {title}). Oxygen: element {component}. BeTheme: JSON sections; path/to are uids, update element {size}, element {template}, publish; needs expected_hash. scope design_system (bricks|breakdance|avada): add/update/remove at classes|variables|palettes|typography|options/[/]; scope templates (wpbakery): at . expected_hash: read's hash (Divi 5, WPBakery, Avada, Oxygen, Thrive, Cornerstone), hashes.. Undo: rollback-operation

Theme structure (sidebars, shortcodes) (8 tools)

  • create-sidebar-widget: Add a classic widget (registered id_base, incl. block) to a sidebar at a 0-based position, sanitized by its update(). Undoable
  • delete-sidebar-widget: Delete a classic widget instance. Undoable
  • list-shortcodes: List registered shortcode tags ($shortcode_tags): tag name and a short description of its callback where resolvable. Optional search (substring of the tag name) narrows the result
  • list-sidebar-widgets: List the widgets assigned to a single sidebar (by sidebar_id): widget id and display name, from wp_get_sidebars_widgets() resolved against the registered widgets
  • list-sidebars: List the sidebars/widget areas registered via register_sidebar(): id, name, description
  • move-sidebar-widget: Move a classic widget to a sidebar or wp_inactive_widgets at a 0-based position. Undoable
  • render-shortcode: Render a shortcode string (e.g. "[gallery ids="1,2"]") via do_shortcode() and return the HTML. Only invokes registered shortcode tags; input without an opening "[" is refused
  • update-sidebar-widget: Merge settings into a classic widget (id like text-2) via its update(). Undoable

Content export & import (3 tools)

  • export-content: WXR export via core export_wp(), narrowed by content, author, start_date, end_date, status, to a protected uploads dir; returns path, size, count. Once per PHP process (core limit). mirror:true instead writes builder pages as stable JSON for git (post_id, or all 50 per page)
  • import-content: Import a WXR from the exports dir as new posts (title, content, status, post_type, postmeta). Off by default (wpmcp_enable_import filter), needs confirm:true, not snapshotted (recoverable:false); returns created_post_ids for delete-post. mirror:true + post_id restores that page from its export-content mirror (undoable)
  • list-exports: List the WXR export files previously generated by export-content: file name, size in bytes and created timestamp for each

Async backups (7 tools)

  • cancel-backup-job: Cancel a queued or running backup job: unschedule its event, or stop the run at its next heartbeat. Errors if unknown, a running restore, or terminal
  • delete-backup-archive: Delete a site-backup archive by job id or path and report bytes freed. The job record stays, flagged deleted, so history never points at a missing file. Paths outside the site-backup directory are refused
  • get-backup-manifest: Read a completed site-backup archive's manifest by job id or path: origin site_url/home_url, table prefix, multisite, WordPress/PHP/plugin versions, scope, per-table row counts, BLOB tables and file count. Read-only; paths outside the site-backup dir are refused
  • get-backup-status: Return a backup job's current record (status: queued/running/completed/failed/canceled, result artifact reference or error, timestamps) by job id
  • list-backup-jobs: List backup jobs, newest first, optionally by status (queued/running/completed/failed/canceled), plus schedules (next run, overdue, last run)
  • restore-site-backup: Restore this site from a site-backup archive (job_id or site-backup path). dry_run (default true) reports format, scope, prefix, multisite, WP downgrade, BLOB tables and a full db.sql parse (truncated dumps refused). dry_run=false queues a restore job and returns its job_id at once (wait=true runs inline); poll get-backup-status. The job takes a database safety archive (none: no restore), holds maintenance, rolls back on failure. preserve_session (default true) keeps you signed in; include_files (default false, scope all) swaps in staged wp-content
  • trigger-backup: Queue a WP-Cron backup job; returns its job id. type=full: portable site archive (zip: full SQL dump, wp-content, origin manifest) to restore or migrate; database/files/uploads narrow it; content: WXR export. every=daily [HH:MM], weekly [mon-sun] [HH:MM] (site time) or off schedules that type instead; each run prunes its archives past keep (default 7), never manual ones or after a failed run

Migration: find & replace, URL rewrite, site push (4 tools)

  • find-replace-content: Serialization-safe find and replace in post content, titles, excerpts or meta. dry_run (default) previews; apply returns a rollback-session id; over 10 posts needs confirm:true
  • push-site-archive: Push a site-backup archive (job_id or path; scope all or database) to another wpmcp site at target_url as its admin (target_user + target_app_password, or target_token). dry_run (default) only checks the target; dry_run:false + confirm:true uploads resumable chunks for max_seconds (call again to continue); apply:true has the target restore it (safety archive first) and rewrite URLs. Needs the outgoing-migration opt-in here, incoming there
  • receive-site-archive: Target side of push-site-archive. action start (sha256, bytes, manifest; checked before upload, resumes), chunk (upload_id, offset, base64 data), status, apply (verify, restore with a safety archive, rewrite URLs; dry_run default, confirm:true applies). Needs the incoming-migration opt-in
  • rewrite-site-urls: Rewrite one site URL to another across the database (options, postmeta, posts, termmeta, usermeta, comments), serialization-aware for plain, JSON-escaped, percent-encoded and scheme-relative forms; object values are refused and reported. dry_run (default) reports per-table counts; dry_run:false + confirm:true takes a database safety archive first or refuses, returning its job_id for restore-site-backup. Skips wpmcp_db_protected_tables (usermeta by default); never rewrites GUIDs

Local to live sync (change sets) (3 tools)

  • apply-change-set: Apply a change set (change_set from get-change-set raw=true, or path) here; dry_run defaults to true. Only selected objects are written, snapshot-first; media, terms and templates are only added; objects changed here since the base are refused unless keyed in force; deletions never apply. rollback-session undoes it
  • build-change-set: Build a local-live sync change set (objects, media bytes, terms, templates, global classes, base revisions) from a ledger marker (session_id, operation_id or since_id) and/or object refs (post:ID, option:theme_mods_X, term:TAX:SLUG) as a JSON artifact in the site-backup dir. dry_run only lists it
  • get-change-set: Inspect a change-set artifact before it is applied: origin, objects, dependencies, exclusions, truncation. include_objects=true adds full data; raw=true returns the artifact to pass to apply-change-set on the target. Read-only; site-backup dir only

Database (6 tools)

  • delete-rows: Delete rows matching a mandatory equality WHERE. Needs confirm:true and the wpmcp_enable_db_writes filter; refuses protected tables. Undo: rollback-operation (rows reinserted with their ids) if the table has a primary key and the WHERE fits the before-image cap, else recoverable:false with the before-image in the write audit log
  • describe-table: Return the columns, types and keys of a database table
  • insert-row: Insert a row into a table via $wpdb->insert() (parameterized). Refuses protected tables. Disabled by default (wpmcp_enable_db_writes filter)
  • list-tables: List database tables with estimated row counts and sizes
  • query: Run a read-only SQL query (SELECT/SHOW/DESCRIBE/EXPLAIN/WITH). Writes, DDL, stacked statements and file-access SQL are rejected before running. Reads of users/usermeta tables are blocked (wpmcp_db_allow_user_table_reads filter opts in, with secrets masked). Results are capped
  • update-rows: Update rows matching a mandatory equality WHERE via $wpdb->update(). Needs confirm:true and the wpmcp_enable_db_writes filter; refuses protected tables. Undo: rollback-operation if the table has a primary key and the WHERE fits the before-image cap, else recoverable:false with the before-image in the write audit log

Filesystem (6 tools)

  • delete-file: Delete a file in the WordPress install. Needs confirm:true. Undo: rollback-operation. Refuses wp-config.php/.htaccess. Off by default (wpmcp_enable_fs_writes filter); needs edit_files, honors DISALLOW_FILE_EDIT
  • edit-file: Replace an exact string in a file (must match once unless replace_all). Undo: rollback-operation. Refuses wp-config.php/.htaccess. Off by default (wpmcp_enable_fs_writes filter); needs edit_files, honors DISALLOW_FILE_EDIT. PHP is checked and reverted as in write-file
  • list-directory: List entries (files/dirs with size and mtime) of a directory inside the WordPress install. Optional bounded recursive listing
  • read-file: Read a file inside the WordPress install (core, plugins, themes, uploads); the path cannot leave it
  • search-files: Search file contents for a substring across a directory tree inside the WordPress install. Filterable by extension; results are capped
  • write-file: Create or overwrite a file in the WordPress install. Undo: rollback-operation. Refuses wp-config.php/.htaccess. Off by default (wpmcp_enable_fs_writes filter); needs edit_files, honors DISALLOW_FILE_EDIT. PHP must parse; a fatal on the front end or admin after saving reverts it; if that check cannot run, refused unless unchecked:true. encoding:base64 writes binary (5 MB, no PHP or scripts)

Scanners & cache (4 tools)

  • analyze-performance: Scan server config, WordPress internals (database size, autoloaded options, cron backlog, object cache, OPcache, plugin count) and a page (frontpage, url or post_id) for performance bottlenecks. Returns a scored report with ranked fixes
  • clear-cache: Flush caches: object cache, all transients, OPcache when enabled and any detected page-cache plugin through its own API. Returns what each layer cleared or lacked. Idempotent; not snapshotted (a cache has no before-image)
  • get-cache-status: Report active caching layers: the object cache backend (external or internal), OPcache and any page-cache plugin (WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache, WP Fastest Cache) detected by its functions or constants
  • scan-security: Scan this site for malware (deep=true: whole tree), core file integrity, hardening gaps, outdated software and known vulnerabilities (vulnerabilities=true; sends slugs and versions to wpvulnerability.net); checks:[compromise] looks for hack traces. Returns a 0-100 score, A-F grade and ranked fixes

Diagnostics & transients (5 tools)

  • delete-transient: Delete one named transient (cache data, not snapshotted) or run cleanup: expired_transients, revisions (beyond keep newest per post, default 5), auto_drafts (7+ days old), trash (older than days, default 0), spam_comments, orphaned_meta. Dry run by default (counts, bytes, sample ids); dry_run:false+confirm applies up to 200 items/10s, returning a cursor to resume. rollback-operation undoes all but transients; attachments and parents are skipped
  • get-debug-config: Debug constants (WP_DEBUG, WP_DEBUG_LOG, WP_DEBUG_DISPLAY, SCRIPT_DEBUG, SAVEQUERIES) and, when logging is on, the debug.log path. No secrets
  • get-debug-log: Bounded tail (max 200 lines / 64KB) of the debug log, by default WP_CONTENT_DIR/debug.log or the WP_DEBUG_LOG path. A path argument is confined to WP_CONTENT_DIR
  • get-site-health: Run Site Health tests, plugin-added ones included, as plain text. Async tests past timeout seconds (default 10, max 30) report not completed. cached: last full run. mail_test: how mail is sent (no secrets); your or admin email + confirm sends a test (manage_options, rate limited)
  • list-transients: List transients (name, expiry) with an optional search substring; limit default 50, max 500

Advanced Custom Fields (3 tools)

  • get-fields: Read a post's ACF field values, keyed by field name, via get_fields()
  • list-field-groups: List registered ACF (Advanced Custom Fields) field groups: key, title, flattened location rules and whether each is active
  • update-fields: Set one or more ACF field values on a post via update_field(). Snapshotted as a post; rollback-operation restores the prior values exactly. Disabled by default (site must opt in via the wpmcp_enable_acf_write filter)

Integrations (read/write dispatcher pairs) (26 tools)

  • acf-read: Read op on Advanced Custom Fields (field groups, post types, taxonomies, options and field values): operation + its args (list-operations lists each op's schema)
  • acf-write: Write op on Advanced Custom Fields (field groups, post types, taxonomies, options and field values): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • contactform7-read: Read op on Contact Form 7 (forms, markup, mail templates, Flamingo entries): operation + its args (list-operations lists each op's schema)
  • contactform7-write: Write op on Contact Form 7 (forms, markup, mail templates, Flamingo entries): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • forminator-read: Read op on Forminator (forms, their field definitions, and submissions): operation + its args (list-operations lists each op's schema)
  • forminator-write: Write op on Forminator (forms, their field definitions, and submissions): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • give-read: Read op on GiveWP (donation forms, donations, donors, campaigns): operation + its args (list-operations lists each op's schema)
  • give-write: Write op on GiveWP (donation forms, donations, donors, campaigns): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • gravitytables-read: Read op on Gravity Tables (data tables built from Gravity Forms entries): operation + its args (list-operations lists each op's schema)
  • gravitytables-write: Write op on Gravity Tables (data tables built from Gravity Forms entries): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • mec-read: Read op on Modern Events Calendar (events and their schedules): operation + its args (list-operations lists each op's schema)
  • mec-write: Write op on Modern Events Calendar (events and their schedules): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • metabox-read: Read op on Meta Box (registered meta boxes and per-post custom field values): operation + its args (list-operations lists each op's schema)
  • metabox-write: Write op on Meta Box (registered meta boxes and per-post custom field values): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • metform-read: Read op on MetForm (forms, their Elementor field definitions, and entries): operation + its args (list-operations lists each op's schema)
  • metform-write: Write op on MetForm (forms, their Elementor field definitions, and entries): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • plugin-data-read: Read op on the plugin-data integration: operation + its args (list-operations lists each op's schema)
  • plugin-data-write: Write op on the plugin-data integration: operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • pmpro-read: Read op on Paid Memberships Pro (membership levels, pricing, member counts, members, orders and discount codes): operation + its args (list-operations lists each op's schema)
  • pmpro-write: Write op on Paid Memberships Pro (membership levels, pricing, member counts, members, orders and discount codes): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • sureforms-read: Read op on SureForms (forms, their block field definitions, and entries): operation + its args (list-operations lists each op's schema)
  • sureforms-write: Write op on SureForms (forms, their block field definitions, and entries): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • tec-read: Read op on The Events Calendar (events and their schedules): operation + its args (list-operations lists each op's schema)
  • tec-write: Write op on The Events Calendar (events and their schedules): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • theme-read: Read op on the active theme (context, mods), site identity, permalinks, Redirection, Rank Math redirects and 404 log, backup, security, analytics, cache, mail status, site gates, fonts: operation + its args (list-operations lists each op's schema)
  • theme-write: Write op on the active theme (context, mods), site identity, permalinks, Redirection, Rank Math redirects and 404 log, backup, security, analytics, cache, mail status, site gates, fonts: operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true

Forms adapter pack (10 tools, 10 Pro)

  • fluentforms-read, Pro: Read op on Fluent Forms (forms, fields, notifications, entries): operation + its args (list-operations lists each op's schema)
  • fluentforms-write, Pro: Write op on Fluent Forms (forms, fields, notifications, entries): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • formidable-read, Pro: Read op on Formidable Forms (forms, fields, notifications, and entries): operation + its args (list-operations lists each op's schema)
  • formidable-write, Pro: Write op on Formidable Forms (forms, fields, notifications, and entries): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • gravityforms-read, Pro: Read op on Gravity Forms (forms, fields, notifications, entries, entry notes): operation + its args (list-operations lists each op's schema)
  • gravityforms-write, Pro: Write op on Gravity Forms (forms, fields, notifications, entries, entry notes): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • ninjaforms-read, Pro: Read op on Ninja Forms (forms, fields, notifications, submissions): operation + its args (list-operations lists each op's schema)
  • ninjaforms-write, Pro: Write op on Ninja Forms (forms, fields, notifications, submissions): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true
  • wpforms-read, Pro: Read op on WPForms (forms, fields, notifications; entries with entry storage): operation + its args (list-operations lists each op's schema)
  • wpforms-write, Pro: Write op on WPForms (forms, fields, notifications; entries with entry storage): operation + args per its schema (list-operations on the read half). Snapshot-first if possible (undo: rollback-operation); destructive ops need confirm:true

Internationalization (Polylang) (4 tools)

  • get-post-translations: Read a post's translations (the translated post id and title, keyed by language code) via the active multilingual plugin (Polylang or WPML)
  • link-post-translations: Link posts as translations of one another from {language, post_id} pairs via Polylang or WPML. Only the primary (first) post is snapshotted, so rollback restores that post, not the others
  • list-languages: List the site's languages (code, name, which is default) via the active multilingual plugin (Polylang or WPML)
  • set-post-language: Assign a post to a language (by code) via the active multilingual plugin (Polylang or WPML). Snapshotted as a post (a Polylang language is a term); rollback-operation restores the prior language assignment exactly

Multisite (4 tools)

  • get-network-info, requires an optional companion plugin or multisite: Report this network's id, name, domain, total site count, and main site id, via get_network()/get_main_site_id()
  • get-site-details, requires an optional companion plugin or multisite: Report a single network site's details (blog_id, url, name, last_updated) by blog_id, via get_site()/get_blog_details(). Returns an error for an unrecognized blog_id
  • is-multisite: Whether this install is a multisite network. Always registered, even on single-site, so network status can be checked before the other multisite tools
  • list-network-sites, requires an optional companion plugin or multisite: List sites on the network (blog_id, url, name, last_updated) via get_sites(), with optional limit (default 50) and offset for pagination. limit is capped at 500

Analytics & Search Console (5 tools)

  • get-analytics-connection-status: Whether an analytics provider (Google Site Kit or configured credentials) is active and appears connected. Always registered, so it can be checked before the other analytics tools
  • get-analytics-summary: Read-only sessions/users/pageviews summary over a date range (Y-m-d; default the 28 days ending yesterday) from the connected analytics provider, or the stats plugin named in source (default: first active). Errors when no provider is connected
  • get-search-console-queries: Read-only list of top search queries by clicks over a date range (Y-m-d; default the 28 days ending yesterday) from the connected Search Console provider; limit default 10, max 100. Errors when no provider is connected
  • get-search-console-summary: Read-only clicks/impressions/ctr/position summary over a date range (Y-m-d; default the 28 days ending yesterday) from the connected Search Console provider. Errors when no provider is connected
  • get-top-pages: Read-only list of top pages by pageviews over a date range (Y-m-d; default the 28 days ending yesterday) from the connected analytics provider or the stats plugin named in source; limit default 10, max 100. Errors when no provider is connected

Cron (4 tools)

  • list-cron-events: List the scheduled WP-Cron events (hook, next-run timestamp, recurrence/schedule, interval in seconds, callback args) from the cron array, plus the available schedules from wp_get_schedules(). Optional hook filter
  • run-event: Fire a scheduled cron hook now via do_action(), for debugging. Off until the wpmcp_enable_run_cron_event filter opts in; fires only hooks present in the cron array, always with their stored args. Not snapshotted: firing a hook is irreversible
  • schedule-event: Schedule a recurring (recurrence checked against wp_get_schedules()) or single event. Refuses core-critical hooks (wp_version_check, wp_update_plugins/themes, wp_scheduled_delete, delete_expired_transients, wp_privacy_delete_old_export_files). Snapshots the cron option; rollback-operation restores it
  • unschedule-event: Unschedule one occurrence (wp_unschedule_event, given timestamp and matching args) or every event for a hook (wp_clear_scheduled_hook). Core hooks included, made safe by snapshotting the cron option: rollback-operation restores it

Previous: Tools ReferenceNext: Tools Reference, part 3All documentation