Thrifle

Thrifle MCP server

美国退货政策、价格匹配规则、折扣、优惠、信用卡条款和 Amazon 买入还是等待的建议——作为只读工具，供 Claude、ChatGPT、Cursor 和任何 MCP 客户端使用。

https://api.thrifle.com/api/mcp

无需身份验证，无需注册。提供 24 种工具。每个回答都会链接到对应的 thrifle.com 页面。

可以询问什么

工具	示例
get_return_policy	Costco 对笔记本电脑的退货政策是什么？
compare_return_policies	在 Target 还是 Walmart 退货更容易？
search_return_policies	哪些家具店提供免费退货？
get_price_match_policy	Best Buy 会匹配 Amazon 的价格吗？
who_will_price_match	哪些商家会匹配这款电视在 Amazon 上的价格？
get_merchant_discounts · search_discounts	Home Depot 有军人折扣吗？
get_cancellation_guide	如何取消 Planet Fitness 会员？
get_birthday_freebie · search_birthday_freebies	Starbucks 会在你生日时送什么？
search_deals · get_deal · get_deal_of_the_day · get_store_deals	现在有 AirPods Pro 的优惠吗？
predict_amazon_price	我应该现在买这款 Amazon 商品，还是再等等？
search_credit_cards · get_credit_card · get_store_credit_cards	Lowe's 信用卡采用递延利息吗？
get_money_monitor · get_price_pulse	目前信用卡的平均年利率是多少？
check_product_recalls	这款商品被召回过吗？
about_thrifle	Thrifle 是什么？涵盖哪些内容？

这些工具背后的数据包括：涵盖 2,250 家美国零售商的退货政策数据库，其评级为 A+ 至 D−，根据政策本身的条款计算得出；价格匹配和价格调整政策；军人／学生折扣计划；生日优惠；取消指南；精选优惠信息流；根据发卡机构定价页面建立的信用卡数据库；以及数十万种 Amazon 商品的价格历史。所有数据均经编辑核实，每条记录都附有 last_verified 日期。

连接

Claude.ai / Claude Desktop（所有套餐均可；Free 套餐允许添加一个自定义连接器） 设置 → 连接器 → 添加自定义连接器 → 粘贴 URL → 身份验证留空。

Claude Code

claude mcp add --transport http thrifle https://api.thrifle.com/api/mcp

ChatGPT — 设置 → 应用和连接器 → 创建（开发者模式）→ 粘贴 URL，无需身份验证。

Cursor — 点击上方徽章，或添加到 ~/.cursor/mcp.json：

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

VS Code — 点击上方徽章，或运行 code --add-mcp '{"name":"thrifle","type":"http","url":"https://api.thrifle.com/api/mcp"}'。

Perplexity（+ 自定义连接器 → 远程）、Grok（grok.com/connectors → 自定义）、Mistral Le Chat（连接器 → 自定义 MCP 连接器）、Gemini CLI（在 mcpServers 下设置 httpUrl）和 Gemini Enterprise（管理团队 → 已连接的应用 → 添加 MCP Server）均可使用同一个 URL。

Claude Code 插件 — 此仓库也可作为 Claude Code 插件使用（.claude-plugin/plugin.json、.mcp.json，以及一个 thrifle-shopping 技能，用于指导模型判断哪个工具能回答哪个问题）。

在终端中试用

curl -s https://api.thrifle.com/api/mcp | jq .tools

curl -s -X POST https://api.thrifle.com/api/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_return_policy","arguments":{"merchant":"Costco"}}}'

自行运行

git clone https://github.com/ejazmu/thrifle-mcp && cd thrifle-mcp
npm install
npm start          # http://127.0.0.1:8787/mcp, reading Thrifle's public API
npm test           # 17 protocol + shaping fixtures, no network needed

这与为 api.thrifle.com/api/mcp 提供服务的代码相同。THRIFLE_API_BASE 用于将其指向不同的 API 基础地址；MCP_RATE_PER_MIN / MCP_RATE_PER_DAY 用于设置每个 IP 的限额；MCP_API_KEYS（以逗号分隔）列出可通过 Authorization: Bearer 绕过限额的密钥。

构建方式

• 无状态的 Streamable HTTP。 每个请求都会创建一个 McpServer 和传输层，返回 JSON 响应，不使用会话——无需恢复会话，不会在调用方之间共享任何内容，也没有 CDN 需要缓冲的内容。对端点执行 GET 会返回一份便于人类阅读的发现文档。
• 工具调用 Thrifle 的公开 REST API，而非数据库。 这样可以确保 MCP 的回答与网站的回答一致：联盟链接处理、过期优惠规则和服务时定级都会自动生效。src/api-client.js 是一个 60 行的本地回环 fetch。
• 整形数据，而非原始载荷。 src/shape.js 将每个 API 响应转换为事实信息，以及规范的 thrifle.com url 和 cite 区块，并删除内部字段。这些都是纯函数，均由固定样例覆盖。
• 从设计上就是只读的。 每个工具都声明 readOnlyHint: true；src/tools.js 中的工具目录没有写入路径。
• 价格判断绝不会触发实时抓取——只读取追踪价格数据库。

合理使用与许可

个人提出问题时，助手可免费使用：每个地址每分钟 60 次调用，每天 1,500 次。批量或商业用途需获得许可——请参阅 thrifle.com/data-licensing；许可证附带一个可解除限额的密钥。优惠的 buy_url 值是 thrifle.com 重定向链接，可能包含联盟链接。

链接

文档：https://thrifle.com/mcp · 退货政策数据库：https://thrifle.com/return-policy · Price Predict：https://thrifle.com/price-predict · Money：https://thrifle.com/money · 联系方式：[email protected]

采用 MIT 许可。© 2026 Thrifle Technologies LLC。