CardDeals Live Gift Card Deals
Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~2,734Tokens (Tool-Definitionen)
~10.3 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (2.14% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"carddeals-mcp": {
"url": "https://catalog.carddeals.co/mcp"
}
}
}Remote-Endpunkte
https://catalog.carddeals.co/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (3)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢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.
Eingabe-Schema
{
"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"
}Ausgabe-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.
Eingabe-Schema
{
"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"
}Ausgabe-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.
Eingabe-Schema
{
"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"
}Ausgabe-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
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet3 Tools
verifiziertVersion nicht aufgezeichnet3 Tools
verifiziertVersion nicht aufgezeichnet3 Tools