商户 MCP 连接器

在 Claude 里查看你的订单、实时 Curless 余额和退款队列 —— 无需粘贴密钥。 AgentBank 以 OAuth 2.0 连接器的形式对外提供一个远程 MCP 服务器。

添加连接器

在 Claude → 设置 → 连接器 → 添加自定义连接器。
URL：https://mcp.curless.ai/mcp
完成 OAuth —— 你会被重定向到“用 Curless 登录”。你登录用的账户决定了这些工具返回哪个商户的数据。

不需要填写 client_id：连接器会通过 Dynamic Client Registration（RFC 7591）+ PKCE 自注册。规范 URL 不带商户 id —— 商户由登录决定。（/mcp/{merchantId} 是一个可选的固定变体。）

工具

工具	作用
`list_orders`	你的订单，最新在前；可按状态 / 协议 / 币种 / 日期过滤。
`get_summary`	按币种统计数量 + 总额，并按协议 / 状态拆分。
`get_balance`	你按币种的实时 Curless 钱包余额。
`get_order`	一笔订单的完整信息 —— 行项目 + 它是怎么付的。
`list_refund_requests`	买家的退款请求（队列）。
`approve_refund` / `reject_refund`	处理退款队列。
`refund_order`	直接为你的某笔订单退款。

approve_refund 和 refund_order 会动用资金（发起退款）；其余都是只读的。

或者在本地运行它（stdio）

比起 OAuth 更想用 token？用你的 Curless API key 运行 stdio 服务器：

{
  "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>"
      }
    }
  }
}

两种入口都会渲染出同一张订单 / 余额 / 退款卡片，并为不支持它的宿主提供 markdown 回退。