WM

WordPress MCP

Created 4 months ago

A comprehensive WordPress plugin that implements the Model Context Protocol (MCP) to expose WordPress functionality through standardized interfaces.

development documentation public wordpress mcp

What is WordPress MCP?

Make your WordPress site into a simple MCP server, exposing functionality to LLMs and AI agents.

Documentation

WordPress MCP

Features

  • 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

Installation# Quick Install

  1. Download wordpress-mcp.zip from releases
  2. Upload to /wp-content/plugins/wordpress-mcp directory
  3. Activate through WordPress admin 'Plugins' menu
  4. Navigate to Settings > WordPress MCP to configure

Composer Install (Development)

cd wp-content/plugins/
git clone https://github.com/Automattic/wordpress-mcp.git
cd wordpress-mcp
composer install --no-dev
npm install && npm run build

Authentication Setup# JWT Token Generation

  1. Go to Settings > WordPress MCP > Authentication Tokens
  2. Select token duration (1-24 hours)
  3. Click "Generate New Token"
  4. Copy the token for use in your MCP client

Usage

This plugin works seamlessly with MCP-compatible clients in two ways: Via Proxy: - mcp-wordpress-remote - Official MCP client with enhanced features - Claude Desktop with proxy configuration for full WordPress and WooCommerce support - Any MCP client using the STDIO transport protocol Direct Streamable Transport: - VS Code MCP Extension connecting directly to /wp/v2/wpmcp/streamable - Custom HTTP-based MCP implementations using JSON-RPC 2.0 - Any client supporting HTTP transport with JWT authentication.

Server Config

{
  "mcpServers": {
    "wordpress-mcp-server": {
      "command": "npx",
      "args": [
        "wordpress-mcp"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Jul 17, 2025
Updated At: Aug 07, 2025
Author: Automattic
Category: community
License: MIT
Tags:
development documentation public