Royal MCP’s WooCommerce Tools — Reference
Twenty-nine free tools that let Claude, ChatGPT, or Perplexity run store operations against WooCommerce — products, variations, attributes, orders, coupons, customers, and store stats. Auto-registered the moment WooCommerce is detected. No configuration required.
How WooCommerce + Royal MCP works
When WooCommerce is active on your site, Royal MCP automatically registers 29 additional MCP tools covering products, variations, attributes, orders, coupons, customers, and store stats. No configuration is required. the tools appear as soon as WooCommerce is detected.
Use it for: AI-assisted product creation, natural-language order status updates, B2B and phone order entry, coupon management, bulk inventory adjustments across variations, product-attribute rework, customer lookup, and store analytics queries.
Products (4 tools)
Product Variations (6 tools)
Product Attributes (4 tools)
Orders (6 tools)
Coupons (7 tools)
Customers & Stats (2 tools)
Paging large lists
wc_get_products, wc_get_customers, wc_get_coupons, wc_get_orders and wc_get_product_variations return up to 100 rows per call. Products, customers, coupons and orders default to 10 per call, variations to 100. Set per_page (1 to 100) to change it.
To walk a whole catalog, pass page (starting at 1). The reply then wraps the rows with the totals:
{
"products": [ ... ],
"page": 1,
"per_page": 100,
"total": 250,
"total_pages": 3
}Ask for the next page until page reaches total_pages. Without page, the reply is the plain list as before, so existing prompts and scripts keep working.
wc_get_products also filters by include and exclude (lists of product IDs), sku, and stock_status (instock, outofstock or onbackorder). Each product row includes stock_quantity, stock_status and manage_stock.
wc_get_orders always returns the wrapped reply, newest first. Filter by creation date with after and before: a date (YYYY-MM-DD) or an ISO 8601 date-time, in your site’s timezone. Both ends are included, and a date on its own in before covers that whole day. A date that is not valid is refused with a message rather than ignored.
If a call includes an argument the tool does not use, the reply lists it under ignored_args, so the AI can see a filter it expected had no effect.
Example queries
Ask Claude, ChatGPT, or Perplexity questions like these once WooCommerce + Royal MCP are connected:
- “What were my top 5 best-selling products last month?”
- “List all orders that have been processing for more than 7 days.”
- “Create a new simple product called ‘Premium Coffee Beans’ for $24.99 with 100 units in stock.”
- “Update order #1234 to completed status and add a customer-facing note explaining the delay.”
- “What’s my average order value compared to last month?”
- “Find customers who have spent more than $500 lifetime.”
- “Create a 15% off coupon code SPRING2026 that expires end of month, limited to 500 uses.”
- “Add a new Large variation to the Classic Tee, in Charcoal, priced at $29.”
The WooCommerce Claude Skill — encoded store workflows
The WooCommerce tools are the API surface. The WooCommerce Claude Skill is the operator’s playbook that teaches Claude how to run common store tasks safely: how to author a variable product cleanly, how to plan a sale campaign, how to handle a B2B order, how to reconcile inventory after a return.
Pro WooCommerce toolkit — agency-scale bulk operations
The free 29 tools cover single-item work: one product, one order, one coupon. Sale campaigns, catalog-wide changes, and store-migration work land in Royal MCP Pro. Pro adds a bulk toolkit for every WooCommerce object type, and every bulk operation returns a single-batch undo token so a mistaken price sweep or status update rolls back in one call.
Permissions & safety
WooCommerce write operations (create product, update order status, apply coupon) require the connecting user to have the shop_manager or administrator capability. Royal MCP enforces WordPress’s standard capability checks on every WooCommerce tool call — the AI client can only edit what the user themselves has permission to edit.
The free 29 tools don’t emit undo tokens because they act on one product, order, or coupon per call. The blast radius of a mistake is one object — the WordPress revision system captures the pre-change state on posts and meta. For multi-object operations that need atomic rollback (sale campaigns, catalog imports), the Pro bulk tools ship per-batch undo tokens.
Royal MCP’s order tools work on both the classic post-type storage and the newer High-Performance Order Storage (HPOS). If your store is mid-migration or the two storage backends are out of sync, prefer setting an authoritative source in WooCommerce before running large order-scope operations.