Cowboy MCP connects your WordPress site to Claude, ChatGPT, Cursor, Gemini or any other AI agent, so your AI assistant can run the site for you – and you can undo anything it changed. It is a free, open-source, secure WordPress MCP server (Model Context Protocol) that runs inside your own site: no r
PricingFree downloadThe WordPress.org download is free. Pro versions, add-ons or external services may cost extra.
CompatibilityRequires WordPress 6.2 and PHP 8.0.
SourceWordPress plugins · Nov 16, 2026
01 / Source details
Aboutthistool.
Cowboy MCP connects your WordPress site to Claude, ChatGPT, Cursor, Gemini or any other AI agent, so your AI assistant can run the site for you – and you can undo anything it changed. It is a free, open-source, secure WordPress MCP server (Model Context Protocol) that runs inside your own site: no relay, no account, no Pro tier. The agent talks straight to your site.
Stop clicking around wp-admin. Just tell your AI what you want.
💬 Do everything by chat – create and edit posts and pages, run your WooCommerce shop, manage users and menus, tidy the media library, change settings, and fix errors when they crop up.
↩️ Undo any change – a per-change undo journal and one-click database checkpoints let you roll back a single edit or the entire site.
🔄 Updates plugins & themes safely – backup first, health check after, one-command undo if anything breaks.
🛡️ Secure by default – safe mode confirms before anything destructive, you can preview any change before it runs, every key can be scoped to read-only, and every action is written to an audit log.
🆓 Free and open source – every tool included, with deep WooCommerce, Gutenberg, ACF, Elementor, Beaver Builder, SiteOrigin, Wordfence and SEO support. No Pro tier, no credits, no usage meter.
🔒 Your data stays yours – self-hosted, no accounts, no relay, no phone-home. Your agent connects to your site; nothing leaves your server.
🔌 One-click sign-in – Claude, ChatGPT, Gemini, Grok, Perplexity, Muse, Cursor, VS Code, Claude Code, Codex, n8n, OpenClaw, Hermes Agent and any MCP client connect through your browser; no API key to paste. About two minutes, on a live site or a local one.
“More access than any other MCP offers, easy to use, LOVE the change journal and the checkpoints – safe if you break something, without having to run back ups on the host or yet another plugin.” – a WordPress.org reviewer
Ask in plain language – “publish these three drafts,” “why is the checkout page 500-ing,” “bump every Summer Sale price 20%,” “clear the cache and re-check site health” – and your agent gets it done. Most WordPress AI plugins let an assistant write blog posts; Cowboy MCP lets your agent actually run the site , including WP-CLI, files, the database, error logs and diagnostics.
Try it without installing: click Live Preview above for a throwaway WordPress Playground site with Cowboy MCP active.
What is a WordPress MCP server?
MCP (Model Context Protocol) is the open standard AI assistants use to work with other software. A WordPress MCP server gives Claude, ChatGPT or any MCP-capable agent a set of typed, permission-checked actions on your site – publish a post, update a product, fix an error – instead of you copy-pasting between a chat window and wp-admin. Cowboy MCP is that server, installed like any other plugin.
What you can do with it
Manage content by chat – draft, edit, schedule, and publish posts and pages; upload media; sort categories and tags; build navigation menus.
Edit pages block by block – your agent reads any page as a Gutenberg block tree and makes surgical edits: update a heading, move a section, swap a pattern. On block themes it can edit Site Editor templates and global styles too – all undoable.
Run the back office – add and edit users, change roles, and tidy the media library: find every image missing alt text and fix it in one go.
Run your store – update WooCommerce products, prices, orders, refunds, coupons and inventory; pull sales reports.
Fix things that break – read error logs, test emails and HTTP requests, inspect hooks and REST routes, check transients and rewrite rules, and repair database tables.
Do the developer stuff – run WP-CLI commands, edit files in wp-content , and take site snapshots before big changes.
Vibe code your site – describe the theme tweak or feature you want; your agent writes the code, checks the error log and fixes what it broke – with undo and checkpoints behind it.
Keep SEO tidy – read, write and audit Yoast SEO, Rank Math, All in One SEO or SEOPress meta across the site.
Roll back a post – list a post’s revisions, see a git-style diff of what changed, and restore any revision.
Run your events – create and edit The Events Calendar events, venues and organizers; with Events Calendar Pro, manage recurring series and cancel single dates.
Plug into the WordPress Abilities API – every tool is also a cowboy-mcp/* ability, with safe mode, the audit log and undo still in front, and abilities other plugins register become tools for your agent.
Tool coverage
Up to 203 tools. The core set is always on; integrations light up automatically when their plugin is active. Your agent sees two gateway tools ( cowboy_discover and cowboy_run ) and finds the rest on demand, so a big toolset never crowds its context.
Content – posts, pages and custom post types (5) · taxonomies (4) · comments (4) · media (4) · menus (6) · options (1) · revisions: list, diff and restore (3)
Gutenberg MCP – block tree read/edit with path addressing, block types, patterns, Site Editor templates and template parts, global styles, navigations (15; 8 on classic themes)
Site administration – users and roles (5) · plugins (6) · themes (5) · files in wp-content (4) · database health and repair (5) · WP-CLI, site info and search-replace (3) · site health (1)
Diagnostics – error log, HTTP and email tests, hooks, transients, REST routes, thumbnails, rewrite rules, snapshot, Connection Doctor (10)
Safety – list changes, undo a change, create/list/restore/delete database checkpoints (6) · batch execution and audit-log retrieval (2)
WooCommerce MCP – products and variations, orders and refunds, customers, coupons, tax and shipping settings, reports (40)
Wordfence – scans, blocks, firewall, live traffic, activity, settings (17)
ACF MCP – field groups, fields, values, repeaters (9)
Elementor MCP – templates, page content, global styles, widgets (7)
Beaver Builder – builder pages, layouts, modules, global settings (7)
Events – The Events Calendar events, venues, organizers (11) plus Events Calendar Pro recurrence and occurrences (2)
SEO MCP – Yoast SEO, Rank Math, All in One SEO and SEOPress meta read/write/audit (4)
Cache – WP Rocket, LiteSpeed Cache, W3 Total Cache (4)
Forms – WPForms, Gravity Forms, Contact Form 7 (1)
Plus 17 read-only MCP resources, 4 resource templates and 8 guided workflow prompts (site audit, troubleshooting, SEO, security hardening, performance and more).
One-click sign-in for every app
Every app sends you to a sign-in page on your own site: the cloud apps and IDEs with one button, the terminal tools with one command. The consent screen names the app and lets you grant full access, read-only, drafts only, or a hand-picked list of tools; nothing is granted until you click Approve . Keys remain for scripts and CI.
Connect Claude Code to WordPress
Two lines, ready to copy on the Connections tab:
claude mcp add --transport http your-site https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint claude mcp login your-site
Headless or CI? Use an API key with --header .
Connect Claude to WordPress (claude.ai and Claude Desktop)
No terminal: click Add to Claude on the Connections tab and approve the sign-in on your own site. Needs a public HTTPS site.
Connect ChatGPT to WordPress
ChatGPT connects with the same one-click sign-in on the web, from a Plus account or a Business, Enterprise or Edu workspace; it needs a public HTTPS site.
01Click Open ChatGPT on the Connections tab (it copies your connection link).
02In ChatGPT, go to Plugins → Add → Add custom MCP server , paste the link as the Server URL, keep OAuth and click Create as a plugin .
03Approve the sign-in on your site, install the plugin, then pick it from the + menu in a chat.
Connect Perplexity, Grok and Gemini
Perplexity (Pro, Max or Enterprise), Grok (free plan works) and the Gemini app (personal US Google account) each add a custom MCP server by URL: copy your connection link from the app’s panel on the Connections tab, click Open to go to the app, paste the link where it asks for a server URL, then approve the sign-in on your own site. They connect from the vendor’s cloud, so the site needs a public HTTPS address.
Connect Meta Muse
Muse and Muse Code set up from a pasted message: click Copy message on the Muse panel, send it in a new Muse chat, click Connect on the connector card and approve the sign-in on your site. Sites behind Cloudflare need one firewall rule, which the panel and the Connection Doctor spell out.
Connect n8n
Add an MCP Client Tool node: Endpoint = your connection link, Server Transport = HTTP Streamable, Authentication = MCP OAuth2 (n8n registers itself and opens the sign-in; self-hosted n8n adds its host under Browser sign-in → Additional allowed hosts) or Bearer Auth with an API key. Execute the node once to see cowboy_discover and cowboy_run.
Connect OpenClaw and Hermes Agent
Both run from a chat, so the Connections tab gives you a message to paste: the agent adds the server to its config, starts the sign-in and sends you the link to approve. Terminal commands, config files and an API-key setup are one click away.
Connect Cursor and VS Code
Click Add to Cursor or Install in VS Code on the Connections tab, then sign in in your browser.
Windsurf, Cline, Zed and other editors
Add one block to your editor’s MCP config, then restart the editor:
Codex opens your browser to sign in; headless, add --bearer-token-env-var COWBOY_MCP_API_KEY and export your key.
Connect Gemini CLI
gemini mcp add -s user -t http your-site https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint
Start gem
See it in action
Screenshots & previews.
Connections tab - pick your AI tool (claude.ai, ChatGPT, Gemini, Grok, Perplexity, Muse, Claude Code, Codex, Cursor, VS Code, n8n, OpenClaw, Hermes Agent, and more): one click adds the site to Claude, the other AI apps get the exact link or message to paste, terminal tools get a ready-made command, Settings tab - turn the server on or off, require Safe Mode confirmation for destructive actions, turn on Browser sign-in (OAuth) for apps that connect without a key, set a per-key rate limit, tune the undo journal and database checkpoints, and opt in to advanced Power Mode.Activity tab - a per-change undo journal: review every change your agents made and roll any of them back individually, plus one-click database checkpoints you can restore the whole site to.Logs tab - a structured, filterable audit log of every MCP tool call, error, and auth event, auto-pruned after 30 days.About tab - what Cowboy MCP does, with links to the project site and source.One-click browser sign-in - the connector opens a consent screen on your own site that names where you will be sent next and lets you choose full or read-only access; no access is granted until you approve it as an administrator.
02 / Source details
Gettingstarted.
01Install and activate Cowboy MCP from the Plugins screen.
02Go to Settings > Cowboy MCP , open the Connections tab, pick your app and click its button or copy its command; you then sign in through your browser.
03Connect your agent and start giving it instructions.
Claude Code:
claude mcp add --transport http your-site https://yoursite.com/wp-json/cowboy-mcp/v1/endpoint claude mcp login your-site
Headless or CI? Click Generate API key on the Connections tab (it is shown once – copy it) and add --header "Authorization: Bearer YOUR_API_KEY" to the first line instead of running the second.
WordPress in a subfolder (or a multisite subsite)? Run only the first line, then start claude , run /mcp , choose the server and pick Authenticate .
Claude desktop / web (no terminal): click Add to Claude on the Connections tab (Claude opens with your site already filled in; browser sign-in is switched on for you) and approve with one click. (Requires a public HTTPS site; on a local site use the mcp-remote bridge shown on the Connections tab.)
Every other client: the Connections tab shows a ready-to-copy setup for each, and cowboymcp.com has step-by-step guides.
03 / Source details
Frequently asked questions.
What is a WordPress MCP server?
A plugin that lets AI assistants act on your site through the Model Context Protocol (MCP), the open standard Claude, ChatGPT, Cursor and other agents use to call external tools. Cowboy MCP turns your WordPress site into one of those tools, so your agent can publish, edit, update and fix things directly instead of telling you what to click.
How do I connect ChatGPT to my WordPress site?
Click Open ChatGPT on the ChatGPT panel of the Connections tab in Cowboy MCP; it copies your connection link. In ChatGPT on the web, go to Plugins , click Add > Add custom MCP server , paste the link as the Server URL, keep OAuth, acknowledge the risk warning and click Create as a plugin . Approve the sign-in on your site as an administrator, install the plugin, then pick it from the + menu in a chat (or type @ and its name). It needs a Plus account or a Business, Enterprise or Edu workspace (where an admin grants the Create plugins with MCPs permission) and a public HTTPS site.
How do I connect Claude to my WordPress site?
For the Claude desktop and web apps, click Add to Claude on the Connections tab and approve the one-click sign-in – no terminal needed. For Claude Code, run the two lines shown ready to copy on the Connections tab and sign in in your browser – no key to copy, and no switch to flip: Claude Code and Codex identify themselves with a Client ID Metadata Document (the current MCP standard). For headless or CI use, generate an API key there instead.
Is it free?
Yes. Every tool, every integration and every safety feature is in this free plugin, licensed GPL-2.0. There is no Pro tier, no credit system and no usage cap beyond the per-key rate limit you set yourself.
Is it secure? Can the AI break my site?
It is built so a mistake can be reversed. Keys are hashed and shown once, requests are rate-limited, destructive actions need confirmation, changes can be previewed with a dry run, and every action is written to an audit log. Content, options, users, media deletions, menus, terms, comments, WooCommerce objects, SEO meta, revisions, events, Gutenberg and Site Editor edits, Beaver Builder and SiteOrigin layouts, search-replace runs and plugin or theme installs, updates and deletions are journaled and can be undone individually or as a batch – seven days by default – and database checkpoints roll every site table back to an earlier moment. Things with no inverse – a sent email, a cache flush, an arbitrary WP-CLI command, an outbound HTTP request – are recorded as not undoable rather than pretended otherwise; take a checkpoint first when you ask for those.
Can I limit what an AI agent is allowed to do?
Yes. Every API key and every OAuth connection carries a scope: full access, read-only, drafts only, or a custom list of allowed tools, chosen when the key is created or the connection is approved. Drafts only lets the AI write drafts and upload images but never publish: an edit to a live post goes to a draft copy that you review and publish yourself. Safe mode adds confirmation for destructive tools on top, and the most powerful operations stay locked behind Power mode, which only an administrator can enable in wp-admin.
Do I need to be a developer?
No. Publishing content and running your store work through plain conversation. The developer tools (WP-CLI, files, database) are there when you want them, and gated behind safe mode until you say go.
Which AI agents and assistants work with it?
Any MCP-compatible client over Streamable HTTP – including Claude Code, the Claude desktop and web apps, ChatGPT, Perplexity, Grok, the Gemini app, Meta Muse and Muse Code, Cursor, VS Code with GitHub Copilot, Windsurf, Cline, Zed, Codex CLI, Gemini CLI, Opencode, n8n, OpenClaw and Hermes Agent.
Does it work with WooCommerce?
Yes. When WooCommerce is active, 40 store tools light up: products and variations, orders and refunds, coupons, customers, stock, shipping zones, tax rates, payment gateways, and sales reports – so your agent can run the store, not just describe it.
Does it work with The Events Calendar?
Yes. When The Events Calendar is active, your agent can create and edit events, venues and organizers, and trash or delete events (venues and organizers are removed with the standard delete-post tool). With Events Calendar Pro it can also manage recurring events – edit a whole series or cancel a single date. Editing one occurrence on its own stays in wp-admin. Changes are undoable, and permanent deletes take a database checkpoint first.
Does it work on a local development site (Local, Studio, MAMP, DevKinsta)?
Yes. Terminal tools like Claude Code, Cursor, Codex and Gemini CLI run on the same computer as your local site, so they sign in with OAuth in your browser – no public URL needed. An API key works too, for headless use. Claude Desktop connects through a small local bridge ( mcp-remote ); the Connections tab detects local sites and shows the ready-to-copy config. Only the cloud-side apps – claude.ai and ChatGPT – require a public HTTPS address, because they connect from the vendor’s servers; a tunnel works for temporary testing, but be aware it exposes your whole dev site while it runs.
My host or Jetpack already offers MCP. Do I need this?
Hosting-level MCP servers mostly manage the hosting account – sites, DNS, backups – and WordPress.com’s MCP reaches a self-hosted site only through a paid Jetpack plan. Cowboy MCP works inside the site itself, on any host, for free: content, WooCommerce, users, plugins, diagnostics, with undo and an audit log. They can run side by side.
Should I wait for the official MCP Adapter?
You don’t need to. The Abilities API (WordPress 6.9+) and the official MCP Adapter are a framework: plugins register abilities, and the adapter exposes whatever was registered. Cowboy MCP is a complete, turnkey MCP server with its own toolset, safety layer, undo, audit log, scoping, OAuth connector and Connection Doctor, and it runs on WordPress 6.2 or later without Composer or Node.js. On 6.9+ it registers its tools as abilities, so the adapter can use them too – you can run both side by side.
How does it compare with Novamira?
Novamira is built for development and staging copies and gives the agent a PHP shell. Cowboy MCP is built for live sites: typed tools, safe mode, undo, database checkpoints and an audit log, all free, installed from WordPress.org. See the full Cowboy MCP vs Novamira comparison .
Can I vibe code my WordPress site?
Yes – that is what it is built for. Your agent can write and edit theme and plugin code in wp-content , run WP-CLI, and read the error log to fix what it broke. Every PHP file is syntax-checked before it lands, and mu-plugins (which WordPress recovery mode cannot pause) stays off-limits unless an administrator turns on Power mode – so a cut-off or broken payload cannot take the site down. Take a database checkpoint first (or let auto-checkpoint do it), and every change lands in the undo journal – so vibe coding a live site does not have to be a leap of faith.
Does it send my data anywhere?
No telemetry and no phone-home – your data stays on your server. It connects out only to WordPress.org, when your agent installs or updates plugins and themes, and to any address you ask your agent to reach. There is no hosted relay and no account with us; your AI client connects to your site directly.
When you approve a browser sign-in from an AI app, your site also fetches that app’s public description file from the app’s own site. This happens only while a logged-in administrator has the approval screen open, and the request includes your site’s address and the plugin version. The sites it may fetch from are claude.ai, claude.com, anthropic.com, chatgpt.com, openai.com, perplexity.ai, perplexity.com and nousresearch.github.io, plus any host an administrator has added.
Does it work with the WordPress Abilities API?
Yes, both ways, on WordPress 6.9 or newer. Every allowed tool is registered as a cowboy-mcp/* ability, so wp ability run , the core Abilities REST endpoint, the official MCP Adapter and the AI plugin’s Abilities Explorer all reach it – and every call still goes through safe mode, dry run, the audit log and the undo journal. Callers need an administrator account; wp_cli and wp_write_file are only exposed while Power mode is on. In the other direction, abilities registered by other plugins appear as tools for your agent; they run their own permission checks and are not undoable. Both directions have a switch under Settings. Request formats and examples: Cowboy MCP 1.6.4 release notes .
Does it work on multisite?
Cowboy MCP is built for single sites and is not network-aware. On a multisite network, activate it on each site you want an agent to manage (not network-wide). Only super admins can open its settings, create keys or approve apps on that site. Checkpoints and user deletes stay inside that site, and the plugin tools recognise network-activated plugins when activating or deactivating.
Connection problems: 401/404, “registration is closed”, a refused redirect host, or a connector that stopped after a staging sync
Start with the Connection Doctor on the Connections tab. It tests HTTPS, the REST API, OAuth discovery and common host blockers (Cloudflare bot rules, ModSecurity-style firewalls, LiteSpeed caching of /wp-json/ ), names the exact problem and gives you a fix. The most common cases:
“Registration is closed” – new AI apps can register only while “New connections” is on: on the Connections tab pick the app (“Connect another app” if the list is not shown), click “Enable for 30 minutes”, then add the connector.
Connector stopped after a staging sync or database restore – click “Enable for 30 minutes”, then Reconnect in the AI app and approve again. Nothing needs removing.
“Not an allowed redirect host” – the connector only returns approvals to known AI apps and localhost; add another OAuth client’s host (for example a self-hosted n8n) under Settings > Browser sign-in > Additional allowed
FinderPress Media Auditor helps site administrators scan for broken images, missing Media Library files, unreachable media URLs, and other media issues across WordPress content. Use it to audit images, video, audio, PDFs, featured images, and attachment files without sending scan data to an external
The Accepted Payment Methods plugin is a straightforward, lightweight solution that enhances your website by displaying visually appealing icons of the payment methods you accept. This plugin is ideal for a variety of websites, including e-commerce platforms, service-oriented websites, and informati