Tools Catalog / WooCommerce tools / wc_delete_coupon

wc_delete_coupon tool reference for StifLi Flex MCP

Write
Group CouponsCapability manage_woocommerce

deletes a coupon by ID. With `force=false`, it attempts to move the coupon to trash first; with `force=true`, it permanently deletes it.

Description

deletes a coupon by ID. With `force=false`, it attempts to move the coupon to trash first; with `force=true`, it permanently deletes it.

What it is for

  • Retiring promotions with optional trash-first behavior.
  • Permanently deleting coupons when required.

Example use case

retiring an old coupon.

Sample prompt

Delete coupon ID 73 with force=false so it is moved to trash when available.

Sample response

{
  "tool": "wc_delete_coupon",
  "status": "ok",
  "updated": true
}

What does wc_delete_coupon do?

deletes a coupon by ID. With `force=false`, it attempts to move the coupon to trash first; with `force=true`, it permanently deletes it.

Does wc_delete_coupon modify store data?

Yes. It is a write operation and can create, update, or delete data depending on arguments.

Which capability is commonly required?

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

How should wc_delete_coupon be used safely?

Enable write confirmations, test in staging first, and keep changelog/rollback enabled.