WordPress MCP Plugin Requirements
Required
Section titled “Required”| Dependency | Minimum version | Notes |
|---|---|---|
| WordPress | 6.9 | Includes the Abilities API. |
| PHP | 8.1 | Required by the plugin and its bundled dependencies. |
Elementor is optional. Install Elementor 3.20+ for its page-building tools, or use general WordPress tools and the integrations supported by your installed plugins and themes.
The WordPress MCP Adapter is bundled with the plugin: you do not need to install or activate it separately. It ships as a committed Composer dependency loaded via the Jetpack Autoloader, which also arbitrates the highest version process-wide when another active plugin (WooCommerce, Automattic MCP, …) bundles its own copy, so there’s never a “class already declared” clash.
Update older WordPress installations to the supported minimum before activating EMCP. Installing the Abilities API separately does not change the plugin’s minimum WordPress requirement.
Optional (unlocks more tools)
Section titled “Optional (unlocks more tools)”| Dependency | What it adds |
|---|---|
| Elementor 3.20+ | Elementor widgets, containers and page tools. |
| Elementor Pro | Its licensed widgets and supported Elementor Pro features when active. EMCP Pro is a separate license. |
| Elementor 4.0+ | Supported atomic elements and Global Classes; availability depends on the installed version. |
| WooCommerce | Store operations through woo-read and woo-write with EMCP Pro. Elementor WooCommerce widgets have their own plugin requirements. |
| Other builders, block packs and plugins | Their corresponding integration tools. Check the integration catalog for supported versions and tier access. |
Tool counts by environment
Section titled “Tool counts by environment”EMCP Tools ships 526 tools in total, 231 of them on the free tier and 295 requiring Pro.
| Count | |
|---|---|
| Total tools | 526 |
| Free tier | 231 |
| Pro only | 295 |
| Enabled by default | 149 |
| Off until you opt in | 377 |
How many register on your site depends on what you run. The Elementor tools need Elementor, active and selected as the standalone builder on EMCP Tools → Page Builders; the atomic-element tools need Elementor 4.0+; and every plugin integration (ACF, WooCommerce, forms, SEO plugins and Elementor addon packs) registers only when that plugin is active. A site running Elementor Pro and two of those plugins sees far fewer tools than the total, which is the intended behaviour: you get tools for what you actually use and nothing else.
The 377 disabled-by-default tools are the ones that write, delete, or render site-wide. Opt in from EMCP Tools → Tools: switch the tool on and choose Save changes in the save bar.
Each total includes the 3 surfaced read-only core/* context abilities. Compact tool mode collapses the whole surface to 3 dispatcher tools for clients with strict tool caps. See Compact tool mode. The EMCP Themer tools require the Themer module, which is off by default on new installs from 3.18.0 (sites that already had it on keep it). Switch it on under EMCP Tools → Modules to add those 9 tools.
Sanity check
Section titled “Sanity check”After activation:
-
Visit EMCP Tools in the WordPress admin. The top bar should show Server online, and the Dashboard’s health strip should read MCP server online / Abilities API enabled with a non-zero N of M tools. If the server is off, or no tools are enabled, check the troubleshooting guide.
-
Test the REST endpoint with
curl:Terminal window curl -X POST https://your-site.test/wp-json/mcp/emcp-tools-server \-H "Content-Type: application/json" \-u "username:application-password" \-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'You should get back an
initializeresponse with a session ID. If you get a 404, the plugin isn’t active (or its REST route didn’t register). If you get a 401, the application password is wrong.
