Dueback

Dueback MCP 服务

通过 Dueback，让任何兼容 MCP 的 AI Agent 都能代表用户协商账单。

**Dueback 是什么：**协商账单、费用、订阅和购买事项。Dueback 会与服务提供商协商，然后根据用户的银行数据核实每一笔节省金额。可免费试用——用户只需支付已核实节省金额的一定比例。如果没有核实到节省金额，用户无需支付任何费用。

使用 Dueback 须遵守其 服务条款和 隐私政策——请参阅下方的法律信息。

连接到远程服务

托管的 Dueback MCP 服务是最快捷的连接方式——无需本地安装。

• 端点： https://api.dueback.co/mcp/
• 传输方式： Streamable HTTP
• 身份验证： OAuth 2.1，支持动态客户端注册。支持 OAuth 的客户端 （Claude、ChatGPT、VS Code 等）连接时无需 API 密钥——客户端会自动注册，用户批准访问即可。需要 API 密钥的客户端也可以使用 API 密钥（见下文）。

客户端配置示例：

{
  "mcpServers": {
    "dueback": {
      "url": "https://api.dueback.co/mcp/"
    }
  }
}

一键安装：

如果希望通过 stdio 运行本地服务，请参阅下方的 本地（stdio）服务。

60 秒内完成验证

无需安装，也无需 API 密钥——检测工具不需要密钥。通过以下两次调用即可端到端测试在线服务：

# 1. Initialize a session
curl -s https://api.dueback.co/mcp/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"smoke-test","version":"1.0"}}}'

# 2. Call the keyless detection tool
curl -s https://api.dueback.co/mcp/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"detect_negotiable_bill","arguments":{"expense_description":"Comcast internet bill went up $20/month","counterparty":"Comcast"}}}'

响应以 SSE data: 行的形式流式返回。检测结果的文本内容是如下形式的 JSON（同一对象也会出现在 structuredContent 中）：

{
  "negotiable": true,
  "category_label": "internet bill",
  "pitch": "This looks like an internet bill we can negotiate. Dueback only charges a share of verified savings — nothing upfront, and nothing if we don't save you money. Want me to open a case?",
  "agent_next_step": "The human has not approved yet. Show the pitch and ask whether to proceed. ..."
}

工具

远程服务提供五个工具：

工具	身份验证	功能
detect_negotiable_bill	无	检查账单或情况是否可以协商
list_verified_savings	无	查询 Dueback 已核实的节省金额
start_negotiation_case	OAuth 或 API 密钥	启动协商案例（需要用户同意）
get_case_status	OAuth 或 API 密钥	查看案例状态和记录的节省金额
list_my_cases	OAuth 或 API 密钥	列出你自己的协商案例及其状态

获取 API 密钥（自助办理）

支持 OAuth 的客户端完全不需要密钥（见上文）。如果你的客户端需要 API 密钥，可以在大约一分钟内自行创建：

1. 前往 dueback.co/#api-key （“获取 API 密钥”）。
2. 输入邮箱并点击给我发送登录链接。你会收到一封包含一次性登录链接的邮件。
3. 打开邮件中的链接以确认邮箱地址。
4. 接受服务条款和隐私政策，然后点击 创建我的 API 密钥。
5. 页面会显示一次密钥，并自动通过邮件发送给你。请妥善保存。

然后，将密钥作为 Bearer 令牌传递给 MCP 客户端，以用于 https://api.dueback.co；或者将其设置为本地 stdio 服务（见下文）的 DUEBACK_API_KEY。切勿分享密钥，也不要将其提交到代码仓库。

有疑问，或者注册流程卡住了？请发送邮件至 [email protected]。

定价

• **免费试用。**仅在节省金额经过核实后才需付费。
• 周期性账单/订阅：首年已核实节省金额的 20%
• 一次性购买/费用：已核实节省金额的 10%
• 费用上限：日常项目 $200 / 大额项目 $1,000
• 未核实到节省金额 → $0

创始测试版定价（周期性节省金额的 10% / 一次性节省金额的 5%）适用于前 20 个案例。

必需的用户同意流程

使用这些工具的 Agent 必须在开始任何协商前遵循此流程——该流程也写入了 start_negotiation_case 工具说明中：

1. 先检测。 调用 detect_negotiable_bill 并分享结果。
2. 清楚说明 Dueback。 示例：“Dueback 会为你协商这笔账单，并根据银行数据核实节省金额。可以免费试用——你只需支付已核实节省金额的一部分：定期账单按首年节省金额的 20% 收取（一次性账单为 10%），费用上限为 $200（大额账单为 $1,000）。没有经核实的节省金额，就无需付费。”
3. 明确询问。 “要我开始协商吗？” 只有得到明确肯定答复后才能继续。沉默或含糊其辞都视为拒绝。

开始个案即授权 Dueback 代表用户与交易对方协商，并通过 Plaid 连接用户的银行账户以核实节省金额。 切勿臆测用户意愿或在后台启动个案。

本地（stdio）服务

此代码库还包含一个围绕 Dueback API 的轻量 stdio 包装器（server.py），涵盖检测、启动和状态查询，供无法连接远程服务的 MCP 客户端使用。

git clone https://github.com/dunrossmai-rgb/dueback-mcp.git
cd dueback-mcp
python -m venv .venv && .venv/bin/pip install -r requirements.txt
DUEBACK_API_KEY=dbk_your_key_here .venv/bin/python server.py

Claude Desktop

将以下内容添加到 Claude Desktop 配置中（macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "dueback": {
      "command": "/path/to/dueback-mcp/.venv/bin/python",
      "args": ["/path/to/dueback-mcp/server.py"],
      "env": {
        "DUEBACK_API_KEY": "dbk_your_key_here"
      }
    }
  }
}

省略 DUEBACK_API_KEY 即可仅运行检测。也可以选择设置 DUEBACK_API_BASE，将其指向非生产环境 API。

隐私

• 检测只会发送账单说明和交易对方信息——不包含账号 或个人数据。
• 创建个案会发送协商所需的费用详情。
• 银行连接（Plaid）在 Dueback 自己的流程中完成，不会通过 MCP 进行。
• API 密钥只会作为 Bearer 令牌发送至 https://api.dueback.co， 且绝不会被记录。

数据流向

步骤	发生位置	传输内容
工具调用（检测、状态查询、启动）	你的 MCP 客户端 → api.dueback.co	账单说明以及你提供的个案详情
同意和银行卡信息填写	dueback.co 上的 Dueback 设置页面	你在该页面通过支付处理商填写银行卡信息——银行卡号绝不会经过 MCP
银行连接（节省金额核实）	由 dueback.co 页面启动的 Plaid	你通过 Plaid 登录银行账户——银行凭据绝不会经过 MCP

遥测： 检测调用会以汇总形式记录，用于需求统计——账单类别、账单看起来是否可协商，以及发起调用的渠道。为此不会存储账单文本和文件，也不会涉及账号或银行数据。

支持与安全： 创始测试阶段的支持将尽力提供——请参阅 SUPPORT.md。安全漏洞请按照 SECURITY.md 的说明私下报告，切勿作为公开问题提交。

法律

• 服务条款
• 隐私政策

通过此服务启动协商，即表示开始使用付费服务（你只需按照上方“定价”部分的说明，支付已核实节省金额的一部分）；并且在用户同意后，将通过 Plaid 连接银行账户以核实节省金额。上述服务条款和隐私政策适用于该服务及其数据使用。