agentcard-mcp

MCP server for AgentCard — on-demand card credentials for AI agents.

Full user guide: agentcard.ai/docs/mcp (source: docs/mcp.md)

Give your AI agent a real payment method. One mental model: request a card credential for a purchase, choosing the payment source — an AgentCard-issued single-use virtual Visa card by default (instant, capped, live for 7 days), or one of the user's own connected Visa/Mastercard cards via network tokenization (experimental, passkey-approved per purchase). Spending limits, KYC, and a hard daily ceiling keep it safe.

Install

npx agentcard-mcp

Configure

Claude Desktop / Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "agentcard": {
      "command": "npx",
      "args": ["-y", "agentcard-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "agentcard": {
      "command": "npx",
      "args": ["-y", "agentcard-mcp"]
    }
  }
}

Windsurf / Cline / Other MCP Clients

Use the same configuration — npx -y agentcard-mcp as the command.

Tools

Account

| Tool | Description | | ------------------------ | ------------------------------------------------------------------------------- | | get_setup_instructions | Get instructions for using AgentCard | | signup | Sign up or log in with email (sends magic link) | | setup | Save a payment method (via a Stripe URL the user opens), agent email, wallet | | check_identity | Check KYC status; returns a verification URL for the user when required | | get_limits | Show both spend budgets (issued cards + wallet, connected cards) | | request_limit_increase | Change a spend limit (raises are email-approved by the account owner) |

Purchases

| Tool | Description | | -------------------------- | ------------------------------------------------------------------------------ | | create_card | Issue a single-use virtual Visa card ($1–$150; decimals round up) | | list_purchases | List all purchases across both payment sources | | get_card_details | Re-fetch a live issued card's number/CVV/expiry, or a purchase's status | | cancel_card | Cancel an unused issued card and release its hold immediately | | get_3ds_code | Get checkout 3DS / verification codes from the last 5 minutes | | report_issue | Report an issue to AgentCard support |

Connected cards (experimental)

| Tool | Description | | --------------------------- | ------------------------------------------------------------------------------ | | list_sources | List payment sources: the issued-card source + enrolled connected cards | | connect_card | Enroll one of the user's own Visa/Mastercard cards (returns a browser URL) | | create_connected_purchase | Merchant-scoped purchase on a connected card (returns a passkey-approval URL) | | get_purchase_credentials | Retrieve the one-time card credential after the user approves |

Quick Start

Once configured, your AI agent can:

1. Sign up — signup with the user's email (they click a magic link)
2. Set up — setup returns a Stripe URL for the user to save a payment method (the agent never touches real card details)
3. Verify identity — check_identity; new accounts may need to complete KYC via the returned URL
4. Create a card — create_card with the checkout total ($1–$150)
5. Make the purchase — complete checkout with the printed card number, CVV, expiry, cardholder name, and billing address
6. Handle 3DS — get_3ds_code if checkout asks for a verification code
7. Clean up — cancel_card to release the hold on a card you no longer need

Prerequisites

Requires Node.js 18+. The server runs the agentcard CLI via npx automatically; installing it globally makes calls faster:

npm install -g agentcard

Links

• Website: agentcard.ai
• CLI: npmjs.com/package/agentcard
• Agent guide: agentcard.ai/skill
• Direct API reference: docs/api-v1.md

License

MIT