AgentCard MCP Server

Prepaid virtual Visa cards for AI agents. Create cards, check balances, retrieve payment credentials, and make x402 payments — all through the Model Context Protocol.

What It Does

AgentCard lets AI agents spend money online with hard budget limits. Each card is a prepaid Visa with a fixed USD balance that works anywhere Visa is accepted (card-not-present). The MCP server exposes 10 tools:

Install

Quick Start (Recommended)

The fastest way to get started is with the AgentCard CLI, which handles authentication and MCP setup automatically:

npx agent-cards signup    # create an account
npx agent-cards setup-mcp # configure MCP in Claude Code

This registers the hosted MCP server (https://mcp.agentcard.sh/mcp) with your credentials.

Manual Setup (Claude Code / Claude Desktop)

If you prefer manual configuration, add to your MCP config (claude_desktop_config.json or .mcp.json):

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

Get your JWT token by running npx agent-cards login or from the dashboard.

Docker (Self-Hosted)

docker build -t agent-cards-mcp .
docker run -p 8080:8080 -e AGENT_CARDS_JWT=<your-jwt> agent-cards-mcp

Roadmap: Standalone npx agent-cards-mcp support (without the CLI signup step) is planned for a future release.

Setup

1. Install the CLI: npx agent-cards signup

2. Configure MCP: npx agent-cards setup-mcp

3. Restart Claude Code — the AgentCard tools will be available

Environment Variables

Security Model

• Human-in-the-loop: create_card and get_card_details require email approval from the account owner before proceeding

• Encryption at rest: Card credentials (PAN, CVV) are encrypted with AES-256-GCM

• Audit trail: Every MCP tool call includes X-Caller-Type and X-Correlation-ID headers

• Budget limits: Each card has a hard spending cap set at creation — the agent cannot exceed it

• Stateless: Each HTTP request creates a fresh server instance with no shared state

Development

git clone https://github.com/radiahq/mcp.git
cd mcp
npm install
npm run dev        # stdio mode
npm run dev:http   # HTTP mode (port 3002)

Links

• Website

• Dashboard

• Documentation

• CLI on npm

License

MIT