get_wallet_link

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

{
  "tool": "get_wallet_link",
  "arguments": {}
}

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