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

# list_cards

> The user's wallet: every live card they hold, with IDs, last four digits, expiry, balance, and status, plus `vaultCards`: the user's OWN cards stored in their…

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 wallet: 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 a Face ID approval and never exposes a number). Start here to find available cards; if none are returned, call create\_card. When the shared wallet is enabled, `wallet` lists every card across all connected apps and companies, each tagged with its source (kind personal/company, the issuing app, and the company where applicable); 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.                                                                                                                                                                             |
| `wallet`               | array  | One-wallet view (present when the shared wallet is enabled): every LIVE card across personal and company sources, each tagged with its provenance. Closed cards are excluded; transactions carry history. |
| `vaultCards`           | array  | The user's own cards stored in their Agentcard vault. Display fields only; they pay through buy with a Face ID approval and never expose a card number.                                                   |
| `connectedAccounts`    | array  | Read-only cards issued and managed by an organization the user is linked to.                                                                                                                              |

## Example call

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