Skip to main content
The agent-cards CLI is the terminal-first way to manage your personal AgentCard account — sign in, save a payment method, issue cards, and shop at linked merchants.
This is the consumer CLI (agent-cards). Companies integrating AgentCard use the separate agent-cards-admin CLI — see the Companies CLI.

Installation

npm install -g agent-cards
Update to the latest version any time:
agent-cards update

Authentication

Most commands require you to be signed in. Run agent-cards signup (or login — they’re the same) and click the magic link sent to your email. Credentials are stored locally; clear them with agent-cards logout.

Command groups

GroupDescription
signup / login / logout / whoamiAccount & session
modeSwitch between test and prod issuing (test mode)
setup-mcpConfigure the AgentCard MCP server in Claude Code
connectionsList or revoke third-party apps connected to your account
cardsCreate, list, inspect, and close cards
payment-methodManage saved payment methods
planView and change your subscription
settingsNotification and authorization preferences
buyShop and check out at linked merchants
extensionInstall the AgentCard Pay Chrome extension
supportStart a live support conversation

Global options

-V, --version   Show version number
-h, --help      Show help for any command
Use --help on any subcommand for details:
agent-cards cards create --help

Agent-friendly flags

Several commands support non-interactive use so an agent can drive them without prompts:
  • cards create --amount <dollars> --yes skips the confirmation prompt; add --json for machine-readable output.
  • cards close <id> --yes skips the close confirmation.
  • buy checkout <merchant> --yes confirms placing an order.