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; 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
  --categories <list>      Restrict to categories, comma-separated: 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
  --currencies <codes>     Restrict to purchase currencies, 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
  --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
  --mode <mode>            What the preset does when a purchase breaks a rule:
                           strict refuses it (default), watch lets it through
                           and tells you
  -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 --categories. Use one or the other; the command refuses both together. --preset ai_labs makes a multi-use card, and --multi-use beside it changes nothing. A multi-use card with a category rule on a strict preset 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 --categories <list> --mode watch. Say which currencies the card may pay in:

agent-cards cards create --amount 50 --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, add --mode watch to the preset; pass one of the two, not both:

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

Agentcard checks this rule at checkout and at settlement; the card network does not. 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 --mode watch for a multi-use card, or drop the category rule.

--multi-use can also be refused with multi_use_limit_reached, before any card is issued. A multi-use card holds its whole limit as collateral for as long as it stays open, so an account can have a limit on how many it may keep open, and the message on stderr names the allowance in effect. Run agent-cards plan to read it: the Multi-use row shows a number, or shows the allowance as unlimited, in which case this refusal does not apply. Where the allowance is a number, close a multi-use card you no longer need, or drop --multi-use for a single-use card. 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 --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 category rule on a strict preset 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 --categories software,ai --mode 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

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