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 分