Skip to main content
Glama

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 site and every result repeats the site name.

Connection that does not drop?

Tokens live in the gateway (SQLite), not in wp_options. Access tokens last 1 h, refresh tokens rotate and last 180 days, a lost refresh response is tolerated, and a site being offline never invalidates the AI's login.

Safe by default?

Four levels (read < draft < live < admin) enforced twice (gateway and plugin), per-site ceilings, two-step confirmation for destructive actions, undo for most changes, SSRF guard, untrusted-content warnings.

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

  1. 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 start

    Open /admin, enter the setup token printed in the log, choose an owner password.

  2. 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.

  3. Connect the site in the gateway admin panel (Connect a site: URL + pairing code). Give it a unique name.

  4. 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/mcp

    Details 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

site

Start here: connected sites, overview of a site, who am I, schema of any action

content

Posts, pages, custom types, categories/tags, comments, revisions

design

Templates and parts (header/footer), CSS sections, design tokens, menus, homepage, branding, themes, theme files

media

Library, upload (base64 or https URL), alt text

seo

Yoast / Rank Math / SEOPress / built-in fields, page audit, robots.txt, sitemap, redirects, JSON-LD

inspect

Real rendered HTML, element tree, stylesheets of any page

maintain

Health, updates, DB backup/restore, logs, caches, DB cleanup, search-replace, cron, maintenance mode

plugins

List, search, install, activate, deactivate, delete

users, options

Users and roles (admin), site options with secret redaction

rest

Discover and call any REST route (WooCommerce, forms, custom) with levels derived from route and method

shop, forms

WooCommerce products/stock/coupons/orders; CF7, Gravity, WPForms, Fluent Forms

files

Browse/read/write/delete files in themes, plugins, mu-plugins, uploads, and read the WordPress core folder (core; only .htaccess/robots.txt writable; wp-config.php stays closed because it holds database passwords). Admin, confirmed, PHP syntax-checked, undoable

transfer

Portable export/import of posts, terms, menus, media and design. site.transfer copies content between two connected sites inside the gateway (drafts by default, images fetched including page-builder JSON, links rewritten, resumable; also users and plugin settings for admin); site.transfer_files copies theme/plugin folders

activity

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

read sees only published, non-sensitive data. Users, orders, options, drafts, comments' emails, logs are draft/admin. Secret-looking options are never returned, even to admin.

AI deletes or installs something

Destructive actions are two-step (confirm_token bound to the exact arguments, 5 min). Permanent deletions are admin-only. Plugin install from URL: admin + confirm, https only, no redirects, no private IPs.

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 content_notice; instructions tell the AI never to obey them; HTML written at lower levels is kses-filtered.

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.json

spec/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…

    Related MCP Connectors

    Related MCP Servers