@curless/agentbank-merchant-mcp

Merchant-side MCP server for agentbank. Lets a merchant read their own orders and live Curless wallet balance (real funds settled into the merchant's Curless account) from an MCP client (Claude Desktop).

Authenticated by your Curless API key via env — no OAuth. (The OAuth route is the remote /mcp connector added by URL in claude.ai; this is the simple token-based path for Claude Desktop / stdio clients.) Kept separate from the buyer's @curless/agentbank-mcp so the two personas don't share a tool surface. Renders the same MCP Apps card as the remote /mcp connector, with a markdown table fallback for hosts without the card.

Tools

• list_orders — this merchant's orders (what agents have paid), newest first.
• get_balance — the live Curless wallet balance per currency (available / frozen).
• get_order — one order in full: line items + the card it was paid with.

Use (Claude Desktop claude_desktop_config.json)

{
  "mcpServers": {
    "agentbank-merchant": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "@curless/agentbank-merchant-mcp"],
      "env": {
        "AGENTBANK_MERCHANT_TOKEN": "<your-curless-api-key>",
        "AGENTBANK_MERCHANT_ID": "429488"
      }
    }
  }
}

| env | what | | --- | --- | | AGENTBANK_MERCHANT_TOKEN | your Curless API key (issued by Curless at onboarding) | | AGENTBANK_MERCHANT_ID | your Curless merchant id, e.g. 429488 |

The server talks to https://mcp.curless.ai by default — no need to configure it. (Local dev only: set AGENTBANK_API_URL=http://localhost:3000 to point at a local API.)