AgentCard

Give your AI agent a debit card. 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.

Quick Setup

The fastest way to connect your agent is through the CLI:

npx agent-cards signup    # create an account (one-time)
npx agent-cards setup-mcp # auto-configures Claude Code

That's it. Restart Claude Code and the tools are ready to use.

Manual Setup

HTTP (recommended)

Add to your MCP client config (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "agent-cards": {
      "url": "https://mcp.agentcard.sh/mcp",
      "headers": {
        "Authorization": "Bearer <your-jwt>"
      }
    }
  }
}

Get your JWT with npx agent-cards login, then find it in ~/.agent-cards/config.json.

stdio (local)

{
  "mcpServers": {
    "agent-cards": {
      "command": "node",
      "args": ["/path/to/packages/mcp/dist/src/index.js"],
      "env": {
        "AGENT_CARDS_JWT": "<your-jwt>",
        "AGENT_CARDS_API_URL": "https://your-backend.example.com"
      }
    }
  }
}

Tools

| Tool | Description |
|------|-------------|
| list_cards | List all virtual cards with balances, expiry, and status |
| create_card | Create a new virtual debit card with a fixed USD budget |
| get_card_details | Get decrypted PAN, CVV, expiry (may require human approval) |
| check_balance | Fast balance check without exposing credentials |
| close_card | Permanently close a virtual card |
| list_transactions | List transactions for a card with optional status filter |
| approve_request | Approve or deny a pending human-in-the-loop request |
| submit_user_info | Submit identity info for card issuance verification |
| setup_payment_method | Set up a payment method for funding cards |
| remove_payment_method | Remove a saved payment method |
| pay_checkout | Auto-detect and pay a checkout page using an AgentCard |
| detect_checkout | Detect checkout forms on the current browser tab |
| fill_card | Fill card credentials into a payment form in the browser |
| start_support_chat | Start a support conversation |
| send_support_message | Send a message in a support thread |
| read_support_chat | Read support conversation history |

Endpoints

| Method | Path | Description |
|--------|------|-------------|
| POST | /mcp | MCP Streamable HTTP transport |
| GET | /health | Health check ({"ok":true}) |
| GET | /.well-known/mcp/server-card.json | Auto-discovery metadata |

Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| AGENT_CARDS_API_URL | yes | Backend API URL |
| AGENT_CARDS_JWT | stdio only | User JWT (HTTP gets it from the Authorization header) |
| PORT | no | HTTP server port (default: 3002) |

Development

pnpm dev       # stdio mode
pnpm dev:http  # HTTP mode
pnpm build     # compile TypeScript