WordPress MCP

# 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

1. The user needs:
2. AI Engine plugin installed (free: https://wordpress.org/plugins/ai-engine/)
3. MCP Server enabled in AI Engine → Settings → MCP
4. 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:

```bash 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): ```json {"jsonrpc":"2.0","id":1,"method":"tools/list"} ```

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

Connectivity Check ```json {"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