What is the WordPress MCP Adapter?
The WordPress MCP Adapter is the official WordPress package that bridges the Abilities API to the Model Context Protocol. Plugins and themes register abilities, and the adapter exposes them to AI agents as tools, resources and prompts through an HTTP endpoint or WP-CLI over STDIO.
MCP Adapter is a WordPress plugin from the AI Building Blocks for WordPress initiative. It reads abilities registered through the WordPress Abilities API and publishes them in the Model Context Protocol format, so an AI agent can discover and call them.
It is a bridge rather than a finished toolbox. The tools your agent sees depend on which plugins, themes or custom code register abilities, and on whether those abilities are marked public.
What it changes for a site
- Abilities become MCP tools, resources and prompts without a hand written server.
- Several MCP servers can run side by side, each with its own transports, abilities and handlers.
- HTTP and STDIO transports ship in the box, with an interface for custom transports.
- Per-server authentication and per-ability permission checks decide who can call what.
Who it is for
Best for
- Plugin and theme developers who want their features reachable by AI agents through a standard route.
- Site owners who prefer the WordPress project's own package over a third party server.
- Teams that need custom abilities with explicit permission callbacks.
Not for
- Anyone who wants a ready made set of page building tools. The adapter ships a default server with three meta-tools, and real capability comes from other plugins.
- Sites below WordPress 6.9, since the getting started guide lists that as the minimum.
Use it with UiChemy
The adapter is the plumbing for abilities, not a design tool. If you also build pages, UiChemy Composer writes HTML, CSS and JS for WordPress, UiChemy vs Elementor AI explains where it fits, and InstaWP mcp-wp is a REST based server. Click Get Started on uichemy.com.
Connect WordPress MCP Adapter: Expose Abilities as MCP Tools to your AI client
wp plugin install https://github.com/WordPress/mcp-adapter/releases/latest/download/mcp-adapter.zip --activateInstall the plugin
Run the WP-CLI command above, or download the latest release zip from GitHub and install it like any other plugin. The guide lists PHP 7.4 and WordPress 6.9 as minimums.
Make an ability public
Abilities are private by default. Set meta.public or meta.mcp.public to true on each ability you want an agent to reach.
Choose a transport
For a local site, point the client at the wp binary with the serve command. For a remote site, use the HTTP endpoint through the Automattic proxy package and an Application Password.
List and test
Run wp mcp-adapter list to see registered servers, then send a tools/list request to confirm your abilities appear.
Client configuration
{
"mcpServers": {
"wordpress": {
"command": "wp",
"args": [
"--path=/path/to/your/wordpress/site",
"mcp-adapter",
"serve",
"--server=mcp-adapter-default-server",
"--user=admin"
]
}
}
}Endpoints and ports
/wp-json/mcp/mcp-adapter-default-serverDefault server route on your sitewp mcp-adapter serveOptional flags: --server and --user@automattic/mcp-wordpress-remoteTranslates STDIO to the HTTP endpoint with Application PasswordsWhat you can do with it
- Ability to MCP conversionRegistered abilities turn into tools, resources and prompts automatically once they are marked public.
- Multiple serversRun more than one server, each with its own transports, abilities and handlers.
- Pluggable errors and loggingSwap in your own error handler or observability handler through documented interfaces.
- Granular permissionsAuthentication is set per server and permission callbacks are set per ability.
- Run as a chosen userThe serve command takes a user so permission checks match that account, and runs unauthenticated without one.
- Custom transportsA transport interface lets you add a protocol beyond HTTP and STDIO.
Tools it exposes
mcp-adapter/discover-abilities
Lists the public abilities the default server can reach.
mcp-adapter/get-ability-info
Returns the details and schema of one ability.
mcp-adapter/execute-ability
Runs a chosen ability with the input you supply.
wp mcp-adapter list
WP-CLI command that lists servers and counts tools, resources and prompts.
Frequently asked questions
What is the WordPress MCP Adapter?
It is a WordPress plugin that maps abilities from the Abilities API onto the Model Context Protocol. An AI client can then discover tools, resources and prompts that your plugins registered, over an HTTP route or a WP-CLI STDIO session.
Is the WordPress MCP Adapter official?
The README describes it as the official WordPress package for MCP integration and lists it under the AI Building Blocks for WordPress initiative. It lives in the WordPress organization on GitHub and is licensed GPL-2.0-or-later.
How do I install the MCP Adapter?
Run the wp plugin install command with the latest release zip and the activate flag, or download the zip from GitHub and upload it in the plugin screen. The getting started guide lists PHP 7.4 and WordPress 6.9 as requirements.
How do I connect an AI client to WordPress with the adapter?
For a local site, configure the client to run wp with the mcp-adapter serve command, a path and a user. For a remote site, the guide uses a small proxy package and an Application Password against the HTTP route.
Why do I see only three tools?
The default server exposes three meta-tools for discovering, inspecting and executing abilities. Abilities are private until you set the public flag, so a fresh install shows little until a plugin registers and exposes some.
Does the adapter work without the Abilities API?
The guide says the Abilities API is built into WordPress 6.9 and later, with no separate plugin. The adapter exists to publish those abilities, so a site needs them registered by core features, plugins or your own code.
Is it safe to give an agent access to my site?
Use least privilege. The CLI guide advises avoiding the admin user unless needed, using a limited account, and validating server IDs. Permission callbacks on each ability decide what the connected user may run.
What are alternatives to the MCP Adapter?
Plugin based servers ship their own tool sets, such as Novamira, Respira and InstaWP mcp-wp. The adapter suits developers who want to publish their own abilities through the WordPress standard instead of a fixed tool set.


