Skip to content

WordPress MCP tools

The WordPress MCP toolset, available via Secure MCP, provides built-in tools and a dynamic set of abilities that varies per site.

Note

Unlike the VIP MCP toolset, abilities are not separately callable. Every ability is invoked through wordpress_execute_ability using a name discovered via wordpress_discover_abilities.

TypeNotes
readNo state change.
writeState-changing, requires appropriate permissions.
⚠ writeDestructive or irreversible. Use with care.

Built-in tools

Always available, regardless of which abilities a site exposes.

ToolTypeDescription
wordpress_discover_abilitiesreadDiscover what the WordPress installation on a given environment can do. Abilities vary per site — always discover before invoking.
wordpress_get_ability_inforeadGet the full description and input schema for a single ability on a specific environment. Use after wordpress_discover_abilities, before wordpress_execute_ability.
wordpress_execute_abilitywriteExecute an in-WordPress operation (post/page/plugin/theme/option/user/etc.) using a discovered ability name and its input.

VIP abilities

Posts

ToolTypeDescription
vip/posts-listreadList posts with filtering by status, author, categories, tags, search, slug, dates, pagination.
vip/posts-getreadGet any content by ID or slug — searches posts and pages automatically. Full content, meta, taxonomy terms.
vip/posts-createwriteCreate a new post. Block markup by default. Draft by default, unless publish is explicit.
vip/posts-updatewriteUpdate an existing post. Publishing goes live immediately — fetch first to confirm status.
vip/posts-deletewriteMove a post to trash (recoverable). No permanent-delete via MCP; a second call on an already-trashed post returns 410 HTTP status.

Pages

ToolTypeDescription
vip/pages-listreadList pages with filtering by status, author, parent (hierarchy), search, slug, dates, pagination.
vip/pages-getreadGet a page by ID or slug. Full content, meta, template, hierarchy.
vip/pages-createwriteCreate a new page. Draft by default — never publish a homepage without explicit instruction.
vip/pages-updatewriteUpdate an existing page. Publishing goes live immediately.
vip/pages-deletewriteMove a page to trash (recoverable, 30 days).

Taxonomies: Categories

ToolTypeDescription
vip/categories-listreadList categories (hierarchical taxonomy), with parent/search/slug filtering.
vip/categories-getreadGet a single category by ID: name, slug, parent, post count, archive link.
vip/categories-createwriteCreate a new category.
vip/categories-updatewriteUpdate a category. Changing slug affects archive URLs immediately.
vip/categories-delete⚠ writePermanently delete a category — no trash. Requires explicit user confirmation; posts are moved to Uncategorized.

Taxonomies: Tags

ToolTypeDescription
vip/tags-listreadList tags (flat taxonomy), with search/slug filtering.
vip/tags-getreadGet a single tag by ID: name, slug, post count, archive link.
vip/tags-createwriteCreate a new tag.
vip/tags-updatewriteUpdate a tag. Changing slug affects archive URLs immediately.
vip/tags-delete⚠ writePermanently delete a tag — no trash. Requires explicit user confirmation.

Comments

ToolTypeDescription
vip/comments-listreadList comments with filtering by post, status, author, dates.
vip/comments-getreadGet a single comment: content, author, dates, status, parent (for threads).
vip/comments-createwriteCreate a new comment.
vip/comments-updatewriteUpdate a comment. Setting status to approve publishes it immediately.
vip/comments-deletewriteMove a comment to trash (recoverable). No permanent-delete.

Menus

ToolTypeDescription
vip/menus-listreadList classic navigation menus with location assignments.
vip/menus-getreadGet a single classic menu by ID.
vip/menus-createwriteCreate a new classic navigation menu.
vip/menus-updatewriteUpdate a menu’s name, slug, description, or location assignments — site-wide impact.
vip/menus-delete⚠ writePermanently delete a menu and all its items — no trash.
vip/menu-items-listreadList items in a classic menu.
vip/menu-items-getreadGet a single menu item by ID.
vip/menu-items-createwriteAdd a new item to a classic menu.
vip/menu-items-updatewriteUpdate a menu item. Changes are visible to all visitors immediately.
vip/menu-items-delete⚠ writePermanently delete a menu item — no trash. Child items are not auto-deleted.

Media

ToolTypeDescription
vip/media-listreadList media items with filtering by type, MIME type, author, parent post, dates.
vip/media-getreadGet a single media item: URL, dimensions, file size, alt text, sizes.
vip/media-createwriteUpload a file (Base64) to the media library. Requires explicit user confirmation before executing.
vip/media-updatewriteUpdate media metadata (title, caption, alt text) — not the file itself.
vip/media-delete⚠ writeDelete a media item. On hosts without trash support, this may fail permanently (501 HTTP response) and may break posts using the image.

Themes and design

ToolTypeDescription
vip/themes-listreadList installed themes with active/inactive status.
vip/theme-activereadGet the active theme’s stylesheet slug and name.
vip/theme-presetsreadGet the site’s design tokens: color palette, font sizes/families, gradients, spacing scale.
vip/theme-stylesreadGet the site’s applied styles from theme.json — block and element-level overrides.
vip/blocks-allowedreadList block types registered on the site, including supported style variations.

Patterns

