How automattic/wordpress-mcp works
WordPress MCP is an archived plugin that exposes WordPress capabilities through the Model Context Protocol. Its main runtime flow starts at the plugin bootstrap, selects a transport, and serves MCP requests through handlers backed by registered tools, resources, and prompts. Tool calls are dispatched to WordPress operations; resources expose site and account information. The plugin also provides administrator settings and JWT token management, plus a CLI for validating tool definitions. The README marks the project deprecated; detailed links below are limited to relationships shown in excerpts, the source index, or the README.
Main entry points: WpMcp.php MCP Registry · wordpress-mcp.php Plugin Bootstrap · Tools WordPress Tools · McpStreamableTransport.php MCP Transports
Components 19
MCP Runtime
- Plugin Bootstrap
wordpress-mcp.php - MCP Transports
includes/Core/McpStreamableTransport.php - MCP Registry
includes/Core/WpMcp.php - Tool Requests
includes/RequestMethodHandlers/ToolsHandler.php - Resource Requests
includes/RequestMethodHandlers/ResourcesHandler.php - Prompt Requests
includes/RequestMethodHandlers/PromptsHandler.php - Tool Dispatcher
includes/Utils/HandleToolsCall.php - Tool Registration
includes/Core/RegisterMcpTool.php
WordPress Capabilities
- WordPress Tools
includes/Tools - Site Resources
includes/Resources - MCP Prompts
includes/Prompts
Administration
- Admin Settings
includes/Admin/Settings.php - JWT Authentication
includes/Auth/JwtAuth.php - Settings Interface
src/settings/index.js - Token Controls
src/settings/AuthenticationTokensTab.js
Operations
- Tool Validation CLI
includes/Cli/ValidateToolsCommand.php - Tool Validator
includes/Utils/ValidateTool.php
Other components
- MCP Client
- WordPress Site
Connections 20
- MCP Client → MCP Transports: sends requests
- Plugin Bootstrap → MCP Transports: loads
wordpress-mcp.php - MCP Transports → MCP Registry: uses registry
includes/Core/McpStreamableTransport.php - MCP Registry → WordPress Tools: initializes tools
includes/Core/WpMcp.php - MCP Registry → Site Resources: initializes resources
includes/Core/WpMcp.php - MCP Registry → MCP Prompts: initializes prompts
includes/Core/WpMcp.php - Tool Requests → MCP Registry: lists tools
includes/RequestMethodHandlers/ToolsHandler.php - Resource Requests → MCP Registry: reads registry
includes/RequestMethodHandlers/ResourcesHandler.php - Prompt Requests → MCP Registry: uses registry
includes/RequestMethodHandlers/PromptsHandler.php - Tool Requests → Tool Dispatcher: dispatches calls
includes/RequestMethodHandlers/ToolsHandler.php - Tool Dispatcher → MCP Registry: resolves tools
includes/Utils/HandleToolsCall.php - WordPress Tools → Tool Registration: registers tools
includes/Tools/McpMediaTools.php - Site Resources → WordPress Site: reads site data
- WordPress Tools → WordPress Site: operates on content
- Plugin Bootstrap → Admin Settings: loads settings
wordpress-mcp.php - Plugin Bootstrap → JWT Authentication: loads authentication
wordpress-mcp.php - Settings Interface → Token Controls: renders tab
src/settings/index.js - Token Controls → JWT Authentication: manages tokens
- Tool Validation CLI → MCP Registry: gets tools
includes/Cli/ValidateToolsCommand.php - Tool Validation CLI → Tool Validator: validates tools
includes/Cli/ValidateToolsCommand.php