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

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

Claude Desktop (claude_desktop_config.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.