License Activation and Renewals
Royal MCP Pro-specific licensing details — menu path, verify command, exact option/transient names, and what an expired license looks like to your MCP client.
The complete license lifecycle documentation (activation, deactivation, renewal, expiration behavior, 24-hour cache, force-refresh, refunds, multisite) is centralized at Licensing → License Activation and Renewals →. This page adds only the Royal MCP Pro-specific pieces that don't apply to other plugins.
Royal MCP Pro-specific details
Menu path
License management lives at wp-admin → Royal MCP Pro → License. The menu path is fixed — not under a Settings submenu.
Verify Pro is active from your MCP client
After activation, call royal_mcp_connection_health from any MCP client (Claude, ChatGPT, Cursor, etc.). The response includes a pro_licensed boolean:
{
"pro_licensed": true,
...
}This is the fastest way to confirm the seat has been claimed successfully. It also works after a license move to confirm the new site is licensed.
Exact local option and transient names (for WP-CLI / debugging)
Royal MCP Pro stores its license state at:
- Option:
wpgenius_license_royal-mcp-pro - Transient:
wpgenius_license_royal-mcp-pro_valid
To force a fresh license check via WP-CLI (bypassing the 24-hour cache):
wp transient delete wpgenius_license_royal-mcp-pro_validThe next Pro tool call re-validates against the licensing server. See Force a fresh check in the centralized guide for the UI-only alternative.
Tiers & pricing
Royal MCP Pro is offered in tiers scoped to seat count, with Agency and above targeted at portfolio and bulk workflows. Current tiers and pricing live on the Royal MCP Pro pricing page.
Above the largest self-serve tier is Enterprise territory — contact us for a partnership conversation.
What an expired Royal MCP Pro license looks like to MCP clients
General expired-license behavior is covered in the centralized guide. What's specific to Royal MCP Pro is how the state surfaces through MCP tool responses.
Pro tool calls return a service message
Any Pro-tier tool call on an expired license returns a service response like this (as seen in any MCP client):
⚠️ This tool did NOT execute. Royal MCP Pro license expired.
Renew to run divi_clone_page: https://my.royalplugins.com/account/The response deliberately leads with "did NOT execute" so your AI doesn't misclassify the pitch as a successful tool call.
Undo redemption is also gated
The royal_mcp_undo_last_operation tool is a Pro tool, so it's also gated on an expired license. If you have pending undo tokens from before expiration and want to reverse an operation, renew the license first. The undo token's TTL keeps counting down while the license is expired — renew before the token's window closes if you want the option. See Undo Tokens & Reversibility.
The diagnostics tool stays callable
One tool stays callable regardless of license state: royal_mcp_pro_diagnostics. It's on the unlicensed-callable allowlist specifically so you (or your AI) can inspect plugin state during a licensing issue. See Diagnostics tool for what it returns.
What Pro data persists on the deactivated site
- All Free-tier tools continue to work exactly as before.
- Audit Log rows stay in the database.
- Endpoint Profiles configuration stays.
- Undo store table stays (tokens remain visible in the Audit Log even after they've become unredeemable).
- Pro-tier settings stay.
Nothing gets deleted on deactivation or expiration. Re-activating a license on the site brings all Pro features back exactly as they were.
Still Stuck? Two-Step Support Path
If licensing or activation isn't working, work through these two steps in order.
Step 1: Start with the diagnostic docs
For license-specific issues, see:
- License activation fails — Royal MCP Pro's activation-issue diagnostic tree covering DNS, outbound-HTTPS blocks, firewalls, license-server reachability, and seat conflicts
- Pro tool returned upgrade prompt with valid license — license-server sync issues, object cache, tier-check middleware
If the issue is that Claude can't connect at all (before Pro even enters the picture), start with Royal MCP Troubleshooting — Start Here instead.
Step 2: Email priority support
If you've worked through the relevant doc and the issue still isn't resolved, email priority support from your purchase email address at support@royalplugins.com. Priority email support is included with your license — typical response within 24 hours. Never include your license key in email; we look it up from your purchase address.
- Output of
royal_mcp_pro_diagnostics(withinclude_audit_tail=true) — captures every environmental detail we'd otherwise need to ask for - Your hosting provider (SiteGround, Cloudways, Hostinger, Kinsta, WP Engine, Liquid Web, self-hosted VPS, etc.)
- Active caching plugins (LiteSpeed Cache, WP Rocket, W3 Total Cache, none)
- Active security plugins (Wordfence, Defender Pro, Solid Security, NinjaFirewall, none)
- Cloudflare or CDN in front of the site? If yes, is "Manage AI Bots" or "Bot Fight Mode" on?
- The exact error message from the License page (or from a Pro tool call if that's where the issue surfaces)
- Screenshot of the License page in wp-admin showing the status and any error message