Home / Servers / Stripe API / post_coupons

Create a coupon

An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.

Create a coupon You can create coupons easily via the coupon management page of the Stripe dashboard. Coupon creation is also accessible via the API if you need to create coupons on the fly. A coupon has either a… [POST /v1/coupons]

Name on the gateway: stripe_api__post_coupons · may change things.

Parameters

NameTypeDescription
amount_offintegerA positive integer representing the amount to subtract from an invoice total…
applies_toobjectA hash containing directions for what this Coupon will apply discounts to.
currencystringThree-letter ISO code for the currency of the amount_off parameter (required…
currency_optionsobjectCoupons defined in each available currency option (only supported if…
durationforever | once | repeatingSpecifies how long the discount will be in effect if used on a subscription.…
duration_in_monthsintegerRequired only if duration is repeating, in which case it must be a positive…
expandarraySpecifies which fields in the response should be expanded.
idstringUnique string of your choice that will be used to identify this coupon when…
max_redemptionsintegerA positive integer specifying the number of times the coupon can be redeemed…
metadataobjectSet of key-value pairs that you can attach to an object. This can be useful…
namestringName of the coupon displayed to customers on, for instance invoices, or…
percent_offnumberA positive float larger than 0, and smaller or equal to 100, that represents…
redeem_byintegerUnix timestamp specifying the last time at which the coupon can be redeemed…

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:

call_tool arguments
{
  "name": "stripe_api__post_coupons",
  "arguments": {}
}

Or connect the Stripe API server directly, which lists 606 tools including this one:

Run in your terminal
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 create a coupon tool with amount_off set to ….

More from Stripe API