agent-cards cards create

Fund and issue a new virtual card

agent-cards cards create --help

Usage: agent-cards cards create [options]

Fund and issue a new virtual card

Options:
  --amount <dollars>         Amount in US dollars, NOT cents (e.g. 25 = $25.00)
  --multi-use                Create a multi-use card: stays open across charges
                             until its limit is spent (subscriptions)
  --preset <name>            Restrict this card (see cards preset list). Adds
                             limits only. Omit to use your account or app
                             preset.
                             (ai_labs implies --multi-use)
  --expires <iso>            Auto-close the multi-use card at this ISO-8601
                             time (≤365 days out), e.g. 2027-01-01T00:00:00Z
  --from <source>            Where the money comes from: an added-card id (see
                             add --list), or 'balance' to use your Agentcard
                             balance even when a card is added
  -y, --yes                  Skip the confirmation prompt (for non-interactive
                             / agent use)
  --json                     Output the result as JSON and run fully
                             non-interactively
  --total <dollars>          Lifetime spend cap in US dollars
  --per-day <dollars>        Spend cap per rolling 24 hours, in US dollars
  --per-week <dollars>       Spend cap per rolling 7 days, in US dollars
  --per-month <dollars>      Spend cap per rolling 30 days, in US dollars
  --only-categories <list>   Restrict to categories (strict), comma-separated:
                             meals, groceries, travel, software, ai, wellness,
                             retail
  --watch-categories <list>  Categories in Watch mode (allow + notify on
                             mismatch): meals, groceries, travel, software,
                             ai, wellness, retail
  --only-merchants <list>    Restrict to merchant name patterns,
                             comma-separated
  --only-in <places>         Restrict to places, comma-separated: a country
                             (US, Canada), a region (europe, eu,
                             north-america, apac), a US state (California,
                             US-CA). A region expands to its countries; a
                             state next to a region narrows only the US,
                             e.g. north-america,US-CA
  --only-currencies <codes>  Restrict to purchase currencies (strict),
                             comma-separated ISO 4217 codes or names: usd,eur
                             or dollars,euros,pounds,yen. Checked by Agentcard
                             at checkout and settlement, not by the card
                             network
  --watch-currencies <codes> Purchase currencies in Watch mode (allow + notify
                             on mismatch), comma-separated: usd,eur. Checked
                             by Agentcard, not by the card network
  --only-days <days>         Restrict to days, comma-separated: mon,tue or
                             weekdays/weekends
  --only-hours <range>       Restrict to an hour range, e.g. 9-17 or
                             09:00-17:00 (24-hour; defaults to UTC without
                             --timezone)
  --timezone <tz>            IANA timezone for --only-days/--only-hours
                             (default UTC), e.g. America/Los_Angeles
  --only-from <programs>     Restrict to callers, comma-separated: cli, mcp,
                             api, browser
  -h, --help                 display help for command

Pass --preset <name> to put a saved or built-in set of rules on the card, or spell the rules out with flags such as --total, --per-day, and --only-categories. Use one or the other; the command refuses both together. Pass neither and the card inherits your app default, then your account default. --preset ai_labs makes a multi-use card, and --multi-use beside it changes nothing. A multi-use card with a Strict category is refused with strict_category_multi_use_unsupported, because the card network cancels such a card after its first charge. Use a single-use card, or --watch-categories. The rules are explained in Set rules on a card; the account and app defaults in cards preset. Say which currencies the card may pay in:

agent-cards cards create --amount 50 --only-currencies usd,eur -y

A charge in any other currency is refused, and you are told why. Write codes or plain names in any case, comma-separated: usd,eur or dollars,euros. If you would rather be told than refused, use --watch-currencies with the same list; pass one of the two, not both:

agent-cards cards create --amount 20 --watch-currencies usd --multi-use -y

Agentcard checks this rule at checkout and at settlement; the card network does not. Which names are refused as ambiguous, and what happens after the charge, are in Choose the currencies. The card shows the rule on its Preset line, and a Network line says who enforces it. Captured from a local sandbox:

  Card    •••• 4277
  Expires 09/28
  Balance $20.00
  ID      cmttoum4z0003jpk0ugxz6bkx
  Preset  Currency: USD, EUR.
  Network Agentcard enforces the currency rule at checkout and settlement; the card network does not

A refused create writes one line to stderr, the code first, and exits 1. Captured from a local sandbox:

Error: strict_category_multi_use_unsupported: Multi-use cards with a strict category rule are not available yet: the card network closes a category-restricted card after its first approved charge. Create a single-use card, use Watch (--watch-categories) for a multi-use card, or drop the category rule.

If you write a name that means several currencies, the create is refused before any card is issued, and the message lists what it could mean. agent-cards cards create --amount 20 --only-currencies pesos -y answers:

Error: policy_invalid: "pesos" could be MXN, ARS, CLP, COP, or PHP. Write the currency code, or name the country (Mexican pesos).

Inside the deprecation window a reusable ai_labs card is created and carries the notice:

Multi-use card with preset
Preset: ai_labs
This card stays open across charges until its limit is spent — good for subscriptions.

- Creating card...
✔ Virtual card issued!

  Card    •••• 4454
  Expires 09/28
  Balance $40.00
  ID      cmtta6zne000ubrknm8imiu5n
  Preset  Categories: Software, AI vendors. Rewarded merchants: OPENAI, CHATGPT, ANTHROPIC, CLAUDE, GEMINI, GOOGLE AI.
  Notice  From 2026-10-08 a reusable card with a Strict category can no longer be created, this AI card included: the card network cancels such a card after its first approved charge. Cards already created keep working. For a reusable AI card after that date use --watch-categories software,ai (Watch); for a strict one, create a single-use card.

Run: agent-cards cards details cmtta6zne000ubrknm8imiu5n  # to see full PAN/CVV
The card draws on your balance when used.
It stays open until its limit is spent. Manage it with `agent-cards cards pause/resume`.

CLI

Auth

Cards

Wallet and balance

Payment methods

Plan

Buy

Identity and rewards

Connections and approvals

Settings and tools

For coding agents

Engineer

Companies

Companies: credentials

Companies: balance

Companies: webhooks

agent-cards cards create