AgentCard← Home

Quickstart

Give your AI agent a virtual card in under a minute.

1. Install the CLI

AgentCard ships as a single npm package. Install it globally so every agent on your machine can use it:

npm install -g agentcard

Requires Node.js 18+. Verify the install with agentcard --version.

2. Sign up

AgentCard uses passwordless magic-link authentication. Run the signup command with your email:

agentcard signup --email you@example.com

A magic link is sent to your inbox. Click it, and the CLI automatically logs you in. Your session token is stored at ~/.agentcard/config.json.

3. Buy a card

Purchase a virtual card for any amount from $5 to $200 (multiples of $5):

agentcard create --amount 25

This opens a Stripe Checkout page. Complete payment, and the CLI provisions your card automatically. Cards are real virtual cards accepted at US-based merchants.

4. Get card details

Once provisioned, retrieve the full card number, CVV, and expiry:

agentcard details <card-id>

Hand these details to your AI agent and it can make purchases online.

5. Use with any AI agent

AgentCard works with every AI agent that can make HTTP requests or fill out web forms:

Claude Code
Cursor
Devin
OpenAI Codex
GitHub Copilot
Windsurf
Cline
Aider
Bolt
Lovable
Replit Agent
v0
Amazon Q
Tabnine
Continue

For AI-native integrations, AgentCard also exposes a skill endpoint at agentcard.ai/skill that agents can read for structured instructions.

Important Notes

US merchants only — AgentCard cards are prepaid Visa cards accepted anywhere prepaid Visa is accepted, but currently only work at US-based merchants (e.g. Vercel, GitHub, Figma, AWS, Namecheap). Transactions at non-US merchants will be declined. We are working on expanding international support.

Security — AgentCard is built and distributed by Alchemy. Card details are stored server-side, encrypted with AES-256-GCM.

Refund limits — Automated refunds are limited to the greater of $5 or 25% of the card value. For larger refunds, contact support.

Typical Agent Flow

  1. Authenticate — Ask the user for their email, run agentcard signup --email <email>, and wait for them to click the magic link.
  2. Purchase a card — Run agentcard create --amount <n>. Share the Stripe checkout URL with the user. Wait for the CLI to auto-complete after payment.
  3. Get card details — Run agentcard details <id> to get the full PAN, CVV, and expiry.
  4. Make the purchase — Use the card details to complete checkout at any US merchant.
  5. Refund unused balance — When done, run agentcard refund <id> --amount <n> to return unused funds.

Ready to get started?

Install the CLI and have your first card in under a minute.

npm install -g agentcard