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: Save a payment method

Virtual cards are funded by a payment method on file. Save one via secure Stripe checkout: 
agent-cards payment-method setup
Open the returned URL in your browser and save your card. You’re only charged when a virtual card you create is actually used. Confirm it’s attached with: 
agent-cards payment-method list

​
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>
New accounts start in test mode, so this first card is a sandbox card (number starts 4242…) with no real charges. When you’re ready for real cards, switch with agent-cards mode prod — see Test mode.

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