What is Shim MCP?
Shim MCP is a WordPress plugin that turns a site into an MCP server with 57 abilities covering posts, media, users, plugins, menus, widgets, comments, options and system tasks. It runs locally over stdio through WP-CLI or remotely over Streamable HTTP, needs WordPress 6.9, and is GPL-2.0-or-later.
Shim MCP is a WordPress plugin that acts as a thin adapter between the WordPress Abilities API and MCP clients. Install it and the site can be driven by a client that speaks MCP, with no companion plugin or account.
The README is explicit about scope. It is not an AI product, bundles no chatbot or credits system, and does not phone home. Its job is translation between WordPress abilities and the MCP protocol.
What an agent can do with it
- Use 57 abilities across content, media, users, plugins, menus, widgets, comments, options and system management.
- Install plugins from the WordPress.org directory by slug, and list, activate, deactivate or delete installed ones.
- Reach abilities that other plugins register, because everything goes through wp_register_ability.
- Connect locally with one command, or remotely with an application password and a config snippet from the dashboard.
Who it is for
Best for
- Developers who keep a local WordPress install and want an agent to work on it like the rest of their codebase.
- Teams that want no relay, no telemetry and no vendor account between the site and the client. Compare LocalWP agent tools for local sites.
Not for
- Sites below WordPress 6.9, since the Abilities API ships in core from that version.
- Anyone who wants the agent to run arbitrary WP-CLI commands. The README says Shim never runs WP-CLI commands for the AI.
Honest limits
The README says the plugin is feature complete but has not yet run across a broad range of hosting environments. Rewriting wp-config.php stays disabled unless you define a constant to allow it, which is a deliberate safety choice.
Use it with UiChemy
Shim MCP manages the site itself. For layouts, UiChemy Composer writes HTML, CSS and JS for WordPress, and WP MCP Ultimate is the plugin Shim credits as part of its starting code. Click Get Started on uichemy.com.
Connect Shim MCP: A Self-Contained WordPress MCP Server Plugin to your AI client
git clone https://github.com/justadityaraj/shim-mcp.git wp-content/plugins/shim-mcp && wp plugin activate shim-mcpCheck requirements
The README lists WordPress 6.9 or higher, PHP 8.0 or higher, and WP-CLI for the stdio transport only.
Install the plugin
Search Shim MCP under Plugins, Add New, or clone the repository into a folder named exactly shim-mcp and activate it.
Local stdio
Run wp shim-mcp serve with a user, then register that command in your MCP client. No port, token or password is involved.
Remote HTTP
Open Tools, Shim MCP in wp-admin, generate an application password and copy the config snippet it shows into your client.
Test a read
Ask for the plugin list first and confirm the result before enabling writes for a real site.
Client configuration
claude mcp add shim-mcp -- wp shim-mcp serve --user=admin --path=/path/to/wordpressEndpoints and ports
--server=<server-id> --user=<id|login|email>Runs the MCP server over stdio--format=<format>Lists registered MCP serversdefine( true )Opt in constant that enables the wp-config.php write abilityWhat you can do with it
- Stdio through WP-CLIwp shim-mcp serve runs a local process that speaks JSON-RPC on STDIN and STDOUT, so no HTTP layer is needed.
- Streamable HTTPRemote sites connect with an application password generated from the Tools page.
- Per-object permissionsAbilities re-check edit_post, delete_post, edit_user and similar capabilities against the specific object.
- Protocol negotiationIt supports MCP versions 2024-11-05, 2025-03-26 and 2025-06-18 with automatic negotiation.
- Config exportThe dashboard shows ready made config snippets for several MCP clients.
- Conflict detectionIt detects other MCP server plugins and warns when two would compete.
- Tested in CISmoke tests run on WordPress 6.9, the latest WordPress and a multisite network.
Tools it exposes
Content abilities
Posts, pages and media.
User and comment abilities
Users and comment moderation, with per-object capability checks.
Plugin abilities
List, activate, deactivate and delete plugins, and install from WordPress.org by slug.
Menu and widget abilities
Navigation menus and widgets.
Option and system abilities
Site options and system management.
Abilities from other plugins
Any ability another plugin registers is exposed automatically.
Frequently asked questions
What is Shim MCP?
Shim MCP is a WordPress plugin that makes a site an MCP server. It registers 57 abilities through the WordPress Abilities API and serves them over local stdio with WP-CLI or remote Streamable HTTP, so MCP clients can manage content, media, users, plugins and options.
How do I install Shim MCP?
Install it from Plugins, Add New by searching Shim MCP, or clone the repository into wp-content/plugins/shim-mcp and run wp plugin activate shim-mcp. Then run wp shim-mcp serve for local use or create an application password on the Tools page for HTTP.
Does Shim MCP need WP-CLI?
Only for the local stdio transport, where WP-CLI starts the MCP server process. The remote HTTP transport does not need it. The README adds that Shim uses WP-CLI only to start itself and never runs WP-CLI commands for the AI.
Which WordPress version does Shim MCP need?
WordPress 6.9 or higher, because the Abilities API that Shim builds on ships in core from that release, and PHP 8.0 or higher. The README says the plugin gets smaller as core takes over more of the Abilities API.
Is Shim MCP safe for production sites?
Each ability checks a capability, and object level abilities check the specific object. Rewriting wp-config.php is off unless you opt in. The README also says it has not yet run across a broad range of hosts, so stage first and use HTTPS for remote use.
Can Shim MCP work with Claude Code or Cursor?
The README gives a claude mcp add command for Claude Code and says Claude Desktop and Cursor need slightly different commands, with a tested setup in its docs. Windsurf and Cline are named as compatible MCP clients.
How is Shim MCP different from other WordPress MCP plugins?
It is self-contained with no cloud relay or account, uses stdio locally with no port or token, and exposes 57 documented abilities rather than chasing the biggest tool count. See also InstaWP MCP for a hosted-site route.
Does Shim MCP cost anything?
The README states the GPL-2.0-or-later licence and lists no paid tier, account or credits system. You pay only for your own WordPress hosting and for whichever AI client you connect.


