CardDeals Live Gift Card Deals
Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~2,734Token（工具定義）
~10.3 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.14%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"carddeals-mcp": {
"url": "https://catalog.carddeals.co/mcp"
}
}
}遠端端點
https://catalog.carddeals.co/mcpstreamable-http它能做什麼
工具清單
工具（3）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢search_gift_card_deals(query, category, min_discount_percent, limit, sort)
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.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"description": "Brand or merchant text, such as Starbucks or Home Depot.",
"type": "string",
"maxLength": 100
},
"category": {
"description": "Optional CardDeals category slug, such as food-dining.",
"type": "string",
"maxLength": 80
},
"min_discount_percent": {
"default": 0,
"description": "Minimum current percentage discount.",
"type": "number",
"minimum": 0,
"maximum": 100
},
"limit": {
"default": 5,
"type": "integer",
"minimum": 1,
"maximum": 10
},
"sort": {
"default": "best_discount",
"type": "string",
"enum": [
"best_discount",
"name"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"as_of": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"affiliate_disclosure": {
"type": "string"
},
"freshness_notice": {
"type": "string"
},
"query": {
"type": "object",
"properties": {
"text": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"min_discount_percent": {
"type": "number"
},
"limit": {
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991
},
"sort": {
"type": "string",
"enum": [
"best_discount",
"name"
]
}
},
"required": [
"text",
"category",
"min_discount_percent",
"limit",
"sort"
],
"additionalProperties": false
},
"total": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"canonical_url": {
"type": "string",
"format": "uri"
},
"base_domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"best_discount_percent": {
"type": "number",
"exclusiveMinimum": 0
},
"carddeals_inventory_status": {
"type": "string",
"enum": [
"included",
"unavailable"
]
},
"deals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"deal_id": {
"type": "string"
},
"provider_name": {
"type": "string"
},
"provider_slug": {
"type": "string"
},
"discount_percent": {
"type": "number"
},
"in_stock": {
"type": "boolean",
"const": true
},
"fetched_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"purchase_url": {
"type": "string",
"format": "uri"
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"variant_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coupon": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"expiration": {
"type": "string"
}
},
"required": [
"code",
"label",
"expiration"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"seller_terms": {
"type": "object",
"properties": {
"reported_guarantee_days": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
}
},
"required": [
"reported_guarantee_days",
"note"
],
"additionalProperties": false
},
"relationship": {
"type": "string",
"enum": [
"affiliate",
"direct"
]
},
"disclosure": {
"type": "string"
},
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"balance": {
"type": "number",
"exclusiveMinimum": 0
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"discount_percent": {
"type": "number",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"const": "USD"
},
"purchase_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"id",
"balance",
"price",
"discount_percent",
"currency",
"purchase_url"
],
"additionalProperties": false
}
}
},
"required": [
"deal_id",
"provider_name",
"provider_slug",
"discount_percent",
"in_stock",
"fetched_at",
"purchase_url",
"variant",
"variant_label",
"coupon",
"conditions",
"seller_terms",
"relationship",
"disclosure"
],
"additionalProperties": false
}
}
},
"required": [
"product_id",
"name",
"slug",
"canonical_url",
"base_domain",
"category",
"best_discount_percent",
"carddeals_inventory_status",
"deals"
],
"additionalProperties": false
}
}
},
"required": [
"schema_version",
"as_of",
"currency",
"affiliate_disclosure",
"freshness_notice",
"query",
"total",
"products"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢lookup_gift_card_deals(ids)
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.
輸入結構描述
{
"type": "object",
"properties": {
"ids": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 120
},
"description": "CardDeals product IDs or exact brand slugs."
}
},
"required": [
"ids"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"as_of": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"affiliate_disclosure": {
"type": "string"
},
"freshness_notice": {
"type": "string"
},
"products": {
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"canonical_url": {
"type": "string",
"format": "uri"
},
"base_domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"best_discount_percent": {
"type": "number",
"exclusiveMinimum": 0
},
"carddeals_inventory_status": {
"type": "string",
"enum": [
"included",
"unavailable"
]
},
"deals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"deal_id": {
"type": "string"
},
"provider_name": {
"type": "string"
},
"provider_slug": {
"type": "string"
},
"discount_percent": {
"type": "number"
},
"in_stock": {
"type": "boolean",
"const": true
},
"fetched_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"purchase_url": {
"type": "string",
"format": "uri"
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"variant_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coupon": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"expiration": {
"type": "string"
}
},
"required": [
"code",
"label",
"expiration"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"seller_terms": {
"type": "object",
"properties": {
"reported_guarantee_days": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
}
},
"required": [
"reported_guarantee_days",
"note"
],
"additionalProperties": false
},
"relationship": {
"type": "string",
"enum": [
"affiliate",
"direct"
]
},
"disclosure": {
"type": "string"
},
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"balance": {
"type": "number",
"exclusiveMinimum": 0
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"discount_percent": {
"type": "number",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"const": "USD"
},
"purchase_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"id",
"balance",
"price",
"discount_percent",
"currency",
"purchase_url"
],
"additionalProperties": false
}
}
},
"required": [
"deal_id",
"provider_name",
"provider_slug",
"discount_percent",
"in_stock",
"fetched_at",
"purchase_url",
"variant",
"variant_label",
"coupon",
"conditions",
"seller_terms",
"relationship",
"disclosure"
],
"additionalProperties": false
}
}
},
"required": [
"product_id",
"name",
"slug",
"canonical_url",
"base_domain",
"category",
"best_discount_percent",
"carddeals_inventory_status",
"deals"
],
"additionalProperties": false
}
},
"not_found": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"schema_version",
"as_of",
"currency",
"affiliate_disclosure",
"freshness_notice",
"products",
"not_found"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}🟢get_gift_card_deals(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.
輸入結構描述
{
"type": "object",
"properties": {
"brand": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "Exact CardDeals brand slug, product ID, or brand name."
}
},
"required": [
"brand"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}輸出結構描述
{
"type": "object",
"properties": {
"schema_version": {
"type": "string"
},
"as_of": {
"type": "string"
},
"currency": {
"type": "string",
"const": "USD"
},
"affiliate_disclosure": {
"type": "string"
},
"freshness_notice": {
"type": "string"
},
"product": {
"anyOf": [
{
"type": "object",
"properties": {
"product_id": {
"type": "string"
},
"name": {
"type": "string"
},
"slug": {
"type": "string"
},
"canonical_url": {
"type": "string",
"format": "uri"
},
"base_domain": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"category": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"name",
"slug"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"best_discount_percent": {
"type": "number",
"exclusiveMinimum": 0
},
"carddeals_inventory_status": {
"type": "string",
"enum": [
"included",
"unavailable"
]
},
"deals": {
"type": "array",
"items": {
"type": "object",
"properties": {
"deal_id": {
"type": "string"
},
"provider_name": {
"type": "string"
},
"provider_slug": {
"type": "string"
},
"discount_percent": {
"type": "number"
},
"in_stock": {
"type": "boolean",
"const": true
},
"fetched_at": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"purchase_url": {
"type": "string",
"format": "uri"
},
"variant": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"variant_label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"coupon": {
"anyOf": [
{
"type": "object",
"properties": {
"code": {
"type": "string"
},
"label": {
"type": "string"
},
"expiration": {
"type": "string"
}
},
"required": [
"code",
"label",
"expiration"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditions": {
"type": "array",
"items": {
"type": "string"
}
},
"seller_terms": {
"type": "object",
"properties": {
"reported_guarantee_days": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "null"
}
]
},
"note": {
"type": "string"
}
},
"required": [
"reported_guarantee_days",
"note"
],
"additionalProperties": false
},
"relationship": {
"type": "string",
"enum": [
"affiliate",
"direct"
]
},
"disclosure": {
"type": "string"
},
"listings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"balance": {
"type": "number",
"exclusiveMinimum": 0
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"discount_percent": {
"type": "number",
"exclusiveMinimum": 0
},
"currency": {
"type": "string",
"const": "USD"
},
"purchase_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"id",
"balance",
"price",
"discount_percent",
"currency",
"purchase_url"
],
"additionalProperties": false
}
}
},
"required": [
"deal_id",
"provider_name",
"provider_slug",
"discount_percent",
"in_stock",
"fetched_at",
"purchase_url",
"variant",
"variant_label",
"coupon",
"conditions",
"seller_terms",
"relationship",
"disclosure"
],
"additionalProperties": false
}
}
},
"required": [
"product_id",
"name",
"slug",
"canonical_url",
"base_domain",
"category",
"best_discount_percent",
"carddeals_inventory_status",
"deals"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"message": {
"type": "string"
}
},
"required": [
"schema_version",
"as_of",
"currency",
"affiliate_disclosure",
"freshness_notice",
"product"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}社群
證據
近期觀測
已驗證未記錄版本3 個工具
已驗證未記錄版本3 個工具
已驗證未記錄版本3 個工具