CardDeals Live Gift Card Deals
Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~2,734トークン数（ツール定義）
~10.3 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.14%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `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 件