ToolTypeDescription
vip/patterns-listreadList available block patterns (library patterns) with metadata, not full markup.
vip/patterns-getreadGet a single block pattern’s full markup by name.
vip/synced-patterns-listreadList user-created synced (reusable) patterns, metadata only.
vip/synced-patterns-getreadGet a single synced pattern’s full content by ID.

Site search and settings

ToolTypeDescription
vip/content-searchreadFull-text search across all public post types. Published content only.
vip/site-posts-searchreadSearch posts within the current site with content/category/tag/type filters. Excludes confidential posts.
vip/site-post-getreadRetrieve a single post by ID or URL, with optional comments.
vip/site-settingsreadGet comprehensive site settings: general, writing, reading, media, discussion, permalink, privacy.

VIP multisite abilities

Site Editor: Templates and template parts

ToolTypeDescription
vip-multisite/list-templatesreadReturns all templates (wp_template) for a specific network site. Includes theme-supplied and user-customized templates.
vip-multisite/get-templatereadRetrieves a specific template from a network site by ID (e.g., theme-slug/index), including full block markup.
vip-multisite/update-templatewriteUpdates a template on a network site. Only include fields to change. Creates a custom override post if not yet customized.
vip-multisite/list-template-partsreadReturns all template parts (wp_template_part) for a network site: headers, footers, sidebars.
vip-multisite/get-template-partreadRetrieves a specific template part by ID (e.g., theme-slug/header), including full block markup.
vip-multisite/update-template-partwriteUpdates a template part on a network site. Creates a custom override post if not yet customized.

Site Editor: Synced patterns

ToolTypeDescription
vip-multisite/list-patternsreadReturns all synced patterns (wp_block posts) on a network site, with optional category/sync-status filtering.
vip-multisite/get-patternreadRetrieves a synced pattern by post ID, including block markup, categories, and sync status.
vip-multisite/create-patternwriteCreates a new synced pattern. Can be fully synced (edits propagate everywhere used) or unsynced (standard reusable pattern).
vip-multisite/update-patternwriteUpdates title, content, sync status, or categories of an existing pattern.

Content

ToolTypeDescription
vip-multisite/list-post-typesreadReturns all registered post types on a network site, including custom post types with labels, capabilities, supported features.
vip-multisite/create-postwriteCreates a post, page, or CPT entry on a network site. Supports title, content (raw HTML/blocks), status, post type.
vip-multisite/get-postreadRetrieves a post/page/CPT entry by ID, including content, status, custom fields, edit URL.
vip-multisite/update-postwriteUpdates title, content, status, custom fields, or other fields of an existing entry.
vip-multisite/list-postsreadPaginated list of posts/pages/CPT entries on a network site, with status/search filtering.

Site options

ToolTypeDescription
vip-multisite/get-site-optionreadReads one or more WordPress options (get_option) from a network site — reading, discussion, permalink, media, homepage settings, etc.
vip-multisite/update-site-optionwriteWrites one or more options (update_option) on a network site. Only allowlisted keys may be written (common reading/discussion/permalink/media/homepage settings, including show_on_front, page_on_front, page_for_posts). Non-allowlisted keys are skipped with a reason.

Network sites

ToolTypeDescription
vip-multisite/list-sitesreadReturns all sites registered in the multisite network.
vip-multisite/create-sitewriteCreates a new site in the multisite network.
vip-multisite/get-sitereadReturns detailed information about a specific network site.
vip-multisite/update-sitewriteUpdates settings (name, description, public visibility) for a network site.

Themes

ToolTypeDescription
vip-multisite/list-themesreadReturns all themes installed on the network, including which are network-enabled.
vip-multisite/activate-themewriteActivates a theme on a specific network site, network-enabling it first if necessary.

Network users

ToolTypeDescription
vip-multisite/list-network-usersreadReturns all users registered in the multisite network.
vip-multisite/add-user-to-sitewriteAdds an existing network user to a specific site with a given role.
vip-multisite/create-network-userwriteCreates a new user account on the multisite network.

Network plugins

ToolTypeDescription
vip-multisite/list-network-pluginsreadReturns all plugins that are network-activated across the multisite.

Jetpack abilities

Every WordPress site on the VIP Platform is provisioned with Jetpack by default.

ToolTypeDescription
jetpack-forms/list-formsreadList all forms with admin detail: response counts, status, edit URLs. Supports pagination, search, status filtering.
jetpack-forms/get-formreadGet a single form with full structure: field definitions, status, edit URL.
jetpack-forms/create-formwriteCreate a new form with a title. Optional block content for form structure. Returns new form ID and edit URL.
jetpack-forms/delete-formwriteMove a form to trash. Not permanent; trashed forms can be restored.
jetpack-forms/get-responsesreadList or search form responses: sender info, form fields, metadata. Filter by status, date range, read state, search.
jetpack-forms/update-responsewriteModify a form response: mark spam, trash, restore, toggle read/unread.
jetpack-forms/bulk-update-responseswriteMark multiple responses as spam (or restore) in one call. Per-ID success/failure reporting. Teaches Jetpack Akismet Anti-Spam from successful updates.
jetpack-forms/get-status-countsreadSummary of form responses grouped by status (inbox/spam/trash). Useful for dashboards.

Last updated: July 02, 2026

Relevant to

  • WordPress