> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# redeem_rewards

> Redeem tokenback: the tokens' cash value (1 token = 1¢) lands on the user's rewards card as spending power.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

## What it does

Redeem tokenback: the tokens' cash value (1 token = 1¢) lands on the user's rewards card as spending power. The rewards card is permanent and locked to AI-lab merchants (OpenAI, Anthropic, Gemini) — created on first redemption, topped up after. Check get\_rewards first for the balance and the minimum. Ask the user before redeeming.

## Inputs

| Field | Type | Description |
| - | - | - |
| `tokens` *(required)* | number | How many tokens to redeem (1 token = 1 cent, so 500 tokens = \$5.00 of account credit). |

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | Human-readable result. |
| `status` | string | "redeemed" on success; an error discriminator otherwise (e.g. "below\_minimum", "insufficient\_tokens", "redemption\_in\_progress"). |
| `redemptionId` | string | The redemption ID. Present when status is "redeemed". |
| `amountCents` | number | Account credit in cents. Present when status is "redeemed". |
| `deliveredCardId` | string | Rewards card the value landed on, when delivery completed inline. Absent = the value sits as account credit (it reaches the rewards card within a few minutes when delivery is enabled). |
| `deliveredCardLast4` | string | Last 4 digits of the rewards card, when delivered inline. |

## Example call

```json theme={null}
{
  "tool": "redeem_rewards",
  "arguments": {
    "tokens": "\u2026"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.