AgentCard

What is AgentCard?

AgentCard lets AI agents create and spend virtual debit cards, each with a fixed budget, real card credentials, and full MCP integration. Your agent can create a card, pay for things, check its balance, and auto-fill checkout forms without ever needing your personal card.

How to use AgentCard?

The fastest setup is via the CLI: run npx agent-cards signup (one-time) then npx agent-cards setup-mcp to auto-configure Claude Code. Alternatively, you can manually add a Streamable HTTP or stdio MCP server entry to your client config, providing your JWT token via header or environment variable.

Key features of AgentCard

• Create virtual debit cards with a fixed USD budget
• Retrieve decrypted PAN, CVV, and expiry (with human approval)
• Auto-detect and pay checkout pages in the browser
• Fill card credentials into payment forms automatically
• List cards, check balances, and list transactions
• Human-in-the-loop approval for sensitive operations

Use cases of AgentCard

• An AI assistant pays for an online service using a dedicated virtual card
• An agent fills checkout forms with its own card credentials, keeping your personal card safe
• A developer gives their AI agent a prepaid budget to purchase tools or subscriptions autonomously
• An agent closes or replaces a compromised virtual card without human intervention
• A support bot starts a human chat when a request requires manual approval

FAQ from AgentCard

How do I get a JWT token to authenticate my MCP client?

Run npx agent-cards login; the JWT is stored in ~/.agent-cards/config.json. Use it in the Authorization header for HTTP mode or as the AGENT_CARDS_JWT environment variable for stdio mode.

What transport protocols does AgentCard support?

AgentCard supports both Streamable HTTP (recommended) and stdio transports. The server auto‑discovers its MCP endpoint via the /.well-known/mcp/server-card.json path.

What environment variables are required?

AGENT_CARDS_API_URL is required for all modes. For stdio mode you must also set AGENT_CARDS_JWT. The PORT variable is optional (defaults to 3002) for HTTP mode.

Are there human‑in‑the‑loop approval steps?

Yes. Getting decrypted card details (get_card_details) may require human approval. Use the approve_request tool to approve or deny pending requests.

How can I contact support through the server?

Use the start_support_chat tool to begin a conversation, then send_support_message and read_support_chat to interact with the support thread.