@curless/agentbank-mcp

MCP server for agentbank — Curless's gateway for AI-agent payments. Lets your local AI agent (Claude Desktop, Cursor, etc.) discover Curless merchants and pay them through agent payment protocols.

Install

npx @curless/agentbank-mcp

Claude Desktop config

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "agentbank": {
      "command": "npx",
      "args": ["-y", "@curless/agentbank-mcp"],
      "env": {
        "AGENTBANK_API_URL": "https://api.agentbank.example",
        "AGENTBANK_AGENT_TOKEN": "agt_..."
      }
    }
  }
}

Tools

Merchant discovery

• list_merchants — list merchants, optionally by category
• get_merchant — full merchant info
• get_merchant_catalog — items + prices for a merchant
• get_agent_card — A2A / ACP compatible agent card
• invoke_skill — call a skill (search_availability, book_room, order_item, …)

PaymentIntents (the money primitive — capture moves real money ⚠️)

• create_payment_intent — create a PI; pass idempotencyKey for safe retries
• get_payment_intent / list_payment_intents — status + history
• capture_payment_intent ⚠️ — charge the rail and book the ledger

Payment Links (shareable, Stripe Payment Links)

• create_payment_link — a shareable url for a merchant + fixed amount
• get_payment_link — view a link before paying
• pay_payment_link ⚠️ — pay a shared link (mints a PI)

Resources (read-only / admin)

• get_wallet_balances — Curless balances (fiat + crypto)
• list_agents / get_agent / update_agent — your spending entities
• list_customers / get_customer / update_customer — end users / payers

What you can actually do is gated by the scope of the AGENTBANK_AGENT_TOKEN you set — give it agent:execute for buyer flows, agentbank:admin to manage agents/customers.

Local dev

export AGENTBANK_API_URL=http://localhost:3000
pnpm dev