Royal MCP’s WooCommerce Tools — Reference

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.

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.

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.