CardDeals Live Gift Card Deals

io.github.cello305由 GitHub 账号 cello305 发布v1.0.1更新于 Nov 2, 2026

Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.

已验证Streamable HTTP可网页运行金融商业与电商

概览

AI 生成的概览

只读的远程 MCP 服务器,让助手按品牌或类别搜索并比较当前美国礼品卡折扣报价。

可以做什么
  • 按品牌文本或类别搜索礼品卡优惠,最多返回 10 个商品及供应商报价和链接
  • 针对某个确切的品牌 slug、商品 ID 或品牌名,获取完整的当前供应商、卖家与条件详情
  • 一次调用批量解析最多 10 个确切的商品 ID 或品牌 slug,未知 ID 会以未找到返回
  • 在报价之外返回观测时间戳和汇总时间戳,便于判断数据新鲜度
适用场景
适合用户想发现、比较或查询美国品牌的当前折扣礼品卡优惠,或询问餐饮、零售、旅行、科技等类别的优惠时使用。
运行要求
需要一个远程 streamable HTTP 端点;公开测试期间无需认证、账号、API 密钥或本地运行时。需要能访问该服务端点。
安装前请注意
工具为只读,不提供购买操作,但折扣和库存变化频繁,购买前应重新核对目标卖家。响应中可能包含第三方联盟链接和 CardDeals 自有库存,并在元数据中标注。

安装

在 SourceWeft 中

  1. 打开 控制台中的 CardDeals Live Gift Card Deals,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.cello305%2Fcarddeals-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "carddeals-live-gift-card-deals": {
      "type": "http",
      "url": "https://catalog.carddeals.co/mcp"
    }
  }
}

README

CardDeals MCP Server [MCP] [Website] [License: MIT]

Official Model Context Protocol (MCP) server for CardDeals — query and compare real-time discounted digital gift cards across 700+ top retail, dining, travel, and entertainment brands directly inside AI assistants (Claude, Cursor, ChatGPT, and autonomous purchasing agents).


🚀 Key Features

  • Anonymous & Free: No authentication, account creation, or API keys required during public beta.
  • Safe & Read-Only: Exposes discovery and price comparison tools with zero mutation or direct checkout permissions.
  • Streamable HTTP: Modern remote MCP transport compatible with Claude Desktop, Cursor, and standard MCP clients.
  • Real-Time Data: Live discount rates, seller observation timestamps, and condition disclosures across secondary marketplaces.

🛠️ Available MCP Tools

ToolDescriptionExample Query
search_gift_card_dealsSearch current discounts by brand text or category (Food, Retail, Travel, Tech, Fashion). Returns up to 10 products."Find dining deals for date night"
get_gift_card_dealsRetrieve all current validated offers, sellers, and conditions for a specific brand slug or product ID."Get current Starbucks gift card deals"
lookup_gift_card_dealsBatch resolve up to 10 brand slugs or product IDs in a single call."Check discounts for Apple, Target, and Airbnb"

⚙️ Client Quickstart

1. Claude Desktop

Add the following to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
json
{  "mcpServers": {    "carddeals": {      "type": "http",      "url": "https://catalog.carddeals.co/mcp"    }  }}

2. Cursor IDE

Add to your project's .cursor/mcp.json or global MCP settings:

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

3. REST / OpenAPI Alternative

If your agent framework prefers OpenAPI or REST tool calling:

bash
# Search deals by brandcurl "https://catalog.carddeals.co/v1/deals/search?q=starbucks&limit=5"
# Get brand detailscurl "https://catalog.carddeals.co/v1/deals/brands/starbucks"
# Batch lookupcurl "https://catalog.carddeals.co/v1/deals/lookup?ids=starbucks,target,airbnb"

🔒 Safety & Freshness Rules

  • Freshness: Deals, discounts, and inventory fluctuate constantly. Tools return observation timestamps (fetched_at) and assembly timestamps (as_of).
  • Validation: Recheck the destination seller before completing a purchase.
  • Disclosures: Third-party affiliate links and CardDeals-owned inventory are clearly labeled in response metadata.

📄 License

MIT License. See LICENSE for details.

来源:README.md,提交 69f7441

工具

3

search_gift_card_deals

Search live gift-card deals

Use this when the user wants to discover or compare current U.S. gift-card discounts across brands or within a category. Returns structured provider offers and current destination links. Do not use it for an exact single brand when get_gift_card_deals can return the complete provider set.

输入参数sortlimitquerycategorymin_discount_percent

lookup_gift_card_deals

Look up multiple gift-card brands

Use this when the user supplies up to 10 exact CardDeals product IDs or brand slugs to compare in one call. Product IDs use the form brand:starbucks. Do not use it for fuzzy discovery; use search_gift_card_deals instead. Unknown IDs are returned in not_found instead of being guessed.

输入参数ids必填

get_gift_card_deals

Get live deals for one gift-card brand

Use this when the user asks for complete current provider details for one exact gift-card brand. Accepts a brand slug, product ID such as brand:starbucks, or exact brand name. Do not use it for broad category discovery. Returns no purchase action—only current provider or CardDeals checkout links.

输入参数brand必填

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分