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:

Tool	Description
`list_cards`	List all virtual cards with balances, expiry, and status
`create_card`	Create a new prepaid Visa (returns Stripe checkout URL for funding)
`get_card_details`	Get decrypted PAN, CVV, expiry (requires human approval via email)
`check_balance`	Fast balance check without exposing credentials
`close_card`	Permanently close a card (irreversible)
`get_funding_status`	Poll card creation status after Stripe payment
`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

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

Install the CLI: npx agent-cards signup
Configure MCP: npx agent-cards setup-mcp
Restart Claude Code — the AgentCard tools will be available

Environment Variables

Variable	Required	Description
`AGENT_CARDS_JWT`	Yes	Your AgentCard JWT token
`AGENT_CARDS_API_URL`	No	API URL (default: `https://api.agentcard.sh`)
`CARD_PAYMENT_SECRET`	No	Secret for x402 card payments (server-side only)

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)

License

MIT

AgentCard MCP Server

AgentCard MCP Server

What It Does

Install

Quick Start (Recommended)

Manual Setup (Claude Code / Claude Desktop)

Docker (Self-Hosted)

Setup

Environment Variables

Security Model

Development

Links

License

Reviews