Redeem coupon
Attach a coupon to an account before or after a subscription.
MCP tool recurly_write → redeem_coupon
write Confirm
Redeems a coupon code for one account. Recurly holds the redemption on the account and applies it at the next subscription creation, change or renewal, so it changes what the customer pays. Returns the total discounted so far and the currency. A wrong code or currency fails with a validation error. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| account_code string required | string | Account code from list_accounts. |
| coupon_code string required | string | Coupon code as created in Recurly. |
| currency string | string | Currency of the redemption, for example USD. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "recurly_write",
"arguments": {
"operation": "redeem_coupon",
"arguments": {
"account_code": "account code",
"coupon_code": "coupon code"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"account_code": "north-yard",
"coupon_code": "WINBACK20",
"currency": "USD",
"total_discounted_in_cents": 0,
"created_at": "2026-10-14T10:31:00Z"
},
"isError": false
}