Quickstart

This walks through the full Personal flow — from zero to a working virtual card your agent can use. The agent-cards CLI is the fastest way to get started. Install it and sign up — we email you a one-time code to verify your address:

npm install -g agent-cards
agent-cards signup

Enter the code from your email to finish signing in. Check who you’re signed in as any time with agent-cards whoami.

Prefer to drive everything from your agent? Skip to Connect the MCP server — the same flow works through MCP tools.

Working from a coding agent? One command teaches Claude Code, Codex, or Gemini to drive Agentcard themselves:

npx -y agent-cards@latest agents add

Step 2: Add cash to your balance

Virtual cards are funded from your cash balance. Add funds with Apple Pay or Google Pay via a secure checkout link:

agent-cards fund --amount 50

Open the returned URL and finish paying. Check the balance any time with:

agent-cards wallet

Step 3: Create your first card

Amounts are in dollars (not cents):

agent-cards cards create --amount 25

The CLI confirms the amount, then returns the card ID and summary. Pass --yes to skip the prompt or --json for non-interactive / agent use.Show the full number, CVV, and expiry when you need to fill a form:

agent-cards cards details <card-id>

Ask your agent to create a card. Under the hood it calls create_card with amount_cents (so $25 = 2500). The first time, it will:

Call add_funds if your balance is short (it returns a checkout link to pay with Apple Pay / Google Pay). The first fund asks for a one-time verification code — your agent sends it with start_phone_verification and checks it with verify_phone; it stays valid for 60 days.
Walk you through one-time identity verification (start_kyc) — see KYC & approvals.
Issue the card and return the last 4, balance, and expiry.

Cards are live: each one draws on your cash balance when used. If a card ever comes back marked TEST (number starting 4242…), it came from a connection that isn’t live, usually a company’s test-mode integration. See Test cards for how to fix that.

Step 4: Use the card

Manually — Read the PAN/CVV/expiry from cards details and enter them at checkout.
Shop end-to-end — Use the buy surface to order from a linked merchant in natural language.

Step 5: Monitor and close

agent-cards balance <card-id>          # quick balance check
agent-cards cards transactions <card-id>   # transaction history
agent-cards cards close <card-id>      # close and release held funds

Next steps

MCP setup

Connect AgentCard to your agent.

CLI reference

Every agent-cards command.

For coding agents

agent-cards agents add wires Claude Code, Codex, and Gemini; agent-cards api is the tool catalog.

Plans

Raise your limits with Basic or Pro.

Shopping

Let your agent order from merchants.

Get Started

CLI

MCP

Guides

Concepts

Step 2: Add cash to your balance

Step 3: Create your first card

Step 4: Use the card

Step 5: Monitor and close

Next steps

MCP setup

CLI reference

For coding agents

Plans

Shopping

​Step 1: Install the CLI and sign in

​Step 2: Add cash to your balance

​Step 3: Create your first card

​Step 4: Use the card

​Step 5: Monitor and close

​Next steps

MCP setup

CLI reference

For coding agents

Plans

Shopping

Step 1: Install the CLI and sign in

Step 2: Add cash to your balance

Step 3: Create your first card

Step 4: Use the card

Step 5: Monitor and close

Next steps