Royal MCP Royal Security Royal Speed Support
Support / Royal MCP

Royal MCP Documentation

Complete guide to connecting AI platforms to your WordPress site using Model Context Protocol. Learn how to set up, configure, and use Royal MCP with Claude, ChatGPT, and other AI assistants.

Getting Started

Royal MCP enables AI platforms like Claude, ChatGPT, and Google Gemini to securely interact with your WordPress content through the Model Context Protocol (MCP). This allows AI assistants to read your posts, create content, manage media, and understand your site structure.

What is MCP?

Model Context Protocol (MCP) is an open standard developed by Anthropic for connecting AI assistants to external data sources. It provides a secure, standardized way for AI platforms to read and interact with your applications.

Key Benefits

No more copy-pasting content to AI. With Royal MCP, AI assistants access your WordPress content directly in real-time.

Requirements

  • WordPress 5.8 or higher
  • PHP 7.4 or higher
  • HTTPS enabled (required for Claude Desktop integration)

Installation

From WordPress.org (Recommended)

Search for the plugin

In your WordPress admin, go to Plugins > Add New and search for "Royal MCP"

Install and activate

Click "Install Now" then "Activate" once installation completes

Configure settings

Navigate to Royal MCP > Settings in your admin menu to begin setup

Manual Installation

Download the plugin

Download the ZIP file from WordPress.org or your purchase receipt

Upload via WordPress

Go to Plugins > Add New > Upload Plugin, choose the ZIP file, and click "Install Now"

Activate the plugin

Click "Activate Plugin" after installation completes

Configuration

Basic Setup

Enable Royal MCP Integration

Toggle the main switch to ON to activate the MCP endpoints

Copy your API Key

An API key is auto-generated on activation. Copy this for use with AI platforms.

Add AI Platforms

Use the dropdown to add platforms like Claude, OpenAI, etc. Enter their API keys.

Test Connection

Click "Test Connection" on each platform card to verify setup.

Note

Your WordPress API key is different from platform API keys. The WordPress key authenticates requests TO your site, while platform keys authenticate requests FROM your site to AI services.

Royal MCP Settings Page

The main Royal MCP settings page showing API key and endpoint configuration

AI Platform Configuration

Adding and configuring AI platforms with API keys and model selection

Claude Desktop Integration

Royal MCP includes a native MCP connector designed specifically for the Claude Desktop app.

Setup Steps

Get your Remote MCP Server URL

In Royal MCP settings, scroll to "Claude Connector Settings" and copy the Remote MCP Server URL

Open Claude Desktop Settings

In Claude Desktop, go to Settings > Connectors

Add Custom Connector

Click "Add custom connector", enter a name (e.g., "My WordPress Site"), and paste the URL

Save and Start Chatting

Click "Add" to save. You can now ask Claude about your WordPress content!

HTTPS Required

Claude Desktop requires a publicly accessible HTTPS URL. Localhost URLs will not work. For local development, use a tool like ngrok to create a secure tunnel.

Claude Desktop MCP Configuration

Claude Desktop showing Royal MCP connector with all 37 WordPress tools and permission controls

Example Commands

Once connected, try asking Claude:

  • "Summarize my last 10 blog posts"
  • "List all draft posts on my site"
  • "Create a new post about [topic]"
  • "What categories do I have?"
Claude MCP Working Verification

Real proof of Royal MCP working with Claude - successful site info retrieval

Supported AI Platforms

Royal MCP supports multiple AI platforms. Each can be configured independently.

Platform Connection Type Notes
Claude (Anthropic) Native MCP Full MCP support with Claude Desktop
OpenAI (GPT-4) REST API Via custom GPT or API integration
Google Gemini REST API Via API integration
Mistral AI REST API Via API integration
Perplexity REST API Via API integration
Groq REST API High-speed inference

Platform Resources & Documentation

Official documentation and developer resources for each supported AI platform:

🤖

Claude (Anthropic)

docs.anthropic.com
🔥

OpenAI

platform.openai.com/docs
✨

Google Gemini

ai.google.dev/docs
🌌

Mistral AI

docs.mistral.ai
🔍

Perplexity

docs.perplexity.ai
⚡

Groq

console.groq.com/docs
💫

Cohere

docs.cohere.com
🚀

Together AI

docs.together.ai
🐋

DeepSeek

