WooCommerce MCP tools for AI agents

List WooCommerce products with status/search/pagination filters.

Get detailed information for a single WooCommerce product.

Create a WooCommerce product.

Update an existing WooCommerce product.

Duplicate a WooCommerce product to a draft copy.

List WooCommerce product categories.

Get detailed information for a single WooCommerce product category.

Create a WooCommerce product category.

Update a WooCommerce product category.

Delete a WooCommerce product category.

List WooCommerce product tags.

Get detailed information for a single WooCommerce product tag.

Create a WooCommerce product tag.

Update a WooCommerce product tag.

Delete a WooCommerce product tag.

List WooCommerce orders.

Get detailed information for a single WooCommerce order.

Update WooCommerce order status.

Get inventory overview with low-stock and out-of-stock counts.

Update stock quantity or stock status for a product.

Deprecated compatibility alias for woocommerce_revenue_summary. Retained for two minor releases.

Bounded HPOS-compatible revenue summary with currency, store timezone, exact date boundaries, included statuses, pagination coverage, and explicit gross/discount/refund/tax/shipping/net definitions.

Revenue timeseries grouped by day, week, or month in the WooCommerce store timezone.

Rank products by bounded net sales with quantity, gross sales, net sales, and order counts.

Order count, status distribution, revenue metrics, coverage, currency, timezone, and date definitions.

Privacy-safe active, repeat-in-range, one-time, and guest customer counts. Never returns names or emails.

Read sanitized WooCommerce currency, timezone, tax, units, checkout, page, and HPOS configuration. Credentials and secrets are never returned.

List payment gateway IDs, public titles, enabled state, and supported features without settings, credentials, or tokens.

List WooCommerce shipping zones, locations, and public method state.

List WooCommerce tax rates for a tax class without exposing sensitive configuration.

List native WooCommerce webhooks. Secrets are never returned.

Read one native WooCommerce webhook without its secret.

Create a native WooCommerce webhook. Requires an approval-token round trip, an allowlisted topic, and a public HTTPS target. Secret is write-only.

Update a native WooCommerce webhook through an approval-token round trip. Targets must remain HTTPS and secrets remain write-only.

Delete a native WooCommerce webhook through an approval-token round trip.

Send a rate-limited redacted test payload to a webhook target through an approval-token round trip. Test payloads are not stored.

List product brands (WooCommerce 9.4+ product_brand taxonomy).

Get a single product brand.

Create a product brand.

Update a product brand.

Delete a product brand.

List products with advanced filters: category, tag, stock status, on-sale, featured, price range.

Find products by natural-language query across titles, descriptions, SKUs, and categories, ranked by relevance.

Audit the catalog: missing images, thin descriptions, uncategorized products, missing prices, stock inconsistencies. Returns a 0-100 health score.

Update up to 100 products in one call (name, descriptions, status, featured, visibility). Snapshots before/after; dry_run supported.

Bulk-change prices (percentage, absolute delta, or set value) for up to 100 products by IDs or category. Snapshots; dry_run supported.

Schedule sale prices with start/end dates for up to 100 products. Snapshots; dry_run supported.

Revert a product\

Set, increase, or decrease stock for up to 100 products in one call. Snapshots; dry_run supported.

List products at or below a stock threshold (defaults to the WooCommerce low-stock setting), sorted by urgency.

Analyze the shop page: product grids, hierarchy score, issues, recommendations. Works on a block theme by reading the native archive-product template (Product Collection / Product Template blocks), and falls back to the page-builder layer on builder-built shops. A pure FSE storefront is supported, not a fallback.

Quality-score a single product page: images, gallery, description depth, price, category.

Change product grid layout (columns, rows, ordering) on archive pages. On a block theme this edits the native archive-product template by exact block path, fingerprint-guarded and verified after the write; on builder-built shops it falls back to the page-builder layer. Snapshots; dry_run supported.

Preview or add a low-stock badge to WooCommerce product cards. Block themes only: this writes into the native archive-product template and has no page-builder path. Use dry_run=true to inspect affected products without writing. A non-dry-run call succeeds only after the badge is inserted and verified; an unsupported template returns an explicit error and never reports a false success.

Preview or add a sale badge to WooCommerce product cards. Block themes only: this writes into the native archive-product template and has no page-builder path. Requires the WooCommerce sale-badge block to be registered on the site. Use dry_run=true to inspect on-sale products. A non-dry-run call succeeds only after the template is changed and verified; an unsupported template returns an explicit error without mutation.

Report the field composition of the WooCommerce product card on a block theme: which canonical blocks it is built from (woocommerce/product-image, product-title, product-price, product-button, and so on), their exact block paths, and their render order. Read-only. Call this before update_storefront_card_field so you address a field that actually exists.

