WooCommerce Bulk Tools

Prerequisites

• WooCommerce active on the site
• Royal MCP Pro installed and licensed (see Getting Started)
• MCP client connected to your site
• manage_woocommerce capability for the acting user — standard WC shop-manager or admin role

For wc_bulk_delete_products against products backing WC Subscriptions, the plugin auto-detects and refuses unless you explicitly pass force_delete_subscriptions: true.

Shared safety layer

Every WC bulk tool ships the standard Pro safety envelope plus category-specific guards:

• Dry-run support on 4 of 6 tools (wc_bulk_price_update, wc_bulk_update_products, wc_bulk_update_stock) — pass dry_run: true to preview matches + planned changes without writing.
• Two-step confirm on wc_bulk_delete_products above 10 products. First call returns a preview + confirm_token; second call must echo the token back. This prevents an AI from accidentally deleting your catalog on the first request.
• Active-subscriptions guard on wc_bulk_delete_products. If any target product backs a live WC Subscription, the tool refuses with a specific error unless force_delete_subscriptions: true is passed. Deleting a subscription product means the next billing cycle for subscribers on it will hit missing-product.
• Notification suppression DEFAULT ON for order updates. wc_bulk_update_orders suppresses customer-facing status-change emails by default across the whole batch — bulk-updating 500 orders would otherwise fire 500 emails. Opt into emails with suppress_notifications: false.
• Whitelisted product fields on wc_bulk_update_products. Only name, description, short_description, status, sku, catalog_visibility can be updated in bulk — other fields require single-item WC tools for safety.
• 72-hour undo on every destructive tool. Undo handlers restore per-product state (prior prices, prior product state, prior stock, prior category assignments, prior order statuses).
• Audit Log row on every call — both dry-run and commit runs.

The 6 tools

Bulk update prices with wc_bulk_price_update — apply 12% off across products 42, 108, 143, and 227. Do a dry run first, then commit.

Ask AI: "Delete products 42, 108, 143, 227, 331, 442, 508, 619, 727, 831, 942, 1054 with wc_bulk_delete_products."

First response's structuredContent includes a preview + confirm_token, e.g.:
  {
    "count": 12,
    "threshold": 10,
    "confirm_token": "<opaque token string>",
    "expires_in": 300,
    "preview": [
      { "id": 42, "name": "Widget A", "sku": "WDG-A", "price": "19.99", "image": "https://..." },
      { "id": 108, "name": "Widget B", "sku": "WDG-B", "price": "24.99", "image": "https://..." },
      ...
    ]
  }

The token has a 5-minute TTL (expires_in: 300 seconds). Have your AI echo the token back in a second call:

Ask AI: "Confirm the delete with that confirm_token."
Second call executes the delete.

Related documentation

• Bulk Price Updates + Undo workflow — end-to-end flagship guide for sale-campaign scenarios
• Undo Tokens explainer — how to consume the tokens returned by every write tool

Still Stuck? Two-Step Support Path

If a WC bulk tool isn't behaving the way you expected, work through these two steps in order — most tool-level failures resolve at Step 1 because they're actually MCP-connection or host-layer issues, not WC-specific.

Step 1: Start with the Royal MCP Troubleshooting Guide

Royal MCP Troubleshooting — Start Here covers MCP-layer issues. If Claude can't reach your site at all, the tool call never fires — that guide is where to start.

For Pro-specific patterns:

• Undo token errors — expired, consumed, or handler missing
• Pro tool returned upgrade prompt with valid license

Step 2: Email priority support

If you've worked through Start Here and the relevant Pro-specific doc and the issue still isn't resolved, email priority support from your purchase email address at support@royalplugins.com. Priority email support is included with your license — typical response within 24 hours. Never include your license key in email; we look it up from your purchase address.