> ## 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 account, 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 account, complete verification, and shop through the buy agent — with no browser OAuth. The pattern for an agent that texts (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"
  }
}
```


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