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

# get_rewards

> Show the user's tokenback: balance, lifetime earned, and recent activity.

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

**Behavior:** read-only, idempotent.

## What it does

Show the user's tokenback: balance, lifetime earned, and recent activity. Tokenback pays tokens (1 token = 1¢ of credit value) on settled card spend. The boosted rate is earned on an AI card, one created with the `ai_labs` preset or a software and AI rule in either mode, and only on its charges at software and AI vendors. Every other charge on a personal card earns the normal rate. Cards funded by a company earn no tokenback from Agentcard; the company shares its own earnings with its users instead. Redeem with redeem\_rewards.

## Inputs

None.

## Returns

| Field | Type | Description |
| - | - | - |
| `message` *(required)* | string | Human-readable summary. |
| `balanceTokens` | number | Current token balance (1 token = 1 cent). |
| `lifetimeEarnedTokens` | number | Tokens earned all-time. |
| `redeemedTokens` | number | Tokens redeemed all-time. |
| `minRedeemTokens` | number | Minimum tokens per redemption. |

## Example call

```json theme={null}
{
  "tool": "get_rewards",
  "arguments": {}
}
```


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