Get the plugin

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

Read the Introduction chapter

Getting Started

wpmcp is distributed from GitHub releases, not from the WordPress.org plugin directory.

Read the Getting Started chapter

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

Read the Connecting an MCP Client chapter

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

Read the The Safety Model chapter

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

Read the Tools Reference chapter

Tools Reference, part 2

Tools from Elementor deep editing (33 tools, 33 Pro) to Cron (4 tools).

Read the Tools Reference, part 2 chapter

Tools Reference, part 3

Tools from Maintenance mode (3 tools) to Site Template (2 tools).

Read the Tools Reference, part 3 chapter

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

Read the Free vs Pro chapter

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

Read the WooCommerce Tools chapter

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

Read the Contributing and Tests chapter