Cowboy MCP — WordPress MCP server: what it does, how to install
A WordPress plugin that turns any site into an MCP server with 203 tools, per-change undo and an audit log. Free, direct connection, no relay.
Open on GitHubWhat Cowboy MCP does
Cowboy MCP installs on any WordPress 6.2+ site with PHP 8.0+ and gives the agent access to content, Gutenberg blocks, WooCommerce, users, media, menus, plugins, themes, files in wp-content, the database and WP-CLI. Every change is saved in an undo journal with before-state snapshots; plugin and theme updates take a file backup and a database checkpoint automatically.
The client connects directly to the wp-json/cowboy-mcp/v1/endpoint on your site — no relay, no account. Safe mode asks for confirmation before destructive tools run, every write tool supports dry run, credentials can be scoped to read-only or a custom list of tools.
GPL-licensed, all tools are free. Integrations with Yoast, Rank Math, AIOSEO, SEOPress, The Events Calendar, ACF, Elementor, Beaver Builder, SiteOrigin, Wordfence, WP Rocket, LiteSpeed Cache, W3 Total Cache appear only when the respective plugin is active.
What it helps with
- edit WordPress pages through Claude Code or Cursor
- roll back a mistaken content or settings change
- update a plugin with automatic backup and rollback on failure
- manage WooCommerce products and orders from an agent
- check the audit log of all agent actions on the site
Example prompts for the agent
- Publish the draft post titled New Collection, add an image from the media library and fill the alt text.
- Show the last 10 entries in the undo journal, then roll back change ID 42.
- Create a database checkpoint before updating the theme.
How to install Cowboy MCP
1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
claude mcp add --transport http cowboy-mcp https://{site_host}/wp-json/cowboy-mcp/v1/endpoint1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
codex mcp add cowboy-mcp --url https://{site_host}/wp-json/cowboy-mcp/v1/endpoint1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"mcpServers": {
"cowboy-mcp": {
"url": "https://{site_host}/wp-json/cowboy-mcp/v1/endpoint"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Config file
{
"servers": {
"cowboy-mcp": {
"type": "http",
"url": "https://{site_host}/wp-json/cowboy-mcp/v1/endpoint"
}
}
}1Template address
The server address is a template: replace {…} or […] with your own values
2Platform CLI: remote server
gemini mcp add -t http cowboy-mcp https://{site_host}/wp-json/cowboy-mcp/v1/endpointStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Cowboy MCP
How do I install Cowboy MCP in Claude Code?
Install the plugin on your WordPress site through the WordPress.org directory, then run claude mcp add --transport http cowboy-mcp https://{site_host}/wp-json/cowboy-mcp/v1/endpoint, replacing the site host. Sign in through your browser.
What does Cowboy MCP do?
It turns a WordPress site into an MCP server so the agent can edit content, manage plugins and themes, work with the database and files. Every change can be undone; updates take a backup automatically.
Does it require an account or a relay?
No. The agent connects directly to the endpoint on your site, with no intermediary service and no third-party account.
