This repository will be deprecated as the mcp-adapter AI Building Block for WordPress continues releasing stable versions.
The shift aligns with two important developments:
- The Abilities API is moving into WordPress Core as of version 6.9.
- mcp-adapter is now stable and will become the canonical plugin and Composer package for MCP integration in WordPress.
We encourage all users to migrate to mcp-adapter. Future work, including new features and fixes, will happen there. This repository will remain available in archived form for historical reference.
A comprehensive WordPress plugin that implements the Model Context Protocol (MCP) to expose WordPress functionality through standardized interfaces. This plugin enables AI models and applications to interact with WordPress sites securely using multiple transport protocols and enterprise-grade authentication.
- Dual Transport Protocols: STDIO and HTTP-based (Streamable) transports
- JWT Authentication: Secure token-based authentication with management UI
- Admin Interface: React-based token management and settings dashboard
- AI-Friendly APIs: JSON-RPC 2.0 compliant endpoints for AI integration
- Extensible Architecture: Custom tools, resources, and prompts support
- WordPress Feature API: Adapter for standardized WordPress functionality
- Experimental REST API CRUD Tools: Generic tools for any WordPress REST API endpoint
- Comprehensive Testing: 200+ test cases covering all protocols and authentication
- High Performance: Optimized routing and caching mechanisms
- Enterprise Security: Multi-layer authentication and audit logging
The plugin implements a dual transport architecture:
WordPress MCP Plugin
├── Transport Layer
│ ├── McpStdioTransport (/wp/v2/wpmcp)
│ └── McpStreamableTransport (/wp/v2/wpmcp/streamable)
├── Authentication
│ └── JWT Authentication System
├── Method Handlers
│ ├── Tools, Resources, Prompts
│ └── System & Initialization
└── Admin Interface
└── React-based Token Management
| Protocol | Endpoint | Format | Authentication | Use Case |
|---|---|---|---|---|
| STDIO | /wp/v2/wpmcp |
WordPress-style | JWT + App Passwords | Legacy compatibility |
| Streamable | /wp/v2/wpmcp/streamable |
JSON-RPC 2.0 | JWT only | Modern AI clients |