WP MCP Control — MCP Server

TypeScript MCP server that connects Cursor, Claude Desktop, and other MCP clients to the WP MCP Control WordPress plugin.

Quick Install (new computer)

git clone https://github.com/mpierre135/wp-mcp-control-server.git
cd wp-mcp-control-server
npm install
npm run build
cp .env.example .env
# Edit .env with your site URL and token

Then add to Claude Desktop or Cursor (see below).

Related MCP server: TanukiMCP

Setup

npm install
cp .env.example .env
# Edit .env with your credentials
npm run build
npm start

Environment Variables

Claude Desktop Config

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "wp-mcp-control": {
      "command": "node",
      "args": ["/absolute/path/to/wp-mcp-control-server/dist/index.js"],
      "env": {
        "WP_MCP_SITE_URL": "https://example.com",
        "WP_MCP_TOKEN": "your-token",
        "WP_MCP_SAFE_MODE": "true",
        "WP_MCP_DRY_RUN": "false"
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor Config

{
  "mcpServers": {
    "wp-mcp-control": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/dist/index.js"],
      "env": {
        "WP_MCP_SITE_URL": "https://example.com",
        "WP_MCP_TOKEN": "your-token",
        "WP_MCP_SAFE_MODE": "true",
        "WP_MCP_DRY_RUN": "false"
      }
    }
  }
}

Development

npm run dev    # Watch mode
npm run build  # Compile to dist/

Tool Catalog

Site

• wp_health_check — Health and status

• wp_get_site_info — Site metadata

• wp_list_themes / wp_list_plugins — Read-only inventory

• wp_get_settings / wp_update_settings — Safe settings

Pages

• wp_list_pages, wp_get_page, wp_create_page, wp_update_page, wp_delete_page

• wp_create_landing_page — Structured landing page builder

Posts

• wp_list_posts, wp_get_post, wp_create_post, wp_update_post, wp_delete_post

Media

• wp_list_media, wp_get_media

• wp_upload_media_from_url, wp_upload_media_from_base64

• wp_update_media_metadata, wp_delete_media

Taxonomies

• wp_list_categories, wp_create_category, wp_update_category, wp_delete_category

• wp_list_tags, wp_create_tag, wp_update_tag, wp_delete_tag

Menus

• wp_list_menus, wp_get_menu_items

• wp_create_menu_item, wp_update_menu_item, wp_delete_menu_item

• wp_assign_menu_location

Other

• wp_search_content — Unified search

• wp_batch_operations — Batch API calls

• wp_get_activity_log, wp_restore_snapshot

• wp_list_redirects, wp_create_redirect, wp_update_redirect, wp_delete_redirect

• wp_export_site_structure, wp_generate_sitemap

Elementor (Phase 1–3)

• wp_elementor_get_widget_catalog — Widget catalog with editable settings

• wp_elementor_get_structure — Full Elementor element tree

• wp_elementor_list_elements — Flat list of widgets with text previews

• wp_elementor_find_widgets — Filter by widget_type

• wp_elementor_update_element — Update catalog-editable widget by element ID

• wp_elementor_update_text — Find widget by text and replace

• wp_elementor_update_button — Update button text/URL by match_text

• wp_elementor_update_image — Update image by element_id or match_url

• wp_elementor_insert_widget — Add widget to column/container

• wp_elementor_insert_section — Add section (hero/cta/features presets)

• wp_elementor_remove_element — Delete element by ID

• wp_elementor_clone_element — Clone subtree with new IDs

• wp_elementor_duplicate_page — Clone Elementor page as draft

Headers Sent to WordPress

Every request includes:

• Authorization: Bearer <token>

• X-WP-MCP-Dry-Run: true|false

• X-WP-MCP-Safe-Mode: true|false

These override plugin defaults when set in MCP env vars.