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
- Log into wp-admin.
- Go to Plugins.
- 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