MMCPMarkets
WM

wordpress/mcp-adapter

Analytics & monitoring
1.9K stars 229 forks Quality 62 Trend 48GPL-2.0
Repository Install

An MCP adapter that bridges the Abilities API to the Model Context Protocol, enabling MCP clients to discover and invoke WordPress plugin, theme, and core abilities programmatically.

Overview

The official WordPress package for MCP integration that exposes WordPress abilities as Model Context Protocol (MCP) tools, resources, and prompts for AI agents. This adapter bridges WordPress's Abilities API with the MCP specification, providing a standardized way for AI agents to interact with WordPress functionality. It includes HTTP and STDIO transport support, comprehensive error handling, and an extensible architecture for custom integrations. - : Automatically converts WordPress abilities into MCP tools, resources, and prompts - : Create and manage multiple MCP servers with unique configurations - : - : Unified transport implementing MCP 2025-11-25 specification for HTTP-based communication - : Process-based communication via standard input/output for local development and CLI integration - : Implement McpTransportInterface to create specialized communication protocols - : Configure servers with multiple transport methods simultaneously - : - : Default WordPress-compatible...

README

MCP Adapter

Part of the AI Building Blocks for WordPress initiative

The official WordPress package for MCP integration that exposes WordPress abilities as Model Context Protocol (MCP) tools, resources, and prompts for AI agents.

Overview

MCP Adapter bridges WordPress’s Abilities API with the MCP specification, giving AI agents a standardized way to interact with WordPress functionality. It includes HTTP and STDIO transport support, comprehensive error handling, and an extensible architecture for custom integrations.

Features

  • Ability-to-MCP conversion — WordPress abilities automatically become MCP tools, resources, and prompts
  • Multi-server management — run multiple MCP servers, each with its own transports, abilities, and handlers
  • HTTP and STDIO transports, plus a McpTransportInterface for custom protocols — see Custom Transports
  • Pluggable error handling and observability — swap in your own logging or monitoring via McpErrorHandlerInterface and McpObservabilityHandlerInterface — see Error Handling and Observability
  • Granular permissions — per-server transport authentication and per-ability permission checks — see Transport Permissions

Architecture

See the Architecture Overview for the full component breakdown.

Getting Started

Follow the Quick Start Guide to register your first ability and expose it via MCP, or jump straight to the Basic Examples for complete tool, resource, and prompt samples.

WordPress abilities are private by default. Set meta.public (or meta.mcp.public) to true to expose one, then reach it through the default server’s three meta-tools (mcp-adapter/discover-abilities, mcp-adapter/get-ability-info, mcp-adapter/execute-ability) — see Creating Abilities for the full opt-in model.

Connecting MCP Clients

Connect via WP-CLI over STDIO, or point an HTTP client at /wp-json/mcp/mcp-adapter-default-server. Configuration examples for Claude Desktop and other MCP clients — both direct STDIO and HTTP-via-proxy — are in the CLI Usage Guide.

Migration

Contributing

See CONTRIBUTING.md for local setup, coding standards, and the contribution workflow, and the Testing Guide for running the test suite.

Attribution

Model Context Protocol, MCP, and the MCP logo are trademarks of LF Projects, LLC, and are used here solely for informational purposes.

License

GPL-2.0-or-later

View the full README on GitHub

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →