Home / Servers / Stripe API / get_promotion_codes
List all promotion codes
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
List all promotion codes Returns a list of your promotion codes. [GET /v1/promotion_codes]
Name on the gateway: stripe_api__get_promotion_codes · read-only.
Parameters
| Name | Type | Description |
|---|---|---|
active | boolean | Filter promotion codes by whether they are active. |
code | string | Only return promotion codes that have this case-insensitive code. |
coupon | string | Only return promotion codes for this coupon. |
created | object | A filter on the list, based on the object created field. The value can be a… |
customer | string | Only return promotion codes that are restricted to this customer. |
customer_account | string | Only return promotion codes that are restricted to this account representing… |
ending_before | string | A cursor for use in pagination. ending_before is an object ID that defines… |
expand | array | Specifies which fields in the response should be expanded. |
limit | integer | A limit on the number of objects to be returned. Limit can range between 1 and… |
starting_after | string | A cursor for use in pagination. starting_after is an object ID that defines… |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "stripe_api__get_promotion_codes",
"arguments": {}
}Or connect the Stripe API server directly, which lists 606 tools including this one:
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the list all promotion codes tool with active set to ….