Merchant MCP connector

See your orders, live Curless balance, and refund queue inside Claude — no key to paste. AgentBank exposes a remote MCP server as an OAuth 2.0 connector.

Add the connector

1. In Claude → Settings → Connectors → Add custom connector.

2. URL: https://mcp.curless.ai/mcp

3. Complete OAuth — you’re redirected to “Log in with Curless.” The account you sign in as selects which merchant’s data the tools return.

There’s no client_id to enter: the connector self-registers via Dynamic Client Registration (RFC 7591) + PKCE. The canonical URL carries no merchant id — the merchant is decided by the login. (/mcp/{merchantId} is an optional pinned variant.)

Tools

Tool	What it does
list_orders	Your orders, newest first; filter by status / protocol / currency / date.
get_summary	Count + gross by currency + breakdowns by protocol / status.
get_balance	Your live Curless wallet balance per currency.
get_order	One order in full — line items + how it was paid.
list_refund_requests	Buyers’ refund requests (the queue).
approve_refund / reject_refund	Work the refund queue.
refund_order	Refund one of your orders directly.

approve_refund and refund_order move money (issue refunds); everything else is read-only.

Or run it locally (stdio)

Prefer a token over OAuth? Run the stdio server with your Curless API key:

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

Both surfaces render the same orders / balance / refunds card, with a markdown fallback for hosts without it.