List coupons
Coupons with code, discount, usage count, limit and expiry date.
MCP tool woocommerce_read → list_coupons
read
Lists coupons with the code, discount type, amount, how many times each was used, its usage limit and its expiry date. Search by text or look up an exact code before you create one. Coupon codes are not case-sensitive in WooCommerce.
Parameters
| Name | Type | Description |
|---|---|---|
| code string | string | Exact coupon code. |
| search string | string | Text in the coupon code. |
| limit integer | integer | Results per page. Default: 10. |
| page integer | integer | Page number, starting at 1. Default: 1. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "woocommerce_read",
"arguments": {
"operation": "list_coupons",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"coupons": [
{
"coupon_id": 2201,
"code": "welcome10",
"discount_type": "percent",
"amount": "10",
"usage_count": 41,
"usage_limit": 500,
"date_expires": "2026-12-31"
}
],
"total": 1,
"total_pages": 1
},
"isError": false
}