Get the plugin
WP MCP/Documentation/Getting Started

Getting Started

Requirements

Dependency Version
WordPress >= 6.9 (this version bundles the Abilities API that wpmcp registers its tools on)
PHP >= 8.1
Composer needed to install from source
MySQL / MariaDB whatever your WordPress install already uses

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

Install the release zip

Download free from GitHub Star on GitHub

Download wpmcp.zip from the latest release (or use the direct link https://github.com/wpmcp/wordpress-mcp/releases/latest/download/wpmcp.zip), then upload it in wp-admin under Plugins > Add New > Upload Plugin. With WP-CLI:

wp plugin install https://github.com/wpmcp/wordpress-mcp/releases/latest/download/wpmcp.zip --activate

Install from source

If you would rather run from a checkout, clone the plugin directly into your wp-content/plugins directory and install its dependencies:

git clone https://github.com/wpmcp/wordpress-mcp.git wp-content/plugins/wpmcp
cd wp-content/plugins/wpmcp
composer install --no-dev

--no-dev skips the PHPUnit/test tooling, which you do not need on a production or staging install. If you plan to contribute to the plugin itself, see Contributing and tests for the full dev setup instead.

Activate the plugin

  1. Log into wp-admin.
  2. Go to Plugins.
  3. Find wpmcp and click Activate.

On activation, wpmcp creates its snapshot storage table (wp_wpmcp_snapshots) and registers a wpmcp top-level admin menu item. That screen lists recent agent operations and lets a human restore any of them with one click, the same rollback mechanism the MCP tools use, just exposed to a person instead of an agent.

What activation does not do

Activating the plugin does not, by itself, expose write access to the outside world. An MCP client still needs valid WordPress credentials (an OAuth 2.1 grant approved by a signed-in user, or an Application Password) to call any tool, and every ability is capability-checked against edit_posts before it runs. See Connecting clients for how to actually wire up an AI agent.

Next steps

  • Connecting clients: sign a client in over OAuth 2.1, or generate an Application Password, and point it at your site.
  • The safety model: understand what happens before and after every write.

Previous: IntroductionNext: Connecting an MCP ClientAll documentation