@agent-cards/mcp

Give your AI agent a debit card. Agent Cards lets AI agents create and spend prepaid virtual Visa cards — each with a fixed budget, real card credentials, and full MCP integration. Your agent can create a card, pay for things, and check its balance 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 prepaid Visa card with a fixed USD budget
`get_funding_status`	Poll card creation status after Stripe payment
`get_card_details`	Get decrypted PAN, CVV, expiry (may require human approval via email)
`check_balance`	Fast balance check without exposing credentials
`close_card`	Permanently close a virtual card
`x402_fetch`	HTTP fetch with automatic payment on 402 responses
`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

mcp