What is WPMCP?
WPMCP is an MIT licensed MCP server for WordPress by RaheesAhmed, published as the wpmcp package. It pairs a Node.js server with a required WordPress plugin, and covers content, theme and plugin files, menus, WooCommerce, SEO and more, with automatic backups before file changes.
WPMCP is a Node.js MCP server aimed at full WordPress control through natural language. The README headline says 190+ tools, while its tools table lists 22 categories and a separate tools document counts 130, so treat the exact total as approximate.
It needs two parts: the server your client runs, and a WordPress plugin installed on the site. The plugin enables file system operations, shortcode execution and cron management.
What it covers
- Content: posts, pages, media, users, categories, tags and comments.
- Themes and plugins: activate, create child themes, read and write files, edit theme.json.
- Menus, widgets, shortcodes and cron jobs.
- WooCommerce, Gutenberg blocks, SEO, security checks, performance and backups.
Who it is for
Best for
- Developers who want an agent to read and edit theme and plugin files on a development site.
- Users who prefer one broad server over several narrow ones.
Not for
- Production sites without a staging copy. The server can write files and run database operations.
- Anyone who wants the narrowest permission set. The README pitches complete control rather than minimal access.
File safety
The README lists guardrails for file work: only theme, plugin and upload directories, safe extensions, malware pattern detection, PHP syntax validation, automatic backups and a 10MB size limit.
Use it with UiChemy
WPMCP edits code and settings by command. For visual building, see AI website builders for WordPress, and compare a narrower option in Novamira. Click Get Started on uichemy.com.
Connect WPMCP: A WordPress MCP Server With File Access to your AI client
npm i -g [email protected]Install the package
Run the npm command above, or let the client launch it with npx.
Add the config
Paste the JSON into your MCP client and set the site URL, username and application password.
Install the WordPress plugin
The README says the plugin is required. Upload wpmcp-plugin/wpmcp.zip and activate it in the Plugins screen. The user needs edit_themes and edit_plugins capabilities.
Try a prompt
The README suggests prompts such as creating a child theme, activating a plugin or reading a theme stylesheet.
Client configuration
{
"mcpServers": {
"wordpress": {
"command": "npx",
"args": ["-y", "[email protected]"],
"env": {
"WORDPRESS_URL": "https://your-site.com",
"WORDPRESS_USERNAME": "admin",
"WORDPRESS_PASSWORD": "your-app-password"
}
}
}
}Endpoints and ports
https://your-site.comYour site addressadminWordPress useryour-app-passwordApplication PasswordWhat you can do with it
- Theme customizationCreate child themes, change styles and read functions.php through prompts.
- Plugin controlActivate, deactivate and inspect installed plugins.
- Block editor supportBlock types, patterns, reusable blocks and templates.
- Backups and migrationFull or partial backups, restore, export, import and cloning are listed.
- SEO toolsSitemaps, redirects, schema markup and Open Graph are listed in the capabilities.
- Role managementCustom roles and capabilities.
Tools it exposes
Posts
15 tools to create, update, delete, search, schedule, publish and duplicate.
File System
8 tools to read, write, delete, copy and move files.
Theme Manager
13 tools covering activation, child themes, theme.json and templates.
Plugin Manager
10 tools to activate, deactivate and read or write plugin files.
Menu Manager
8 tools to create menus, add items and assign locations.
WooCommerce
15 tools for products, orders, customers, inventory and coupons.
Frequently asked questions
What is WPMCP?
WPMCP is an open source MCP server for WordPress that lets an AI client manage content, themes, plugins, menus, WooCommerce and files in natural language. It needs a companion WordPress plugin for file and cron features.
How do I install WPMCP?
Install the wpmcp package with npm or run it through npx in your MCP client config, set the site URL, username and application password, then upload and activate the companion plugin zip from the repository on your site.
How many tools does WPMCP have?
The README gives two figures. The header says 190+ tools, and the tools section says 130+ with a table of 22 categories. Check the tools document in the repository for the current list.
Is the WordPress plugin required?
Yes. The README marks the plugin as required, and says it enables file system operations, shortcode execution, cron job management and the advanced features. The user also needs the edit_themes and edit_plugins capabilities.
Is it safe to let an agent edit theme files?
The README lists protections such as allowed directories, safe extensions, PHP syntax validation, automatic backups and a 10MB limit. Even so, use a staging site, because the server can write files and run database queries.
Does WPMCP work with Cursor and other clients?
The README says it connects to Claude, Cline or any MCP compatible AI and gives a config for Claude Desktop and Cline style clients. For other clients, use their standard stdio server config with the same variables.
Which license does WPMCP use?
The repository and the npm badge in the README list the MIT license. The README also contains a donation request, which is a project funding note and does not change how you can use the code under that license.
What are alternatives to WPMCP?
For a REST only setup see InstaWP mcp-wp, for block level edits see GoBuildWP, and for abilities based plugins that ship ready made tool sets see WP MCP Ultimate. Pick by how much file and database access you are comfortable granting.


