AgentPay MCP Server

Payment tools for AI agents. Create single-use virtual cards, make purchases, manage budgets — all via MCP.

Works with Claude Code, Claude Desktop, Cursor, Windsurf, OpenClaw, and any MCP-compatible client.

Published on npm as [email protected]

Tools

| Tool | Description | |------|-------------| | create_card | Create a single-use virtual card for a purchase | | get_card_details | Retrieve PAN, CVV, and expiry (audit-logged) | | check_balance | Check remaining balance and status | | check_account | Check if account is ready to make purchases (call before create_card) | | close_card | Close card and release unused funds | | list_transactions | List transactions across cards | | agentpay_signup | Create an account conversationally (first-run mode only, exposed when no API key) |

Quick Start

No API key? The server enters setup mode automatically. Your agent can create an account conversationally.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "agentpay": {
      "command": "npx",
      "args": ["agentpay-mcp-server"],
      "env": {
        "AGENTPAY_API_KEY": "agentpay_sk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add agentpay -- npx agentpay-mcp-server

Cursor / Windsurf / OpenClaw

{
  "agentpay": {
    "command": "npx",
    "args": ["agentpay-mcp-server"],
    "env": {
      "AGENTPAY_API_KEY": "agentpay_sk_live_your_key_here"
    }
  }
}

One-command setup

npx agentpay-mcp-server --setup agentpay_sk_live_your_key_here

Environment Variables

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AGENTPAY_API_KEY | No | — | API key. If missing, signup tool is exposed. | | AGENTPAY_API_URL | No | https://api.agentpay.la | API base URL | | AGENTPAY_AGENT_TYPE | No | auto-detected | Agent framework identifier |

Transports

• stdio (default): Claude Desktop, Claude Code, Cursor, etc.
• HTTP (--http --port 3000): remote/web clients

Links

• Website: https://agentpay.la
• API Docs: https://api.agentpay.la/docs
• GitHub: https://github.com/sagebhardt/agentpay