Set attributes on one named field of the WooCommerce product card, addressed by its CANONICAL block name (for example woocommerce/product-image or woocommerce/product-price), on a block theme. Requested attributes are intersected with the attributes the installed block actually registers, so an unknown key is refused rather than written and reported as success. Snapshot, fingerprint guard, dry_run and render verification all apply.

Preview or apply targeted checkout layout changes. Use dry_run=true first. The tool never reports success for intent-only or no-op writes; unsupported layouts return respira_woo_fse_write_not_supported without changing checkout content.

Set global (taxonomy) or custom attributes on a product; missing terms are created. Mark variation: true to use for variations. Snapshots.

Create all missing variations from the product\

Create one variation with explicit attribute values, price, SKU, stock, and image. Snapshots.

Create a global product attribute with terms. Supports the WooCommerce 10.9 wc-visual type for per-term color/image swatches.

Set a variation\

List coupons with optional search.

Create a coupon: percent or fixed discount, expiry, usage limits, product and email restrictions.

Update any coupon field by coupon ID.

Create a WooCommerce customer with optional billing/shipping addresses. Passwords auto-generate when omitted and are never returned.

Update a customer\

Add a note to an order. Private by default; customer_note: true emails the customer.

List refunds on an order with total refunded and remaining refundable amounts.

Refund an order. DRY-RUN BY DEFAULT: pass dry_run: false to execute. Gateway money movement is opt-in via refund_payment: true.

List WooCommerce Subscriptions, filterable by status, customer, or product. Requires the WooCommerce Subscriptions extension on the site.

Get one subscription with items, dates, and payment method.

Pause (on-hold), reactivate, or cancel a subscription. DRY-RUN BY DEFAULT: pass dry_run: false to apply. Transitions are validated against Subscriptions rules; snapshots taken.

Move a subscription\

Add a note to a subscription. Private by default; customer_note: true emails the customer.

List WooCommerce Bookings, filterable by status or product. Requires the WooCommerce Bookings extension on the site.

Get one booking with times, persons, resource, and order linkage.

Confirm, mark paid, complete, or cancel a booking. DRY-RUN BY DEFAULT: status changes can trigger customer emails.

Move a booking to a new time window. DRY-RUN BY DEFAULT with a conflict scan against other bookings on the same product; overlapping windows need force: true.

All membership plans with member counts. Requires the WooCommerce Memberships extension on the site.

List user memberships, filterable by plan, customer, or status.

Get one user membership with plan, dates, and order linkage.

Pause, resume, or cancel a member\

Move or clear a membership\

Create a signed multi-item cart URL for a shopper: their cart fills server-side and they land on this store\

Orders and revenue that arrived through agent cart links over a period, with a per-source breakdown.

Which product configurator is active (STAGGS) plus how many products and attribute groups use it. Start here before any configurator work.

Read a product's STAGGS configurator state: the enabled flag and all sgg_ meta (steps, attributes, themes).

Enable or disable the STAGGS configurator on a product. Supports dry_run. Snapshots the product before and after.

List STAGGS attribute groups (the reusable option sets a configurator is built from): id, title, type.

Read a STAGGS attribute's option items. The workflow is read, edit the returned array, then write it back with set_configurator_attribute_items, so STAGGS' internal sub-field names never have to be guessed.

Replace a STAGGS attribute's option items, written through the STAGGS/Carbon Fields helpers so storage stays consistent. Supports dry_run. Snapshots the attribute.

Read allow-listed options and post meta for a known third-party plugin (currently: staggs). Keys outside the allow-list are ignored on read.

Write allow-listed options and post meta for a known third-party plugin (currently: staggs). Any key outside the allow-list refuses the whole request. Supports dry_run. Snapshots the post.

The catalog AI-readiness scan as an ordered work queue: weakest products first, each failing check paired with the tool and params that fix it. Work it top-down to raise the catalog score.

Set alt text on a product\

Read or update product feed settings (formats, cadence, countries, llms.txt) and get the public feed URLs. Call with no params to read.

Build the enabled product feeds now (batched in the background; the first batch runs immediately, so this works even when wp-cron is dead). Idempotent while a build is running.

Per-format feed URLs, row counts, generation times, running build progress, Action Scheduler health, last successful build, pending/failed/overdue actions, and stale-lock state. This tool is read-only.

Safely clear a confirmed-stale Respira feed lock and idempotently resume the existing build. Does not delete Action Scheduler history. Returns a verified mutation envelope; returns a non-success response when no stale lock exists.

Check a catalog sample against one feed format\

Map WooCommerce product categories to Google product categories for the feeds. Call with no params to list mapped and unmapped categories with product counts.

Score how well one product is described for AI shopping assistants: description depth, images/alt text, price, SKU, GTIN, brand, attributes, availability.

Score the whole catalog for AI shopping readiness: average score, distribution, top issues, weakest products.