@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