Tools Catalog / WooCommerce tools / wc_get_coupon_count

wc_get_coupon_count tool reference for StifLi Flex MCP

Read-only
Group CouponsCapability manage_woocommerce

counts coupons by status (`publish`, `draft`, `pending`, `private`, `future`, `trash`) or returns totals for all statuses.

Description

counts coupons by status (`publish`, `draft`, `pending`, `private`, `future`, `trash`) or returns totals for all statuses.

What it is for

  • Monitoring promotion inventory by lifecycle state.
  • Verifying trash behavior after logical deletes.

Example use case

trash verification.

Sample prompt

Count coupons with status trash so I can confirm whether a logical delete moved the coupon to trash.

Sample response

{
  "tool": "wc_get_coupon_count",
  "status": "ok",
  "items": []
}

What does wc_get_coupon_count do?

counts coupons by status (`publish`, `draft`, `pending`, `private`, `future`, `trash`) or returns totals for all statuses.

Does wc_get_coupon_count modify store data?

No. It is a read-only operation and does not modify commerce data or settings.

Which capability is commonly required?

It usually runs under controls compatible with manage_woocommerce and the active MCP profile.

How should wc_get_coupon_count be used safely?

Limit scope with filters and pagination to reduce overexposure of data.