WordPress MCP

Manage WordPress sites through AI Engine's MCP Server. AI Engine is a free WordPress plugin that exposes a comprehensive MCP interface.

Setup

The user needs:

1. AI Engine plugin installed (free: https://wordpress.org/plugins/ai-engine/)
2. MCP Server enabled in AI Engine → Settings → MCP
3. A Bearer Token set in MCP settings

Connection details should be stored in the user's TOOLS.md:

## WordPress MCP
- **URL:** https://example.com/wp-json/mcp/v1/http
- **Bearer Token:** <token from AI Engine MCP settings>

How to Call MCP Tools

All calls use JSON-RPC 2.0 over HTTP POST:

curl -s -X POST <MCP_URL> \
  -H "Authorization: Bearer <TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"<tool_name>","arguments":{...}}}'

Discovery

List available tools (varies by enabled features):

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Always start with tools/list to discover what's enabled on this site.

Connectivity Check

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"mcp_ping","arguments":{}}}

MCP Features (Modular)

Tools are grouped into features that the site admin enables in AI Engine → Settings → MCP Features. Only WordPress core is enabled by default. Always use tools/list to discover what's available.

| Feature | Default | Description | |---------|---------|-------------| | WordPress | ✅ On | Posts, pages, comments, users, media, taxonomies, settings | | Plugins | Off | Install, activate, update, and modify plugins | | Themes | Off | Install, activate, switch, and customize themes | | Database | Off | Execute SQL queries on the WordPress database | | Polylang | Off | Multilingual content (requires Polylang plugin) | | WooCommerce | Off | Products, orders, customers (requires WooCommerce) | | SEO Engine | Off | SEO analysis, analytics (requires SEO Engine plugin) | | Social Engine | Off | Social media scheduling (requires Social Engine plugin) | | Dynamic REST | Off | Raw access to WordPress REST API |

See references/features.md for tool details per feature.

Common Workflows

Content Audit (WordPress + SEO Engine)

1. mwseo_get_seo_statistics — Overall site health
2. mwseo_get_posts_needing_seo — Posts with SEO problems
3. Loop: mwseo_do_seo_scan per post → fix with mwseo_set_seo_title, mwseo_set_seo_excerpt

Publish a Post (WordPress core)

1. wp_create_post with post_title, post_content, post_status: "draft"
2. Optionally set SEO metadata if SEO Engine is enabled
3. wp_update_post with post_status: "publish" when ready

Translation Workflow (Polylang)

1. pll_translation_status — See coverage gaps
2. pll_get_posts_missing_translation with target language
3. pll_create_translation — Create translated post linked to original

Multi-Site Management

Store multiple sites in TOOLS.md and select by name:

### My Blog
- **URL:** https://blog.example.com/wp-json/mcp/v1/http
- **Token:** abc123

### My Shop
- **URL:** https://shop.example.com/wp-json/mcp/v1/http
- **Token:** xyz789

Tips

• Use wp_get_post_snapshot instead of multiple calls — gets post + meta + terms in one request
• Use wp_alter_post for search-replace edits instead of re-uploading entire content
• wp_get_posts returns no full content by default — use wp_get_post for content
• Analytics date params use start_date / end_date (not camelCase)
• Always run tools/list first — available tools depend on which features the admin enabled