# WP Commander MCP Server

Control any WordPress site from Claude via natural language.  
One MCP server. Every WP Commander endpoint. Zero configuration per request.

## How it works

```
Claude → MCP Server → WP Commander plugin → WordPress
```

Your site URL + API key are passed in the MCP connection URL — clients configure once, then just talk to Claude.

---

## Deploy in 2 minutes

### Option A — Vercel (recommended)

```bash
git clone https://github.com/Hari842-ai/wp-commander-mcp
cd wp-commander-mcp
npm i -g vercel
vercel --prod
```

### Option B — Railway / Render

```bash
railway init && railway up
```

### Option C — Local

```bash
npm install
npm run dev
```

---

## Connect to Claude

In Claude.ai Settings → Integrations → Add MCP Server:

```
https://your-server.vercel.app/mcp?site=https://yoursite.com&key=YOUR_WPC_KEY
```

---

## Available tools (21)

| Tool | Description |
|------|-------------|
| `wpc_health` | Site health score + warnings |
| `wpc_server_info` | PHP, WP, MySQL versions + disk |
| `wpc_flush_cache` | Flush site cache |
| `wpc_list_plugins` | All plugins, update status |
| `wpc_manage_plugin` | Activate / deactivate / update |
| `wpc_logs` | PHP errors, WooCommerce, cron logs |
| `wpc_audit_log` | Full action history |
| `wpc_bulk_seo` | SEO titles + descriptions in bulk |
| `wpc_list_posts` | Posts, pages, custom post types |
| `wpc_create_post` | Write + publish content |
| `wpc_update_post` | Edit existing content |
| `wpc_search_replace` | Site-wide find & replace (with preview) |
| `wpc_list_media` | Media library, missing alt texts |
| `wpc_bulk_alt_texts` | AI alt texts in bulk |
| `wpc_list_products` | WooCommerce products |
| `wpc_update_product` | Price, stock, SEO, tags, description |
| `wpc_bulk_price` | Bulk price update |
| `wpc_list_orders` | Recent orders |
| `wpc_product_tags` | All product tags with IDs |
| `wpc_woo_reports` | Sales reports |
| `wpc_redirects` | Broken redirects |

---

## Security

- API keys passed as URL params over HTTPS
- Stateless — server never stores credentials
- WP Commander validates key on every request

---

Built by [Hacoeur](https://hacoeur.net) · Requires [WP Commander](https://wpcommander.io)