CardDeals Live Gift Card Deals
Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.
¿Debería usar esto?
Calidad y seguridad
A
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
~2,734Tokens (definiciones de herramientas)
~10.3 KBTamaño de respuesta típico
Impacto significativo en la atención (2.14% del contexto de 128k)
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"carddeals-mcp": {
"url": "https://catalog.carddeals.co/mcp"
}
}
}Puntos de conexión remotos
https://catalog.carddeals.co/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (3)
🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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.
Esquema de entrada
{
"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"
}Esquema de salida
{
"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
}Comunidad
Evidencia
Observaciones recientes
verificadoversión no registrada3 herramientas
verificadoversión no registrada3 herramientas
verificadoversión no registrada3 herramientas