CardDeals Live Gift Card Deals

CardDeals MCP 服务

CardDeals 的官方模型上下文协议（MCP）服务——可在 AI 助手（Claude、Cursor、ChatGPT 和自主购买 Agent）中直接查询和比较 700 多个知名零售、餐饮、旅游和娱乐品牌的实时折扣数字礼品卡。

• 🌐 产品主页与文档： https://carddeals.co/mcp
• ⚡ 远程 MCP 端点： https://catalog.carddeals.co/mcp
• 📑 OpenAPI REST 规范： https://catalog.carddeals.co/openapi.json
• 📋 注册表元数据： https://catalog.carddeals.co/mcp/server.json

---

🚀 主要功能

• 匿名且免费： 公测期间无需身份验证、创建账户或 API 密钥。
• 安全且只读： 提供发现和价格比较工具，不具备任何修改数据或直接结账的权限。
• 流式 HTTP： 现代远程 MCP 传输方式，兼容 Claude Desktop、Cursor 和标准 MCP 客户端。
• 实时数据： 提供二级市场的实时折扣率、卖家观察时间戳和商品状况说明。

---

🛠️ 可用的 MCP 工具

工具	描述	示例查询
search_gift_card_deals	按品牌名称或类别（食品、零售、旅游、科技、时尚）搜索当前折扣。最多返回 10 件商品。	“查找适合约会之夜的餐饮优惠”
get_gift_card_deals	获取指定品牌 slug 或商品 ID 的所有当前已验证优惠、卖家和商品状况。	“获取当前的 Starbucks 礼品卡优惠”
lookup_gift_card_deals	在一次调用中批量查询最多 10 个品牌 slug 或商品 ID。	“查询 Apple、Target 和 Airbnb 的折扣”

---

⚙️ 客户端快速入门

1. Claude Desktop

将以下内容添加到 claude_desktop_config.json：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "carddeals": {
      "type": "http",
      "url": "https://catalog.carddeals.co/mcp"
    }
  }
}

2. Cursor IDE

添加到项目的 .cursor/mcp.json 或全局 MCP 设置中：

{
  "mcpServers": {
    "carddeals": {
      "type": "http",
      "url": "https://catalog.carddeals.co/mcp"
    }
  }
}

3. REST / OpenAPI 替代方案

如果你的 Agent 框架更偏好 OpenAPI 或 REST 工具调用：

# Search deals by brand
curl "https://catalog.carddeals.co/v1/deals/search?q=starbucks&limit=5"

# Get brand details
curl "https://catalog.carddeals.co/v1/deals/brands/starbucks"

# Batch lookup
curl "https://catalog.carddeals.co/v1/deals/lookup?ids=starbucks,target,airbnb"

---

🔒 安全与数据时效规则

• 时效性： 优惠、折扣和库存会不断变动。工具会返回观察时间戳（fetched_at）和数据汇总时间戳（as_of）。
• 验证： 完成购买前，请再次确认目标卖家。
• 信息披露： 响应元数据会清楚标明第三方联盟链接和 CardDeals 自有库存。

---

📄 许可证

MIT 许可证。详情请参阅 LICENSE。