Skip to content

Requirements

DependencyMinimum versionNotes
WordPress6.9Ships the Abilities API in core.
PHP8.08.2+ recommended.
Elementor3.20Container element support is required.
WordPress MCP Adapterlatestgithub.com/WordPress/mcp-adapter

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 207 tools in total, 162 of them on the free tier and 45 requiring Pro.

Count
Total tools207
Free tier162
Pro only45
Enabled by default109
Off until you opt in98

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 98 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 8.

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 the MCP Adapter isn’t installed. If you get a 401, the application password is wrong.