GetCurrentOffer

GetCurrentOffer MCP 服务

搜索实时信用卡商户优惠（现金返还、积分、账单抵扣）， 覆盖 Amex、Chase、Citi、PayPal、Rakuten 和 Capital One，任何支持 Model Context Protocol 的 AI Agent 均可使用。

GetCurrentOffer 是一个远程 MCP 服务。无需安装任何内容。将 客户端指向该端点并完成身份验证，即可立即使用四个工具。

端点	https://getcurrentoffer.com/api/mcp
传输方式	Streamable HTTP（JSON-RPC 2.0）
协议版本	2024-11-05
身份验证	OAuth 2.1 + Dynamic Client Registration，或 API 密钥
健康状态	https://getcurrentoffer.com/api/mcp/health
清单	https://getcurrentoffer.com/.well-known/mcp.json
文档	https://getcurrentoffer.com/docs/mcp
API 密钥注册	https://getcurrentoffer.com/api-keys
主页	https://getcurrentoffer.com

工具

工具	用途
search_offers	按商户、描述或关键词模糊搜索所有优惠。可选按发卡机构筛选。
get_offer_details	按 ID 查询某项优惠的完整记录。
list_merchants	浏览所有有有效优惠的商户，可选按发卡机构筛选。
compare_offers	比较某商户在六家发卡机构的优惠并找出最佳优惠。

完整的输入架构见 mcp.json。

快速入门

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS） 或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "getcurrentoffer": {
      "url": "https://getcurrentoffer.com/api/mcp"
    }
  }
}

重启 Claude Desktop。首次调用时，会通过 Dynamic Client Registration 在浏览器中 触发 OAuth 授权流程，无需 API 密钥。

Cursor / Windsurf / VS Code（Copilot Chat、Cline、Roo Code）

{
  "mcp": {
    "servers": {
      "getcurrentoffer": {
        "url": "https://getcurrentoffer.com/api/mcp",
        "headers": { "X-API-Key": "gco_your_api_key_here" }
      }
    }
  }
}

在 https://getcurrentoffer.com/api-keys 免费获取 API 密钥。

Continue.dev

{
  "experimental": {
    "modelContextProtocolServers": [
      {
        "transport": {
          "type": "http",
          "url": "https://getcurrentoffer.com/api/mcp",
          "headers": { "X-API-Key": "gco_your_api_key_here" }
        }
      }
    ]
  }
}

更多客户端配置示例见 examples/。

从命令行试用

# Health check (no auth)
curl https://getcurrentoffer.com/api/mcp/health

# List tools (with API key)
curl -X POST https://getcurrentoffer.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gco_your_api_key_here" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# Search for Starbucks offers
curl -X POST https://getcurrentoffer.com/api/mcp \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gco_your_api_key_here" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_offers",
      "arguments": { "query": "Starbucks", "limit": 5 }
    }
  }'

身份验证

支持以下两种方式：

1. OAuth 2.1 与 Dynamic Client Registration（RFC 7591）——推荐用于 Claude Desktop、ChatGPT 连接器和 Claude.ai 等托管客户端。客户端通过根据 RFC 9728 在 WWW-Authenticate 中公布的 Protected Resource Metadata 端点发现身份验证服务器， 注册自身，然后引导用户完成授权页面。无需手动复制密钥。

2. API 密钥——推荐用于命令行工具、服务端 Agent 和开发／测试。 在 https://getcurrentoffer.com/api-keys 生成密钥，并通过 X-API-Key: gco_… 或 Authorization: Bearer gco_… 传递。提供免费套餐。

此仓库中的 Authorization Server Metadata 和 Protected Resource Metadata 是线上 well-known 端点的静态快照——请获取实时版本作为权威信息来源。

示例提示词

• “搜索 Nike 信用卡优惠。”
• “比较我所有发卡机构针对 Starbucks 的优惠。”
• “列出所有有有效 Amex 优惠的商户。”
• “Chase 目前有哪些有效的餐饮优惠？”

类别与标签

类别： 金融 · 购物 · 生产力 · 消费者

标签： 信用卡 · 现金返还 · 优惠 · 特价 · 奖励 · amex · chase · citi · paypal · rakuten · capital-one

状态

已上线生产环境。健康状态端点、清单和 OAuth 元数据均已上线并 返回 200。服务运行于 Vercel 边缘网络，使用由 Postgres 支持的进程内优惠缓存，缓存时长为 5 分钟。

问题／联系

在此仓库中提交问题，或通过 https://getcurrentoffer.com/contact 联系我们。

商标与免责声明

GetCurrentOffer 是一项独立服务。我们不隶属于、未获认可、未受赞助，也未获批准于 American Express、JPMorgan Chase、Citigroup、PayPal、Rakuten、Capital One，或本仓库或 API 返回的优惠数据中提及的任何其他发卡机构、银行、商户或支付网络。

所有产品名称、徽标和品牌均为其各自所有者的财产。本仓库中使用的所有公司、产品和服务名称——包括但不限于 “American Express”、“Amex”、“Chase”、“Citi”、“PayPal”、“Rakuten”、“Capital One”，以及示例提示词或返回的优惠数据中出现的任何商户名称——均仅用于识别目的。使用这些名称、徽标和品牌并不意味着获得认可。这属于指称性合理使用，用于描述本服务所索引优惠的性质。

本 README 中提及的第三方 MCP 客户端名称（“Claude Desktop”、“Claude Code”、“Cursor”、“Windsurf”、“Continue.dev”、“VS Code”、“Cline”、“Roo Code”）均为其各自所有者的商标，提及这些名称仅为说明兼容性。

不构成财务建议。本服务返回的优惠数据仅供参考，不构成财务、投资、税务或法律建议。优惠条款、资格要求、到期日期和可用性经常变化，且可能与所示内容不同。请务必直接向发卡银行或商户核实任何优惠，再据此采取行动。GetCurrentOffer 的运营方不对数据的准确性、完整性、时效性或特定用途适用性作出任何明示或暗示的保证，并对因依赖这些数据而作出的任何决定概不承担责任。使用本服务须遵守 https://getcurrentoffer.com 上的服务条款。