list_cards

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: read-only, idempotent.

What it does

The user’s cards: every live card they hold, with IDs, last four digits, expiry, balance, and status, plus vaultCards: the user’s OWN cards stored in their Agentcard vault (display fields only; a vaulted card pays through buy with an approval on the user’s device (their passkey or master password) and never exposes a number). Start here to find available cards; if none are returned, call create_card. Cards created by another app or company are read-only from this session: get_card_details and close_card will not work on them.

Inputs

None.

Returns

Field	Type	Description
`message` (required)	string	Human-readable list of cards (or an empty-state message).
`count`	number	Total number of cards across the user’s own cards and any connected-account cards.
`cards`	array	The user’s own virtual cards.
`vaultCards`	array	The user’s own cards stored in their Agentcard vault. Display fields only; they pay through buy with an approval on the user’s device (their passkey or master password) and never expose a card number.
`connectedAccounts`	array	Read-only cards issued and managed by an organization the user is linked to.

Example call

{
  "tool": "list_cards",
  "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