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

# mint_buy_token

> Create a scoped 30-day token that lets this cardholder's agent act as THAT ONE USER — add balance to their wallet, complete verification, and shop through the…

Connect to `https://mcp.agentcard.sh/mcp` with your **organization credential** (`client_id` + `client_secret`, or the org access token).

## What it does

Create a scoped 30-day token that lets this cardholder's agent act as THAT ONE USER — add balance to their wallet, complete verification, and shop through the buy agent — with no browser OAuth. The pattern for messaging surfaces (iMessage, SMS, WhatsApp): store the token keyed by your user and reuse it; create a fresh one any time.

## Inputs

| Field                        | Type   | Description       |
| ---------------------------- | ------ | ----------------- |
| `cardholder_id` *(required)* | string | The cardholder id |

## Returns

| Field                  | Type   | Description                                     |
| ---------------------- | ------ | ----------------------------------------------- |
| `message` *(required)* | string | Human-readable summary.                         |
| `buyToken`             | string | Bearer token for the user's agent (30-day TTL). |
| `agentcardUserId`      | string | The linked end-user id.                         |
| `expiresAt`            | string | ISO 8601 expiry.                                |

## Example call

```json theme={null}
{
  "tool": "mint_buy_token",
  "arguments": {
    "cardholder_id": "\u2026"
  }
}
```