> ## 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_code

> Redeem a promo code that adds money to the user's cash balance.

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

**Behavior:** idempotent.

## What it does

Redeem a promo code that adds money to the user's cash balance. Each code works once per user; the credit lands in the balance and becomes spendable within a minute or two. Some codes hold the money until the user verifies their identity — the claim still locks the code to this user instantly, and the credit lands automatically once KYC is approved (start\_kyc begins verification). The gated tool list\_codes shows the user's code history; call it by name even though it isn't in the tools list.

## Inputs

| Field               | Type   | Description                                                                    |
| ------------------- | ------ | ------------------------------------------------------------------------------ |
| `code` *(required)* | string | The promo code exactly as the user provided it (case and dashes are forgiven). |

## Returns

| Field                  | Type   | Description                         |
| ---------------------- | ------ | ----------------------------------- |
| `message` *(required)* | string | Human-readable result or next step. |

## Example call

```json theme={null}
{
  "tool": "redeem_code",
  "arguments": {
    "code": "\u2026"
  }
}
```