WP MCP
Provides shop tools for WooCommerce sites, allowing management of products, stock, coupons, and orders through the MCP server.
Enables AI-driven management of WordPress sites through a bridge plugin, covering content, pages, templates, menus, media, SEO, maintenance, plugins, users, options, REST routes, activity logs, and undo, with permission levels and confirmation safeguards.
Provides SEO capabilities for sites using Yoast SEO, including managing SEO fields and performing page audits.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
WP MCP
Let an AI run your WordPress sites, from zero to production, over MCP only. No visual editor, no plugin UI to learn: the AI gets 18 well-described tools (154 site actions) for page builders (Elementor, Bricks, Divi), custom fields (ACF, Meta Box), design, SEO, maintenance, plugins, content, shop and forms, with permission levels, two-step confirmation, undo and an activity log.
Claude.ai / Claude Code / Cursor / any MCP client
│ Streamable HTTP (stateless) · OAuth 2.1 + PKCE · API keys
▼
┌────────────────────┐ signed HTTPS (HMAC) ┌──────────────────────┐
│ WP MCP gateway │ ────────────────────────────────► │ WP MCP Bridge plugin │ site A
│ (Node/TypeScript) │ ────────────────────────────────► │ (PHP 8.1+, light) │ site B
│ tokens, levels, │ └──────────────────────┘ site C
│ rate limits, log │
└────────────────────┘Why a gateway plus a plugin
Question | Answer |
One connection for many sites? | Yes. The AI app connects once to the gateway; every tool takes a |
Connection that does not drop? | Tokens live in the gateway (SQLite), not in |
Safe by default? | Four levels ( |
Heavy on the WordPress site? | No. The plugin is one signed endpoint plus handlers; it does nothing until you pair a gateway. |
Details: docs/architecture.md.
Related MCP server: WordPress MCP Server
Version 2: build any site from zero
Upload one zip (the Host Agent, PHP 8.1+) to any hosting: cPanel, DirectAdmin, Plesk, shared or a VPS. Open it in a browser, set a username and password. From the Studio on your computer you then create sites from scratch and publish them: static, React/Vue/Svelte, Astro, Next, Node, WordPress with its database, or let the AI builder write the site while you approve each step. Every publish is a release you can roll back. Setup and security model · AI builder · releases, signed updates, test matrix · plan.
Quick start
Run the gateway (Node 22.13+; Docker also works, see docs/install.md):
cd gateway && npm ci && npm run build WPMCP_PUBLIC_URL=https://mcp.example.com npm startOpen
/admin, enter the setup token printed in the log, choose an owner password.Install the plugin on each site: zip
plugin/wp-mcp-bridge, upload it in Plugins → Add New, activate. Go to Tools → WP MCP Bridge and create a pairing code.Connect the site in the gateway admin panel (Connect a site: URL + pairing code). Give it a unique name.
Connect your AI: Claude.ai (Settings → Connectors → Add custom connector →
https://mcp.example.com/mcp) or Claude Code:claude mcp add --transport http wp https://mcp.example.com/mcpDetails and API-key setup: docs/connect.md.
The local web panel
Everything in one terminal menu: double-click wpmcp.cmd (or npm run tui; the first run installs and builds by itself): start/stop the panel, see your sites and update their bridge, connect a new site, rebuild, check everything, release tools. The same actions work as commands: wpmcp status|start|stop|restart|sites|doctor|rebuild.
Start it from wpmcp.cmd (menu: Start the panel, then Open in the browser; or node gateway/dist/index.js local): the panel opens at http://127.0.0.1:8787/admin, listening on this computer only. Persian (default) and English.
No password and no token: it only answers on this computer (loopback host, same-origin, custom header; see docs/security.md). Built with React, Tailwind and shadcn/ui, dark/light, RTL.
A site switcher sits on top; everything below works on the selected site, for ordinary users and developers alike:
Overview: health of every site, quick actions, recent activity.
Content: pages, posts and custom types: list, search, filter, edit (title, slug, status, content, categories, tags, featured image, SEO snippet with live Google-style preview and rendered preview), publish, trash. Every change shows an Undo button.
Media: grid, multi-upload, alt text and title, delete.
Shop (WooCommerce): products with inline price and stock, edit, create.
AI assistant: chat with ChatGPT (OpenAI), Claude, Gemini, OpenRouter, DeepSeek, Groq, Mistral, Grok, a free local model (Ollama) or any OpenAI-compatible URL. It uses the same tools, levels and confirmations as MCP, on the selected site, with approve/decline cards for risky steps. Keys are stored encrypted on this computer and only sent to the provider. (Remote clients such as ChatGPT connectors, Claude.ai, Cursor, Gemini CLI, Codex connect through MCP: see Connect AI.)
URL Inspector: Search-Console style inspection of any public URL (the gateway fetches it like a crawler): indexing, redirect chain, snippet previews (Google desktop/mobile, social), headings, links with broken-link check, structured data validation, images, keyword analysis, speed and technical headers, a scored list of fixes.
SEO: per-page title/description/noindex/canonical, one-click page audit with score, robots.txt, sitemap, redirects.
Design: identity, color pickers and fonts (design tokens), menu builder, header/footer templates, named CSS sections.
Maintenance: health, updates (with backup first), database backups and restore, cache, maintenance mode, database cleanup, error log.
Plugins: switch on/off, update, delete, search WordPress.org and install.
Copy between sites: wizard with progress, drafts by default.
Developer: theme file editor (syntax-checked, auto-revert), REST API explorer, and the Workbench for every raw action.
Sites, Connect AI (copy buttons for Claude Code, Claude Desktop, Cursor, remote), Access (API keys, OAuth apps), Activity.
Destructive steps open a confirmation dialog with the preview first.
First time: npm run setup (installs and builds server and panel), then wpmcp.cmd or npm run local.
What the AI can do
Tool | Covers |
| Start here: connected sites, overview of a site, who am I, schema of any action |
| Posts, pages, custom types, categories/tags, comments, revisions |
| Templates and parts (header/footer), CSS sections, design tokens, menus, homepage, branding, themes, theme files |
| Library, upload (base64 or https URL), alt text |
| Yoast / Rank Math / SEOPress / built-in fields, page audit, robots.txt, sitemap, redirects, JSON-LD |
| Real rendered HTML, element tree, stylesheets of any page |
| Health, updates, DB backup/restore, logs, caches, DB cleanup, search-replace, cron, maintenance mode |
| List, search, install, activate, deactivate, delete |
| Users and roles (admin), site options with secret redaction |
| Discover and call any REST route (WooCommerce, forms, custom) with levels derived from route and method |
| WooCommerce products/stock/coupons/orders; CF7, Gravity, WPForms, Fluent Forms |
| Browse/read/write/delete files in themes, plugins, mu-plugins, uploads, and read the WordPress core folder ( |
| Portable export/import of posts, terms, menus, media and design. |
| What happened (gateway + site), and undo by revision |
Full list: docs/TOOLS.md. The AI also receives instructions at connect time, guide resources, ready prompts (build a site, SEO audit, maintenance, publish a post, redesign a page) and can read the activity log.
Safety in one table
Risk | Defence |
A read-only key leaks private data |
|
AI deletes or installs something | Destructive actions are two-step ( |
Server-side request forgery | Gateway connects through a guarded DNS lookup (blocks private/loopback/link-local/metadata at connect time), never follows redirects. The plugin applies the same rules to downloads. |
Prompt injection from site content | Results containing site text carry a |
Rogue OAuth app | Public clients only, PKCE S256 required, redirect allow-list (https / loopback / editor schemes), consent page shows the redirect domain, registration and token endpoints are rate limited, owner can lower or revoke instantly. |
Stolen refresh token | Rotation with reuse detection: replaying an old token ends the whole chain. |
One noisy client starves the rest | Separate buckets per connection, per write, and per site. |
A bad theme edit kills the site | PHP is syntax-checked; the front page is probed afterwards and the change is auto-reverted on a server error. |
Read docs/security.md for the full model and honest limits.
Development
npm test # gateway (147 tests) + plugin checks (108) in one go
npm run docs # regenerate docs/TOOLS.md from spec/ops.jsonspec/build-spec.mjs is the single source of truth for every action (level, arguments, confirmation). scripts/sync-spec.mjs copies the generated ops.json to the gateway and the plugin (build output, not committed; only spec/ops.json is). Every build, test and package script runs it first.
Version 2 (build any site from zero, with the AI builder): the Host Agent you upload to any PHP 8.1+ hosting is described in docs/agent.md; plan and milestones: docs/roadmap.md, docs/roadmap.md#implementation-plan-and-status.
License: MIT.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Run every WordPress site you look after from Claude or ChatGPT. Nothing goes live until you approve it, every change gets a receipt you can undo, and the whole fleet sits in one tamper-evident log.
Manage your WordPress site from ChatGPT or Claude: posts, WooCommerce, SEO, images and upkeep.
Manage WordPress blogs and WooCommerce shops from Claude, ChatGPT, Cursor and other MCP apps.
Manage your WordPress site from your AI assistant: posts, pages, media, comments and WooCommerce.
Related MCP Servers
- AlicenseAqualityNot gradedmaintenanceAI-powered WordPress management that enables creating and editing posts, pages, media, plugins, themes, and Gutenberg blocks through natural language with safe-by-default writes and full rollback support.524 npm-
- AlicenseCqualityDmaintenanceEnables AI to manage WordPress sites with 190+ tools for complete control over content, themes, plugins, files, and more.100MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to manage WordPress sites via ~74 capabilities including content, media, plugins, themes, and more.-
- AlicenseNot gradedqualityDmaintenanceEnables AI clients to manage WordPress and WooCommerce sites with over 194 tools for content, users, security, performance, and e-commerce operations.ISC