# Advanced MCP Plugin — by AskTam

A WordPress plugin that exposes full AI control over your WordPress site via the **Model Context Protocol (MCP)**.

Connect Claude, GPT-4, or any MCP-compatible AI to your WordPress site and give it hands-on access to posts, pages, users, media, plugins, settings, WooCommerce, and more.

---

## Architecture

```
AI Client (Claude / any MCP client)
        │
        │  SSE / HTTP  (MCP protocol)
        ▼
WordPress REST Endpoint
  /wp-json/asktam-mcp/v1/sse
        │
        ▼
MCP Server (PHP, SSE transport)
        │
        ▼
Tool Handlers
  ├── Posts & Pages
  ├── Media
  ├── Users
  ├── Taxonomy
  ├── Options
  ├── Plugins & Themes
  ├── Menus
  ├── Comments
  ├── SEO Meta (Yoast / RankMath)
  ├── WooCommerce (if active)
  └── Site Health / Info
```

---

## Authentication

API Key based — simple, secure, no OAuth overhead for server-to-server AI use.

- Keys managed in **WP Admin → AskTam MCP → API Keys**
- Per-key capability scopes: `read`, `write`, `admin`, `woocommerce`
- Pass key in request header: `X-MCP-API-Key: your_key_here`

---

## MCP Endpoint

```
https://yoursite.com/wp-json/asktam-mcp/v1/sse
```

Add to any MCP client as a remote SSE server with the header `X-MCP-API-Key`.

---

## Tools

| Category | Tools |
|---|---|
| Posts | list_posts, get_post, create_post, update_post, delete_post |
| Pages | list_pages, get_page, create_page, update_page, delete_page |
| Media | list_media, get_media, upload_media, update_media, delete_media |
| Users | list_users, get_user, create_user, update_user, delete_user |
| Taxonomy | list_terms, get_term, create_term, update_term, delete_term |
| Options | get_option, update_option, list_options |
| Plugins | list_plugins, activate_plugin, deactivate_plugin |
| Themes | list_themes, get_active_theme, switch_theme |
| Menus | list_menus, get_menu, update_menu |
| Comments | list_comments, approve_comment, spam_comment, delete_comment |
| SEO | get_seo_meta, update_seo_meta |
| WooCommerce | list_products, get_product, create_product, update_product, list_orders, get_order, update_order_status |
| Site | get_site_info, get_health, run_cron |

---

## Installation

1. Upload `advanced-mcp-plugin/` to `/wp-content/plugins/`
2. Activate via WP Admin → Plugins
3. Go to **AskTam MCP → API Keys** → generate a key
4. Add endpoint to your MCP client

---

## Requirements

- WordPress 6.0+
- PHP 8.0+
- WooCommerce 7.0+ (optional, for WC tools)