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 (force: true); 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 (force: true).

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⚠ writePermanently delete a media item — no trash.

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/site-settings-update⚠ writeUpdates a set of settings. Supports title, tagline, visibility, timezone, date/time formats, registration settings, default role, and static front page.

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: August 28, 2026

Relevant to

  • WordPress