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

# add_funds

> Generate a secure checkout link the user opens to add cash to their own balance (the money that funds new cards) via Apple Pay or Google Pay, in USD.

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

## What it does

Generate a secure checkout link the user opens to add cash to their own balance (the money that funds new cards) via Apple Pay or Google Pay, in USD. Calling this tool moves NO money and initiates NO transfer: it only prepares a single-use hosted payment page — the exact equivalent of the user clicking 'Add funds' in the dashboard. The user personally reviews, authorizes, and completes (or abandons) the payment in their own browser with their own payment method; you never see or handle payment credentials. If a one-time phone verification is needed first, this tool automatically sends the user a code and tells you where it went: ask the user for the code, call verify\_phone with it, then call add\_funds again.

## Inputs

| Field                       | Type                               | Description                                                                                                                                                                                                                |
| --------------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `amount_cents` *(required)* | number                             | Amount to add in cents (e.g. 5000 = \$50.00). Typical range: \$20.00 to \$10,000.00 (2000 to 1000000 cents); the exact range depends on the active funding provider and is returned by the API when the amount is invalid. |
| `payment_method`            | string: `apple_pay` · `google_pay` | Payment method for the checkout. Defaults to apple\_pay.                                                                                                                                                                   |

## Returns

| Field                  | Type   | Description                                                                              |
| ---------------------- | ------ | ---------------------------------------------------------------------------------------- |
| `message` *(required)* | string | Human-readable result or next step.                                                      |
| `checkoutUrl`          | string | Single-use payment link to hand the user verbatim (present when a checkout was created). |
| `amountUsd`            | string | Amount of the created checkout in USD.                                                   |

## Example call

```json theme={null}
{
  "tool": "add_funds",
  "arguments": {
    "amount_cents": "\u2026"
  }
}
```