Real MCP

A lightweight WordPress plugin that turns your site into a Model Context Protocol (MCP) server. Connect any MCP-compatible AI agent directly to your WordPress content and operations.

No external server. No Node.js. No Python. The plugin itself is the MCP server.

What Can AI Agents Do With This?

When connected via MCP, AI agents gain full read/write access to your WordPress site. The agent provides the intelligence — writing, analyzing, optimizing — while this plugin provides the operational bridge.

Update Capabilities

This plugin provides comprehensive update tools across the entire WordPress stack:

• Content — Update post titles, content, excerpts, status, categories, and tags
• Site Settings — Update site title, description, timezone, permalink structure, and more
• Custom Fields — Read and write post meta (custom fields) on any post
• SEO Metadata — Update meta titles, descriptions, focus keywords, and Open Graph data (Yoast, Rank Math, AIOSEO)
• Media — Bulk update image alt text for accessibility
• WooCommerce Products — Update product names, descriptions, prices, SKUs, categories, and status
• WooCommerce Inventory — Update stock quantities and stock status
• WooCommerce Pricing — Bulk price adjustments (fixed, percentage increase/decrease)
• Plugins — Update one or all WordPress plugins to their latest versions
• Themes — Update one or all themes to their latest versions
• Elementor — Update text content in Elementor widgets without opening the builder

Content Workflows

• Write new blog posts, articles, and pages
• Rewrite, expand, or summarize existing articles
• Merge duplicate articles into one
• Generate FAQs, documentation, release notes
• Create landing pages

SEO Workflows

• Run full site SEO audits
• Improve meta titles and descriptions (Yoast, Rank Math, AIOSEO)
• Fix missing metadata across all posts
• Generate structured data (JSON-LD schema)
• Analyze internal linking opportunities
• Keyword optimization

Accessibility (WCAG) Workflows

• Audit content for WCAG compliance
• Fix missing image alt text across the media library
• Identify heading hierarchy issues
• Review link text quality

WooCommerce Workflows

• Create and update products
• Write product descriptions and comparisons
• Manage inventory and bulk price updates
• Create and manage promotional coupons
• Plan seasonal campaigns

Elementor Workflows

• Read and update Elementor page content
• Update hero section copy, headings, CTAs
• Modify landing page text without opening the builder

Security Workflows

• Run comprehensive security audits
• Plugin risk assessment (outdated, inactive plugins)
• User permission review
• Configuration vulnerability checks

Performance Workflows

• Audit caching, database bloat, autoloaded data
• Clean up revisions, transients, spam comments
• Optimize database tables
• Flush page/object caches
• Core Web Vitals preparation

Maintenance Workflows

• Update plugins and themes
• Run WordPress Site Health checks
• Database optimization

Quick Start

1. Install and activate the plugin
2. Go to Settings → Real MCP
3. Click Generate Key and save
4. Connect your AI agent:

{
  "mcpServers": {
    "wordpress": {
      "url": "https://yoursite.com/wp-json/real-mcp/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

All Built-in Tools

General

Content

SEO

Media

WooCommerce (auto-enabled when WooCommerce is active)

Elementor (auto-enabled when Elementor is active)

Rank Math (auto-enabled when Rank Math is active)

Security

Performance

Maintenance

Accessibility

Architecture

real-mcp/
├── real-mcp.php              ← Plugin entry + autoloader
├── includes/
│   ├── bootstrap.php            ← Hooks and initialization
│   ├── Server.php               ← JSON-RPC router + capability checks
│   ├── Endpoint.php             ← REST API endpoint (Streamable HTTP)
│   ├── Admin.php                ← Settings page
│   └── Tools/
│       ├── ToolInterface.php    ← Contract (get_definition, execute, get_capability, get_category)
│       ├── AbstractTool.php     ← Base class with helper methods
│       ├── Registry.php         ← Auto-registers all built-in tools
│       ├── Content/             ← Content management tools
│       ├── SEO/                 ← SEO tools (Yoast, Rank Math, AIOSEO)
│       ├── Media/               ← Media library tools
│       ├── WooCommerce/         ← WooCommerce integration
│       ├── Elementor/           ← Elementor page builder integration
│       ├── RankMath/            ← Rank Math SEO integration
│       ├── Security/            ← Security audit tools
│       ├── Performance/         ← Performance & optimization tools
│       ├── Maintenance/         ← Update & health check tools
│       └── Accessibility/       ← WCAG audit tools
├── readme.txt                   ← WordPress.org format
├── uninstall.php                ← Clean removal
└── languages/                   ← i18n

Extending with Custom Tools

Register your own tools using the real_mcp_register_tools action:

add_action( 'real_mcp_register_tools', function ( $registry_class ) {
    $registry_class::register( new My_Custom_Tool() );
} );

Your tool must extend Real_MCP\Tools\AbstractTool:

use Real_MCP\Tools\AbstractTool;

class My_Custom_Tool extends AbstractTool {

    public function get_capability(): string {
        return 'edit_posts'; // WordPress capability required
    }

    public function get_category(): string {
        return 'custom';
    }

    public function get_definition(): array {
        return [
            'name'        => 'my_tool',
            'description' => 'Does something useful.',
            'inputSchema' => [
                'type'       => 'object',
                'properties' => [
                    'param1' => [
                        'type'        => 'string',
                        'description' => 'A parameter.',
                    ],
                ],
                'required' => [ 'param1' ],
            ],
        ];
    }

    public function execute( array $arguments ): array {
        // Your logic here.
        return $this->json_response( [ 'result' => 'done' ] );
    }
}

Conditional Tool Loading

• WooCommerce tools — only registered when WooCommerce is active
• Elementor tools — only registered when Elementor is active
• Rank Math tools — only registered when Rank Math is active (AI Visibility tools require PRO + Content AI)
• SEO tools — auto-detect Yoast, Rank Math, or All in One SEO for metadata operations

Plugin Abilities by Plugin Name

Real MCP exposes different capabilities depending on which plugins are active on your site. Below is a breakdown of abilities grouped by plugin.

Rank Math SEO

When Rank Math is active, the following MCP abilities become available:

SEO Audit & Fixes

Post-Level SEO

Site-Wide Link Analysis

AI Visibility (Content AI — PRO)

WooCommerce

When WooCommerce is active:

Elementor

When Elementor is active:

Yoast SEO / All in One SEO

When Yoast SEO or AIOSEO is active, Real MCP's built-in SEO tools automatically use the correct meta keys:

Security Model

• All requests require a valid API key (Bearer token or X-API-Key header)
• Origin validation prevents DNS rebinding attacks
• Each tool declares a WordPress capability requirement
• Write operations require admin-level capabilities
• Session management via WordPress transients (1-hour TTL)
• Safe options allowlist prevents modification of sensitive settings

Requirements

• WordPress 6.0+
• PHP 8.0+
• Optional: WooCommerce 7.0+ (for WooCommerce tools)
• Optional: Elementor 3.0+ (for Elementor tools)
• Optional: Rank Math SEO (for Rank Math tools; PRO required for AI Visibility)

License

GPL-2.0-or-later