# WooCommerce Gold — MCP

> WooCommerce ops via REST `wc/v3` — 20 tools for products/orders/coupons/customers/reports + batch/variations/categories/coupons_bulk/seo_meta/desc_byok/daily_digest (20 gold tools + gold_setup_check =21 total). Local-first, BYOK on your own store, 0% in Glama before this.

**Binary:** `woocommerce-gold` · **Package:** `woocommerce-gold` · **MCP name:** `ai.studio/woocommerce-gold`

> **Disclosure:** This project is an independent Gold wrapper around the public WooCommerce REST API (`https://woocommerce.github.io/woocommerce-rest-api-docs/`). We are not affiliated with WooCommerce / Automattic / WordPress Foundation. WooCommerce is GPL-licensed; this wrapper's original code is © 2026 Studio AI under `GOLD MCP — COMMERCIAL LICENSE v1.0`. Upstream docs remain under their own licenses. `THIRD_PARTY_NOTICES.md` + `upstream/ORIGINAL_LICENSE` preserve attribution.

**Buy Pro — PAID ONLY $29 once via Keygen CE (no free tier):** https://gumroad.com/l/woocommerce-gold — all 20 `gold_*` tools require `GOLD_LICENSE_KEY`, fail-closed without it (offline 7-day grace).

## Quick start

```bash
npx -y woocommerce-gold
# or local
npm install
npm run build
node dist/index.js
```

Claude Desktop (`claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "woocommerce-gold": {
      "command": "npx",
      "args": ["-y", "woocommerce-gold"],
      "env": {
        "WC_STORE_URL": "https://yourstore.com",
        "WC_CONSUMER_KEY": "ck_xxx",
        "WC_CONSUMER_SECRET": "cs_xxx",
        "GOLD_LICENSE_KEY": "gold_pro_..."
      }
    }
  }
}
```

## Env vars (BYOK — no fake data, fail-closed)

| Var | Purpose |
|-----|---------|
| `WC_STORE_URL` / `WOOCOMMERCE_STORE_URL` / `WC_URL` | WooCommerce store URL, e.g. `https://yourstore.com` |
| `WC_CONSUMER_KEY` / `WOOCOMMERCE_CONSUMER_KEY` | Woo REST consumer key (`ck_…` from WooCommerce → Settings → Advanced → REST API) |
| `WC_CONSUMER_SECRET` / `WOOCOMMERCE_CONSUMER_SECRET` | Woo REST consumer secret (`cs_…`) |
| `GOLD_LICENSE_KEY` / `GOLD_LICENSE` | Gold license — PAID ONLY PRO $29 once (no free tier) via Keygen CE. Or `~/.gold-mcp/license.key` |
| `KEYGEN_ACCOUNT_ID` | Keygen CE account id for online validation (offline 7-day grace) |

Without `WC_STORE_URL` + key/secret every tool returns `config_error` (no invented data). Without `GOLD_LICENSE_KEY` every tool throws `requires PRO license` — fail-closed.

## Tools (gold_* — 20 tools + gold_setup_check =21 total, all PRO $29 — BYOK fail-closed)

| Tool | What it does |
|------|--------------|
| Tool | What it does |
|------|--------------|
| `gold_list_products` | List products `GET /wp-json/wc/v3/products` — search/status/stock filter, pagination |
| `gold_get_product` | Get single product by id |
| `gold_create_product` | Create product (name/type/price/sku/stock/categories/images/status) |
| `gold_update_product` | Update product by id |
| `gold_update_stock` | Fast stock update `{stock_quantity, stock_status, manage_stock}` — bulk-ready |
| `gold_list_orders` | List orders `GET /wp-json/wc/v3/orders` — status/customer/date filter |
| `gold_get_order` | Get single order by id |
| `gold_update_order_status` | Update order status (pending→processing→completed…) |
| `gold_create_refund` | Create refund `POST /wp-json/wc/v3/refunds` — amount/reason/refund_payment |
| `gold_list_customers` | List customers `GET /wp-json/wc/v3/customers` — email/role/search |
| `gold_create_coupon` | Create coupon `POST /wp-json/wc/v3/coupons` — code/discount_type/amount/expiry |
| `gold_get_reports` | Get reports — `sales/orders/customers/coupons/stock/revenue` + period |
| `gold_low_stock_alert` | Low-stock scan: `instock` ordered by quantity + threshold filter → reorder list |
| `gold_wc_batch` | Batch create/update/delete up to 100 rows ONE call (products/orders/coupons/categories) |
| `gold_wc_variations` | Bulk variations (size/color) — `POST /products/{id}/variations/batch` up to 100 |
| `gold_wc_categories_bulk` | Ensure 1-50 categories exist in one call |
| `gold_wc_coupons_bulk` | Generate up to 100 unique PREFIX-XXXX coupons + usage_limit |
| `gold_wc_daily_digest` | Morning briefing — orders+revenue+AOV+low-stock+open orders (1-30 days) |
| `gold_wc_seo_meta_bulk` | Bulk SEO title+metadesc (Yoast/RankMath) on 25 products — 60/155 chars auto-trim |
| `gold_wc_desc_bulk_byok` | Bulk descriptions via YOUR OpenAI key (BYOK, billed by OpenAI) — 10/call, tone friendly/luxury |
| `gold_setup_check` | Preflight — verifies BYOK keys + GOLD_LICENSE_KEY fail-closed |

All 20 gold tools + `gold_setup_check` =21 total are `gold_*` prefixed — PAID ONLY PRO $29 once, BYOK fail-closed without `WC_STORE_URL`/`WC_CONSUMER_KEY`/`WC_CONSUMER_SECRET` and `GOLD_LICENSE_KEY` (fail-closed `config_error` / `requires PRO license`).

## Upstream attribution

Derivative shape from MIT-licensed `GeLi2001/shopify-mcp` (236★) 31-tool pattern + public Woo REST docs (https://woocommerce.github.io/woocommerce-rest-api-docs/). Original MIT preserved in `THIRD_PARTY_NOTICES.md` + `upstream/ORIGINAL_LICENSE`. WooCommerce core remains GPL.

Gold derivative (`src/` outside `upstream/`) is © 2026 Studio AI under `GOLD MCP — COMMERCIAL LICENSE v1.0 (2026-08-19)` — see `LICENSE` — `LICENSE TIERS: PRO $29 once (PAID ONLY, no free tier) | TEAM $99/mo` via Keygen CE.

## Weekly watch list

Tracked in `docs/MCP-GOLD-MASTER-PLAN-2026-08-19.md` §2 — WooCommerce MCP is 0 in Glama before this; full weekly watch URLs live there. Registry-listed via `smithery.yaml` (Smithery) + `mcp.json` (Glama / Pulsemcp / mcp.so / mcp-registry).

## License

`LICENSE` — PRO $29 once, TEAM $99/mo. Upstream docs/patterns remain under their licenses. WooCommerce GPL unchanged.

## See also

- Master plan: `docs/MCP-GOLD-MASTER-PLAN-2026-08-19.md`
- Third-party notices: `THIRD_PARTY_NOTICES.md`
- Woo docs: https://woocommerce.github.io/woocommerce-rest-api-docs/