api-docs.deepseek.com
☁

AWS Bedrock

docs.aws.amazon.com/bedrock

MCP Protocol Resources

Learn more about the Model Context Protocol standard:

📜

MCP Specification

modelcontextprotocol.io
📰

MCP Announcement

anthropic.com/news

Managing API Keys

WordPress API Key

This key authenticates requests to your WordPress site from AI platforms.

  • Auto-generated when plugin is activated
  • Click "Regenerate" to create a new key (invalidates the old one)
  • Keep this key secure - anyone with it can access your site via API

Platform API Keys

These keys authenticate requests from your site to AI services.

  • Obtain from each platform's developer console
  • Enter in the corresponding platform card in settings
  • Keys are stored securely in your WordPress database
Security Best Practice

Regenerate your WordPress API key periodically, especially if you suspect it may have been compromised.

MCP Tools Reference

Royal MCP exposes 37 tools to AI platforms, organized by category.

Posts

wp_get_posts
List posts with optional filtering
wp_get_post
Get single post by ID
wp_create_post
Create new post
wp_update_post
Update existing post
wp_delete_post
Delete post
wp_count_posts
Get post counts by status

Pages

wp_get_pages
List pages
wp_get_page
Get single page
wp_create_page
Create new page
wp_update_page
Update existing page

Media

wp_get_media
List media items
wp_get_media_item
Get single media item
wp_delete_media
Delete media
wp_count_media
Get media counts

Taxonomies

wp_get_categories
List categories
wp_get_tags
List tags
wp_create_term
Create category or tag
wp_delete_term
Delete term

Site & System

wp_get_site_info
Get site configuration
wp_search
Search all content
wp_get_plugins
List installed plugins
wp_get_themes
List installed themes

API Reference

Endpoints

Endpoint Method Description
/wp-json/royal-mcp/v1/mcp POST Main MCP endpoint for messages
/wp-json/royal-mcp/v1/mcp GET MCP stream endpoint
/wp-json/royal-mcp/v1/posts GET REST endpoint for posts
/wp-json/royal-mcp/v1/pages GET REST endpoint for pages
/wp-json/royal-mcp/v1/media GET REST endpoint for media

Authentication

All API requests require authentication via the WordPress API key:

Authorization: Bearer YOUR_WORDPRESS_API_KEY

Activity Log

Royal MCP logs all API interactions for security and debugging purposes.

Accessing the Log

Navigate to Royal MCP > Activity Log in your WordPress admin.

Log Information

  • Timestamp - When the request occurred
  • MCP Server - Which AI platform made the request
  • Action - The MCP tool that was called
  • Status - Success or error
  • Request/Response - Detailed data (expandable)
Royal MCP Activity Log

Activity log showing all AI interactions with timestamps, actions, and status

Troubleshooting

Claude Desktop won't connect

Most Common Issue

Claude Desktop requires HTTPS. If your site uses HTTP or is on localhost, Claude cannot connect. Use a tool like ngrok for local development.

API key not working

  • Ensure you're using the WordPress API key, not a platform key
  • Check that the key hasn't been regenerated
  • Verify the plugin is activated and integration is enabled

Connection test fails

  • Verify the platform API key is correct
  • Check that your server can make outbound HTTPS requests
  • Some hosts block external API calls - contact your host if needed

Tools not appearing in Claude

  • Disconnect and reconnect the MCP connector in Claude Desktop
  • Ensure your site's SSL certificate is valid
  • Check the Activity Log for any error messages

Frequently Asked Questions

Is my data secure?

Yes. All API endpoints require authentication via API key. Activity logging tracks every request. No data is sent to external services without your explicit configuration. HTTPS is required for production use.

Can AI assistants modify my content?

Yes, with proper authentication. The plugin provides tools for creating, updating, and deleting content. All write operations require valid API credentials and are logged.

Does this slow down my site?

No. Royal MCP only activates when an AI platform makes an API request. It does not affect front-end performance or page load times for regular visitors.

Can I use multiple AI platforms?

Yes. You can add and configure as many AI platforms as needed. Each has independent settings and can be enabled/disabled individually.

What happens if I deactivate the plugin?

Your settings are preserved when you deactivate. AI platforms will no longer be able to access your site until you reactivate. Uninstalling completely removes all settings and logs.

Back to Support View Plugin Page