CardDeals Live Gift Card Deals

CardDeals MCP サーバー

CardDeals の公式 Model Context Protocol（MCP）サーバーです。Claude、Cursor、ChatGPT、自律型購入エージェントなどの AI アシスタントから、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 キーは不要です。
• 安全な読み取り専用： 変更や直接のチェックアウトを行う権限を一切持たず、検索と価格比較のツールを提供します。
• Streamable HTTP： Claude Desktop、Cursor、標準的な MCP クライアントと互換性のある最新のリモート MCP トランスポートです。
• リアルタイムデータ： セカンダリーマーケットプレイス全体の割引率、販売者の観測タイムスタンプ、コンディションの開示情報を確認できます。

---

🛠️ 利用可能な MCP ツール

ツール	説明	クエリ例
search_gift_card_deals	ブランド名のテキストまたはカテゴリ（Food、Retail、Travel、Tech、Fashion）で現在の割引を検索します。最大10件の商品を返します。	「デートの夜にぴったりな飲食店の割引を探して」
get_gift_card_deals	指定したブランドのスラッグまたは商品 ID について、現在有効なオファー、販売者、コンディションをすべて取得します。	「現在のStarbucksギフトカードの割引を取得して」
lookup_gift_card_deals	1回の呼び出しで、最大10件のブランドのスラッグまたは商品 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 の代替手段

エージェントフレームワークで 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。詳細は LICENSE をご覧ください。