Quickstart

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.

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.

Run the setup wizard to enter your name and phone, save a payment method, and provision your agent's email inbox:

agentcard setup

The CLI opens a Stripe Checkout setup session in your browser so you can save a card on file — no charge is made. Setup runs once per account; after that, cards issue instantly.

Pass --first-name, --last-name, and --phone to skip the interactive prompts (useful when an agent runs setup on the user's behalf).

Issue a single-use virtual card for any whole-dollar amount up to $75 (the per-card cap during beta):

agentcard request new --amount 25

The CLI prints the cardholder name, PAN, CVV, expiry, and billing ZIP directly to stdout. The card is live for 30 minutes — hand the details to your AI agent immediately. We place a hold on your saved payment method for the requested amount; you're only charged if a merchant actually uses the card. Unused holds release within 7 days.

If you need to re-fetch the details before the 30-minute window closes, run agentcard request get <id>. Run it with no argument to list every request you've made.

Each request also draws against your account-level spend limit (default $100). View or change it with agentcard limit or agentcard limit --amount <n>.

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

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

1. Authenticate — Ask the user for their email, run agentcard signup --email <email>, and wait for them to click the magic link.
2. Set up the account (first run only) — Run agentcard setup. The CLI prints a Stripe Checkout URL — share it with the user so they can save a payment method, then wait for the CLI to finish. Skip this step on subsequent sessions.
3. Request a card — Run agentcard request new --amount <n>. The CLI prints the cardholder name, PAN, CVV, expiry, and billing ZIP immediately.
4. Make the purchase — Use those details at any supported online merchant. Use the cardholder name and billing ZIP exactly as printed; mismatches cause declines. The card is live for 30 minutes.
5. Re-fetch if needed — Lost the details before the window closed? Run agentcard request get <id> to retrieve them again while the card is still live.