Skip to main content
Glama
ai.studio/woocommerce-gold

ai.studio/woocommerce-gold

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_..."
      }
    }
  }
}

Related MCP server: WordPress + WooCommerce MCP Server

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

Available Tools

21 tools
gold_create_couponC

Gold PRO $29: create Woo coupon via POST /wp-json/wc/v3/coupons — BYOK fail-closed.

Inputs: code (required), amount (required), confirm, description, +7 more.

gold_create_productA

Gold PRO $29: create Woo product via POST /wp-json/wc/v3/products — BYOK fail-closed. Destructive, requires PRO.

Inputs: name (required), sku, type, images, +10 more.

gold_create_refundC

Gold PRO $29: create refund via POST /wp-json/wc/v3/refunds — BYOK fail-closed. Destructive.

Inputs: order_id (required), amount, reason, confirm, +3 more.

gold_get_orderA

Gold PRO $29: get Woo order via GET /wp-json/wc/v3/orders/{id} — BYOK fail-closed.

Inputs: id (required).

gold_get_productA

Gold PRO $29: get single Woo product via GET /wp-json/wc/v3/products/{id} — BYOK fail-closed.

Inputs: id (required).

gold_get_reportsB

Gold PRO $29: get Woo reports via /wp-json/wc/v3/reports/sales etc — BYOK fail-closed. Types: sales, orders, customers, coupons, stock, revenue.

Inputs: type, period, date_max, date_min.

gold_list_customersB

Gold PRO $29: list Woo customers via GET /wp-json/wc/v3/customers — BYOK fail-closed.

Inputs: page, role, email, search, +1 more.

gold_list_ordersA

Gold PRO $29: list Woo orders via GET /wp-json/wc/v3/orders — BYOK fail-closed.

Inputs: page, after, before, search, +3 more.

gold_list_productsA

Gold PRO $29: list Woo products via GET /wp-json/wc/v3/products — BYOK WC_STORE_URL+CONSUMER_KEY/SECRET fail-closed, no fake data.

Inputs: page, order, search, status, +4 more.

gold_low_stock_alertB

Gold PRO $29: low-stock alert via GET /wp-json/wc/v3/products?stock_status=onbackorder/lowstock — BYOK fail-closed. Moat: one call alerts for reorder.

Inputs: per_page, threshold.

gold_setup_checkA

SETUP CHECK for WooCommerce Gold — run this FIRST. Shows license tier, which API keys are set vs missing (names only, never values), and the exact next step.

Inputs: no named parameters.

gold_update_order_statusB

Gold PRO $29: update order status via PUT /wp-json/wc/v3/orders/{id} {status} — BYOK fail-closed.

Inputs: id (required), status (required), confirm.

gold_update_productC

Gold PRO $29: update Woo product via PUT /wp-json/wc/v3/products/{id} — BYOK fail-closed.

Inputs: id (required), sku, name, status, +7 more.

gold_update_stockB

Gold PRO $29: update Woo stock via PUT /wp-json/wc/v3/products/{id} {stock_quantity, stock_status} — BYOK fail-closed. Bulk-ready (call per SKU).

Inputs: id (required), stock_quantity (required), confirm, manage_stock, +1 more.

gold_wc_batchB

BULK batch on products/orders/coupons/categories — create+update+delete up to 100 rows in ONE call (the CodeCanyon Advanced Bulk Edit $69 killer). resource: products|orders|coupons|categories. PAID ONLY PRO $29.

Inputs: resource (required), create, delete, update, +1 more.

gold_wc_categories_bulkB

Ensure 1-50 product CATEGORIES exist in one call (creates missing only) — SEO tagging at scale. PAID ONLY PRO $29.

Inputs: names (required), confirm.

gold_wc_coupons_bulkA

Generate up to 100 unique coupon codes in one call (PREFIX-XXXX, e.g. influencer drops) + optional usage limit. PAID ONLY PRO $29.

Inputs: count (required), percent_off (required), prefix, confirm, +1 more.

gold_wc_daily_digestB

POWER TOOL: your store's morning briefing in ONE call - today's orders + revenue + AOV, low-stock products, open orders needing action. BYOK. PAID ONLY PRO $29.

Inputs: days_back.

gold_wc_desc_bulk_byokA

POWER: bulk-generate unique product descriptions via YOUR OWN OpenAI key (BYOK - key stays local, charged by OpenAI not us). Reads product name+attributes -> writes description per product. Skips products that already have long descriptions unless overwrite=true. PAID ONLY PRO $29.

Inputs: product_ids (required), tone, words, confirm, +2 more.

gold_wc_seo_meta_bulkB

POWER: bulk-set SEO title + meta description (Yoast/RankMath compatible _yoast_wpseo_title/_metadesc or rank_math_title/description) on many products. Trimmed to 60/155 chars automatically. BYOK. PAID ONLY PRO $29.

Inputs: product_ids (required), title_template (required), confirm, seo_plugin, +1 more.

gold_wc_variationsC

List or bulk-create product VARIATIONS (size/color) — clothing shops cannot live without this; techspawn has it, we added it. PAID ONLY PRO $29.

Inputs: product_id (required), action, confirm, variations.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 21 tools

    Disambiguation3/5

    Most CRUD tools target distinct resources, but there are overlapping boundaries: gold_update_stock duplicates a subset of gold_update_product, gold_wc_batch can write to products/orders/coupons/categories alongside the individual create/update tools, and gold_get_reports, gold_low_stock_alert, and gold_wc_daily_digest all surface store metrics/stock information. Descriptions are detailed enough to usually disambiguate, but the set is not cleanly partitioned.

    Naming Consistency3/5

    All tools share a gold_ prefix and snake_case, but the conventions diverge: core resource operations use verb_noun like gold_list_products and gold_create_coupon, while bulk/feature tools use a gold_wc_* pattern like gold_wc_batch and gold_wc_daily_digest, and gold_setup_check is a noun-ish outlier. This is readable but not a single predictable verb_noun schema.

    Tool Count4/5

    21 tools is on the heavy side for a single server, but each tool addresses a concrete WooCommerce resource, reporting, or bulk-operation need, so the count is large yet justified by the domain. It stays below the extreme threshold and does not feel bloated with pointless duplicates.

    Completeness4/5

    The server covers product lifecycle well (list/get/create/update, stock, categories, variations) plus orders, refunds, coupons, customers, reports, and store diagnostics. Gaps include no delete/update for coupons and no customer create/update, but core store workflows and dead-ends are mostly handled.

    Related MCP Connectors

    Related MCP Servers