MCP Adapter v0.3.0 is now available. This package is the official WordPress integration for the Model Context Protocol (MCP), exposing WordPress abilities (registered via the Abilities API) as MCP tools, resources, and prompts that AI agents can discover and invoke.

Where earlier releases established the coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. adapter and architecture, 0.3.0 focuses on transport, observability, and error‑handling improvements, and aligns the adapter with the Abilities APIAbilities API A core WordPress API (introduced in 6.9) that creates a central registry of capabilities, making WordPress functions discoverable and accessible to AI agents, automation tools, and developers. Transforms WordPress from isolated functions into a unified system. v0.4.0 and the latest MCP HTTPHTTP HTTP is an acronym for Hyper Text Transfer Protocol. HTTP is the underlying protocol used by the World Wide Web and this protocol defines how messages are formatted and transmitted, and what actions Web servers and browsers should take in response to various commands. specification.

What the MCP AdapterMCP Adapter Translates WordPress abilities into Model Context Protocol format, allowing AI assistants like Claude and ChatGPT to discover and invoke WordPress capabilities as tools, resources, and prompts. does

The MCP Adapter sits between WordPress and MCP clients (agents, IDEs, assistants) and:

• Converts WordPress abilities into MCP tools, resources, and prompts.
• Supports multiple MCP servers with different configurations from one WordPress site.
• Provides HTTP and STDIO transports, as well as an interface for custom transports.
• Includes validation, permissions, observability, and WP‑CLICLI Command Line Interface. Terminal (Bash) in Mac, Command Prompt in Windows, or WP-CLI for WordPress. integration, enabling MCP servers to run locally or in production.

It is part of the AI Building Blocks for WordPress, alongside the Abilities API, PHPPHP PHP (recursive acronym for PHP: Hypertext Preprocessor) is a widely-used open source general-purpose scripting language that is especially suited for web development and can be embedded into HTML. https://www.php.net/manual/en/preface.php./WP AI Client, and the AI Experiments pluginAI Experiments Plugin WordPress's AI laboratory bringing all building blocks together. Serves as both a user tool and developer reference implementation. First release (v0.1.0) includes Title Generation experiment..

Highlights in v0.3.0

Version 0.3.0 introduces several breaking changes and new capabilities:

• Unified observability model
  • All events now share a single event name (for example, mcp.request) with a status tag indicating success or failure, instead of separate success and failure-specific event names.
  • Observability handlers are now instance‑based and use a single record_event() method that can capture both events and timings via the McpObservabilityHandlerInterface.
• New HTTP transport layer
  • The previous RestTransport and StreamableTransport implementations have been replaced by a single HttpTransport class that implements the 2025‑06‑18 MCP HTTP specification, sessions, and JSONJSON JSON, or JavaScript Object Notation, is a minimal, readable format for structuring data. It is used primarily to transmit data between a server and web application, as an alternative to XML.‑RPC response handling (streaming will come in later versions).
• WP_Error‑based error handling
  • Error handling has been refactored across handlers to use WP_Error consistently instead of exceptions.
  • Tool and resource errors now conform to the MCP error response format, improving interoperability with MCP clients.
• Standardized hook names
  • All pluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. are now prefixed with mcp_adapter_ for consistency, replacing older hook names such as mcp_validation_enabled.
• Documentation and tooling
  • A dedicated migrationMigration Moving the code, database and media files for a website site from one server to another. Most typically done when changing hosting companies. guide (docs/migration/v0.3.0.md) walks through code updates for observability handlers, transports, and hooks.
  • Documentation has been expanded for transport permissions, custom transports, and error‑handling patterns; CI and static analysis tooling have also been updated.
• Bug fixes and robustness improvements
  • Fixes include preventing metadata from leaking into tool responses, improving handling of null and falsy parameters, and tightening validation for abilities without input schemas.

Migration notes for existing users

If you are already running an MCP serverMCP Server Exposes tools, resources, and prompts according to Model Context Protocol specification. WordPress can run multiple MCP servers with different configurations. with the adapter, upgrading to 0.3.0 requires a few targeted changes: 

1. Update observability handlers

• Switch from static helper methods to instance methods implementing McpObservabilityHandlerInterface.
• Replace any usage of a dedicated error event helper (record_error_event‑style methods) with a call to record_event() that includes status, error categoryCategory The 'category' taxonomy lets you group posts / content together that share a common bond. Categories are pre-defined and broad ranging., and any timing information.
  

2. Update transport configuration

• Replace references to RestTransport or StreamableTransport in your server configuration with HttpTransport.
  

Example:

use WP\MCP\Transport\HttpTransport;

$adapter->create_server(
    'my-server',
    'my-namespace',
    'mcp',
    'My MCP Server',
    'Description',
    '1.0.0',
    [ HttpTransport::class ],
    \WP\MCP\Infrastructure\ErrorHandling\ErrorLogMcpErrorHandler::class
);

3. Rename hooks to the new prefix

• Update any filters or actions you register to use the mcp_adapter_… hook names, for example:

add_filter(
    'mcp_adapter_validation_enabled',
    __return_true()
);

The migration guide in the repository provides detailed examples and is the recommended reference for updating existing deployments.

Where to go next

• MCP Adapter GitHub repository and documentation: architecture overview, examples, and migration guides.
• MCP Adapter overview post on the Make/Core AI blog for broader context and use‑cases.
• Abilities API and WP AI Client SDK documentation, to see how abilities, the MCP Adapter, and the SDK form a cohesive layer for AI integrations across WordPress.

These recent releases together move the AI building blocks closer to a complete end‑to‑end stack: WordPress can describe what it can do, expose those abilities to MCP‑compatible tools, and call out to external AI providers from plugins and themes using a unified client.