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

> The user's hosted wallet, as one shareable URL.

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

## What it does

The user's hosted wallet, as one shareable URL. Opens their Agentcard wallet in the browser: every card in one place, apply for an Agentcard card (identity verification runs right in the page). Mint it whenever the user needs a browser step (seeing cards, finishing verification when in-chat photos fail) and send them the URL. To ADD the user's own card, pass purpose "add\_card": the link then opens their Agentcard vault card form directly (any card, typed once, locked with Face ID, never seen by Agentcard) and works on personal logins too. Pass merchant + amount\_cents to open the wallet ON the payment-approval sheet (the user picks a card and approves that exact charge) instead of the card list. Multi-use but short-lived (about 15 minutes — the exact moment is in expiresAt); mint a fresh one when it expires. The wallet link only works for app connections (OAuth).

## Inputs

| Field          | Type                          | Description                                                                                                                                                 |
| -------------- | ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `purpose`      | string: `wallet` · `add_card` | "wallet" (default) opens the hosted wallet. "add\_card" opens the vault card form so the user can put their own card on file; single-use, about 15 minutes. |
| `merchant`     | string                        | Merchant name shown on the payment-approval sheet (with amount\_cents).                                                                                     |
| `amount_cents` | integer                       | Amount in cents. When present, the link opens on the payment-approval sheet for this charge.                                                                |

## Returns

| Field                  | Type    | Description                                                                                                                                                                               |
| ---------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message` *(required)* | string  | Ready-to-send sentence containing the URL.                                                                                                                                                |
| `url`                  | string  | The hosted wallet URL to share with the user.                                                                                                                                             |
| `kind`                 | string  | purpose add\_card only: how the vault link signs the user in. "connected" = a one-time code to their own phone or email; "handoff" = directly; "open" = Face ID setup or passkey sign-in. |
| `expiresAt`            | string  | ISO time the link stops working.                                                                                                                                                          |
| `sandbox`              | boolean | True when the connection is in test mode.                                                                                                                                                 |

## Example call

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