Skip to content

WordPress MCP Plugin Requirements

DependencyMinimum versionNotes
WordPress6.9Includes the Abilities API.
PHP8.1Required 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.

DependencyWhat it adds
Elementor 3.20+Elementor widgets, containers and page tools.
Elementor ProIts 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.
WooCommerceStore operations through woo-read and woo-write with EMCP Pro. Elementor WooCommerce widgets have their own plugin requirements.
Other builders, block packs and pluginsTheir corresponding integration tools. Check the integration catalog for supported versions and tier access.

EMCP Tools ships 526 tools in total, 231 of them on the free tier and 295 requiring Pro.

Count
Total tools526
Free tier231
Pro only295
Enabled by default149
Off until you opt in377

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.

After activation:

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

  2. 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 initialize response 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.