Documentation
Everything WP MCP does, and exactly how the safety net works.
WP MCP is the open-source plugin wpmcp, built on the official WordPress Abilities API. This section is for developers, agencies, and anyone connecting an AI client over MCP. Each chapter below has its own page.
Connecting a client? Step-by-step guides:Claude and WordPress,Claude Code and WordPress,Cursor and WordPress,ChatGPT and WordPress. The connecting clients chapter compares them.
Introduction
wpmcp is a WordPress plugin that turns a site into an MCP (Model Context Protocol) server. It lets an AI agent, Claude, Cursor, or any other MCP-compatible client, read and edit a WordPress site directly: create and update posts and pages, manage media,...
Getting Started
wpmcp is distributed from GitHub releases, not from the WordPress.org plugin directory.
Connecting an MCP Client
wpmcp exposes its tools over the Model Context Protocol via the official WordPress Abilities API. Every ability wpmcp registers requires a caller to be authenticated as a WordPress user who can editposts, so the first step is deciding how the client signs...
The Safety Model
This is the part of wpmcp that the rest of the product exists to support. Every tool that mutates existing data routes through a single orchestrator, SafeMutation::run(). No exceptions, and this is enforced in code: a tool cannot write to a post or option...
Tools Reference
WP MCP currently registers 407 abilities in the canonical test environment: 274 free and 133 Pro. Every tool below is registered as a WordPress ability named wpmcp/<tool-name> via the official Abilities API, each with its own permissioncallback (content...
Tools Reference, part 2
Tools from Elementor deep editing (33 tools, 33 Pro) to Cron (4 tools).
- Elementor deep editing (33 tools, 33 Pro)
- Elementor structural suite (8 tools, 8 Pro)
- Elementor v4 atomic elements (4 tools, 4 Pro)
- Elementor global classes (4 tools, 4 Pro)
- Elementor global variables (4 tools, 4 Pro)
- Brand kits (4 tools, 4 Pro)
- Custom widget builder (9 tools, 9 Pro)
- Page builders: Bricks, Divi, WPBakery, Beaver Builder, Breakdance, Oxygen, Avada, Thrive (3 tools, 3 Pro)
Tools Reference, part 3
Tools from Maintenance mode (3 tools) to Site Template (2 tools).
Free vs Pro
<!-- Ability counts come from tests/support/ability-manifest.php in the plugin (wpmcp 0.9.1) and mirror src/consts.ts on this site; update both together. --> The plugin registers 407 abilities: 274 free and 133 Pro. Everything is GPL-2.0 licensed either...
WooCommerce Tools
wpmcp treats a WooCommerce store as a first-class surface, not an afterthought bolted onto the content tools. An AI agent can read products, orders, and sales data, and make the day-to-day changes a shop owner actually asks for: updating a price, marking...
Contributing and Tests
The suite needs a MySQL or MariaDB database for the WordPress integration harness (tests/bootstrap.php sets it up via the standard WordPress PHPUnit scaffolding). CI installs it with bin/install-wp-tests.sh wordpresstest root root 127.0.0.1 6.9 against a...