> ## 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 wallet 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 | Wallet 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 wallet 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"
  }
}
```