AgentCard
About
MCP server for Agent Cards — prepaid virtual Visa cards for AI agents
Details
- Author
- agent-cards
- GitHub stars
- 1
- Downloads
- 344
- Categories
- AI
Jump to
- Create virtual debit cards with a fixed USD budget
- Retrieve decrypted PAN, CVV, and expiry (with human approval)
- Auto-detect and pay checkout pages in the browser
- Fill card credentials into payment forms automatically
- List cards, check balances, and list transactions
- Human-in-the-loop approval for sensitive operations
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
AgentCardCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
The fastest setup is via the CLI: run npx agent-cards signup (one-time) then npx agent-cards setup-mcp to auto-configure Claude Code. Alternatively, you can manually add a Streamable HTTP or stdio MCP server entry to your client config, providing your JWT token via header or environment variable.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"agentcard": {
"agent-cards": {
"url": "https://mcp.agentcard.sh/mcp",
"headers": {
"Authorization": "Bearer <your-jwt>"
}
}
}
}
}McpServers
{
"agent-cards": {
"url": "https://mcp.agentcard.sh/mcp",
"headers": {
"Authorization": "Bearer <your-jwt>"
}
}
}@agent-cards/mcp
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
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
