What is Cowboy MCP?
Cowboy MCP is a free GPL plugin that turns a WordPress site into a Streamable HTTP MCP server. It offers up to 203 built-in tools, runs inside your own install with no hosted relay, and adds an undo journal, database checkpoints and an audit log for safer edits.
Cowboy MCP is a WordPress plugin that exposes your site as a Model Context Protocol server over Streamable HTTP. The README lists 203 tools across content, the block editor, WooCommerce, users, plugins, themes, files, database, diagnostics and SEO.
The endpoint runs inside your WordPress install. The README says there is no hosted relay, no account and no telemetry, and that every tool is free with no Pro tier.
What makes it different
- A per-change undo journal with before-state snapshots and batch undo.
- Database checkpoints, taken automatically before plugin and theme updates.
- An always-on audit log of tool calls, errors and sign-in events.
- Safe mode, dry run on write tools and scoped credentials: full, read-only, drafts only or custom.
Who it is for
Best for
- Site owners who want an AI client to edit a live site while keeping a way back.
- Agencies that need read-only or drafts-only access for some connections.
Not for
- Checkpoints restore database tables, not uploaded files or code, so they are not a full backup.
- Sites without HTTPS that want cloud clients, since the README requires HTTPS for the browser sign-in and those apps.
Use it with UiChemy
Cowboy MCP edits content and settings on a site you already have. To produce the design itself, see AI website builders for WordPress, and for another plugin server read Respira. Click Get Started on uichemy.com.
Connect Cowboy MCP: A WordPress MCP Plugin With Undo to your AI client
claude mcp add --transport http your-site https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint --header "Authorization: Bearer YOUR_API_KEY"Install the plugin
In Plugins, then Add New, search for Cowboy MCP, install and activate. It needs WordPress 6.2 or later and PHP 8.0 or later.
Generate an API key
Open Settings, then Cowboy MCP, and generate a key. It is shown once and stored hashed.
Connect a client
Use the Connections tab. Several apps sign in through a consent screen on your site, while terminal clients take a command and Cursor or Windsurf take the JSON config.
Test the connection
The README gives a curl smoke test, and a Connection Doctor self-test checks HTTPS, REST and host blockers.
Client configuration
{
"mcpServers": {
"your-site": {
"url": "https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Endpoints and ports
https://yoursite.com/wp-json/cowboy-mcp/v1/endpointJSON-RPC 2.0 over Streamable HTTPX-Cowboy-MCP-KeyFor hosts that strip the Authorization headerWhat you can do with it
- Undo journalBefore-state snapshots for posts, options, users, media, menus, terms, comments and more, with conflict detection.
- Database checkpointsPrefix-scoped dumps with atomic restore, up to five kept.
- Two gateway toolstools/list returns two tools so the agent loads the rest on demand instead of 203 schemas.
- Scoped credentialsKeys and sign-ins carry full, read-only or custom tool lists.
- Safe mode and dry runDestructive tools need confirmation, and write tools accept a dry run.
- IntegrationsRegisters tools for WooCommerce, ACF, Elementor, Wordfence and SEO plugins when those are active.
- Audit logRecords every tool call and auth event, pruned after 30 days.
Tools it exposes
cowboy_discover
Gateway tool that lets the agent find the other tools on demand.
cowboy_run
Gateway tool that runs a discovered tool.
wp_site_info
Returns site information, used in the README smoke test.
wp_list_changes
Lists journaled changes.
wp_undo_change
Undoes a journaled change.
wp_connection_doctor
Runs the connection self-test.
Frequently asked questions
What is Cowboy MCP?
Cowboy MCP is a free WordPress plugin that makes a site an MCP server over Streamable HTTP. An AI client manages content, plugins, themes and more through up to 203 tools, with undo and an audit log.
How do I install Cowboy MCP?
Install it from Plugins, Add New, or from WordPress.org, then activate it. Generate an API key under Settings, Cowboy MCP, and connect your client from the Connections tab. WordPress 6.2 and PHP 8.0 are the minimums.
Does Cowboy MCP work with Cursor, Codex and ChatGPT?
The README lists Claude, ChatGPT, Gemini, Grok, Perplexity, Cursor, VS Code, Claude Code, Codex and n8n, among others. Windsurf, Cline and Zed connect with a scoped API key and a config block.
Is Cowboy MCP really free?
The README says every tool is free, GPL licensed, with no Pro tier, credits or usage meter. It is distributed through WordPress.org, and updates arrive through the normal WordPress updates screen.
Can I undo what the AI changed?
Yes for journaled changes. The undo journal keeps before-state snapshots for 7 days by default, and database checkpoints restore tables. The README notes checkpoints do not restore uploaded files or code.
How does it keep a live site safe?
Safe mode asks for confirmation on destructive tools, write tools accept a dry run, credentials can be read-only, and denylists cover sensitive options and dangerous SQL. A Power mode can only be enabled by a human in wp-admin.
Can it run on a local site?
Yes. Terminal tools connect with a key as on a live site, and Claude Desktop connects through an mcp-remote bridge that the Connections tab generates. Cloud clients need a public HTTPS site.
What are alternatives to Cowboy MCP?
For REST based content work see InstaWP mcp-wp. For plugin based servers see Novamira and WP MCP Ultimate, which each ship their own tool sets. For block level edits, see GoBuildWP.


