# Royal MCP’s WooCommerce Tools — Reference

> Royal MCP's 29 free WooCommerce tools cover products, variations, attributes, orders, coupons, customers and store stats, plus the Claude Skill and Pro tools.

- Canonical: <https://royalplugins.com/support/royal-mcp/woocommerce-tools/>
- Last updated: 2026-09-22
- HTML version: <https://royalplugins.com/support/royal-mcp/woocommerce-tools/>

---

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)

wc\_get\_products

List or search products by category, status, type, or stock level.

wc\_get\_product

Fetch a single product with full details (variants, images, meta).

wc\_create\_product

Create a new product with name, price, SKU, stock, description.

wc\_update\_product

Update price, stock, status, or any other product field; preserves product\_type on generic post updates.

## Product Variations (6 tools)

wc\_get\_product\_variations

List every variation of a variable product with SKU, price, stock, and attribute values.

wc\_get\_variation

Fetch a single variation by ID with full detail.

wc\_create\_variation

Add a new variation to a variable product with attribute values, price, SKU, and stock.

wc\_update\_variation

Update any variation field: price, stock, dimensions, visibility.

wc\_delete\_variation

Remove a variation from a product.

wc\_batch\_update\_variations

Bulk-update every variation of a product in one call. Good for a price change across an entire product line.

## Product Attributes (4 tools)

wc\_get\_product\_attributes

List global attributes defined on the store (Color, Size, Material, etc.).

wc\_set\_product\_attributes

Assign attributes to a specific product with terms and variation flags.

wc\_create\_product\_attribute

Create a new global attribute available to any product on the store.

wc\_get\_attribute\_terms

List every term (Red, Blue, Small, Large, etc.) defined under a specific attribute.

## Orders (6 tools)

wc\_get\_orders

List orders filtered by status, customer, or date range.

wc\_get\_order

Fetch a single order with line items, customer info, shipping, fees, and payment method.

wc\_create\_order

Create a new order — supports B2B, wholesale, phone orders, manual invoicing. Line items + shipping + fees + status.

wc\_update\_order

Update an existing order — line items, addresses, meta, custom fees.

wc\_update\_order\_status

Move an order between statuses (processing, completed, refunded, etc.).

wc\_add\_order\_note

Add a customer-facing or private order note (support trails, refund reasons, fulfillment updates).

## Coupons (7 tools)

wc\_get\_coupons

List coupons with usage limits, expiry, discount type, and remaining uses.

wc\_get\_coupon

Fetch a single coupon by ID or code.

wc\_get\_coupon\_count

Return the total coupon count — useful for a “how many coupons do we have?” query.

wc\_create\_coupon

Create a new coupon — percent, fixed cart, or fixed product discount, with usage limits and product restrictions.

wc\_update\_coupon

Update any coupon field — discount, expiry, restrictions, usage limits.

wc\_delete\_coupon

Move a coupon to trash or force-delete it entirely.

wc\_empty\_coupon\_trash

Permanently delete every trashed coupon in one call.

## Customers & Stats (2 tools)

wc\_get\_customers

List customers with order count and lifetime spend.

wc\_get\_store\_stats

Revenue, order count, average order value by period (day / week / month).

## 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.

[Free Skill

WooCommerce Claude Skill

Drop-in Claude Skill: knows the standard WooCommerce workflows, the order-status lifecycle, common attribute patterns, and the coupon-restriction gotchas.](https://royalplugins.com/skills/woocommerce-claude-skill/)

## 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.

[Pro Reference

WooCommerce Bulk Tools

Bulk price updates (regular and sale), bulk stock adjustments, bulk product field updates, bulk order status changes, bulk category assignments, bulk product deletion — each with a per-batch undo token.](https://royalplugins.com/support/royal-mcp-pro/woocommerce-bulk-tools/)
[Deep Dive

Bulk Price Updates with Undo

End-to-end walkthrough of a store-wide sale campaign: preview the sweep, apply the change, roll it back cleanly after the sale ends. Covers the undo-token flow and the gotchas around regular-vs-sale price fields.](https://royalplugins.com/support/royal-mcp-pro/bulk-price-updates-with-undo/)

## 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.

Free tools operate one object at a time

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.

HPOS & legacy orders

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.

[Back to Royal MCP Support](https://royalplugins.com/support/royal-mcp/)
[Divi Tools Reference](https://royalplugins.com/support/royal-mcp/divi-tools/)
