# Cowboy MCP

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 14
- Author: februality
- License: GPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/februality/cowboy-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/cowboy-mcp

## What it 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.

## Requirements
- Remote server: `https://{site_host}/wp-json/cowboy-mcp/v1/endpoint`

## Install

### Claude Code (native platform)

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http cowboy-mcp https://{site_host}/wp-json/cowboy-mcp/v1/endpoint
```

### Codex

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
codex mcp add cowboy-mcp --url https://{site_host}/wp-json/cowboy-mcp/v1/endpoint
```

### Cursor

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cowboy-mcp": {
            "url": "https://{site_host}/wp-json/cowboy-mcp/v1/endpoint"
        }
    }
}
```

### GitHub Copilot

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cowboy-mcp": {
            "type": "http",
            "url": "https://{site_host}/wp-json/cowboy-mcp/v1/endpoint"
        }
    }
}
```

### Gemini CLI

1. **Template address**
- The server address is a template: replace {…} or […] with your own values

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http cowboy-mcp https://{site_host}/wp-json/cowboy-mcp/v1/endpoint
```

## When to use it
- 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
- 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.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md