agent-cards

The Agentcard CLI. One product, two doors: Personal gives your own AI agent a card; companies issues cards to every agent your users run. Also installed as agentcard.

npx -y agent-cards@latest              # guided setup: sign in, connect your agent, fund — and it offers to install itself
npx -y agent-cards@latest agents add   # teach your coding agents (Claude Code, Codex, Gemini) to use Agentcard

Or install directly: npm install -g agent-cards.

Docs: docs.agentcard.sh

Personal — a card for your agent

agent-cards login                      # emails you a one-time code
agent-cards setup-mcp                  # add the Agentcard MCP to Claude Code (OAuth, no tokens to manage)
agent-cards fund --amount 20           # add cash to your balance (Apple/Google Pay)
agent-cards cards create --amount 25   # issue a one-time virtual card from your balance
agent-cards buy "paper towels from Costco on DoorDash"

Sign-in emails a code (no passwords, no magic links). Driving the CLI as an agent without a terminal:

agent-cards login --email [email protected]          # emails a code, exits 2 with code_required
agent-cards login --email [email protected] --code 123456

Everything else: agent-cards --help (wallet = your cards + balance; rewards, buy, kyc, plan, connections, support).

Companies — issue cards to your users' agents

Everything that used to live in agent-cards-admin (still published as a forwarding shim, so old commands keep working):

agent-cards companies create           # create a company
agent-cards companies use acme         # set the default company (like the dashboard switcher)
agent-cards companies credentials create   # client credentials for your servers (API keys are retired)
agent-cards companies balance get
agent-cards companies subscribe        # unlock production

Env vars.

| Var | Effect | |---|---| | AGENT_CARDS_API_URL | API base URL (default https://api.agentcard.sh; legacy ADMIN_API_URL still honored for companies commands) | | AGENT_CARDS_JWT | Bearer token to use instead of a stored login session (legacy AGENT_CARDS_ADMIN_JWT still honored) | | AGENT_CARDS_MCP_URL | MCP server URL override (default derived from the API URL) | | AGENT_CARDS_SKIP_UPDATE=1 | Skip the pre-command auto-update check (also skipped under CI) | | DO_NOT_TRACK=1 or AGENT_CARDS_TELEMETRY=0 | Disable telemetry (lifecycle events and error reports; never repo contents, paths, or secrets) |

One config, one session

Credentials live in ~/.agent-cards/config.json (0600). Signing in once covers both doors — companies are created from your account. An existing ~/.agent-cards-admin.json session is adopted automatically the first time the unified CLI runs.