add_funds

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

{
  "tool": "add_funds",
  "arguments": {
    "amount_cents": "\u2026"
  }
}

MCP

Organization tools

User tools

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call