Skip to main content
This walks through the full Personal flow — from zero to a working virtual card your agent can use.

Step 1: Install the CLI and sign in

The agent-cards CLI is the fastest way to get started. Install it and sign up — you’ll receive a magic link to verify your email:
npm install -g agent-cards
agent-cards signup
Click the link in 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.

Step 2: Fund your wallet

Virtual cards are funded from your wallet balance. Add funds with Apple Pay or Google Pay via a secure checkout link:
agent-cards wallet 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>
Cards are live: each one draws on your wallet balance when used. If a card ever comes back marked TEST (number starting 4242…), it came from a connection that isn’t live, usually an organization’s sandbox 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.
  • Autofill — Install the Chrome extension and let your agent fill the card into the form.
  • 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.

Plans

Raise your limits with Basic or Pro.

Shopping

Let your agent order from merchants.