Skip to content

Requirements

DependencyMinimum versionNotes
WordPress6.9Ships the Abilities API in core.
PHP8.08.2+ recommended.
Elementor3.20Container element support is required.

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.

If you’re on WordPress 6.8 or older, the Abilities API isn’t in core. You’d need to install it as a separate plugin (or via Composer). Easier path is to update WordPress.

DependencyWhat it adds
Elementor Proadd-pro-widget (reaches every Pro widget via the catalog), theme builder tools (8), Pro template/popup/dynamic-tag tools, Widget Builder (8), SEO & Accessibility (7), Pro custom code.
Elementor 4.0+14 atomic-element tools (flexbox, div-block, atomic widgets, global classes).
WooCommerceAdds no new tools. WC widgets are reached through add-pro-widget (catalog tier woo). Requires Elementor Pro.
Elementor Pro custom code moduleadd-custom-css, add-code-snippet, list-code-snippets.

EMCP Tools ships 267 tools in total, 209 of them on the free tier and 58 requiring Pro.

Count
Total tools267
Free tier209
Pro only58
Enabled by default136
Off until you opt in131

How many register on your site depends on what you run. The Elementor tools need Elementor, the atomic-element tools need Elementor 4.0+, and every plugin integration (ACF, WooCommerce, the 8 form builders, the 7 SEO plugins, the 3 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 131 disabled-by-default tools are the ones that write, delete, or render site-wide. Opt in from EMCP Tools → Tools.

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 (on by default); turning it off removes those 9.

After activation:

  1. Visit EMCP Tools in the WordPress admin. The Dashboard should show a non-zero “Active” stat card. If it shows zero, 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.