MCP 服务器

CardDeals Live Gift Card Deals

io.github.cello305/carddeals-mcp
电商与零售 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Searches and compares current U.S. gift-card discounts from validated providers without enabling purchases.

get_gift_card_deals
Get live deals for one gift-card 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', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['brand'], 'properties': {'brand': {'type': 'string', 'maxLength': 120, 'minLength': 1, 'description': 'Exact CardDeals brand slug, product ID, or brand name.'}}}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['schema_version', 'as_of', 'currency', 'affiliate_disclosure', 'freshness_notice', 'product'], 'properties': {'as_of': {'type': 'string'}, 'message': {'type': 'string'}, 'product': {'anyOf': [{'type': 'object', 'required': ['product_id', 'name', 'slug', 'canonical_url', 'base_domain', 'category', 'best_discount_percent', 'carddeals_inventory_status', 'deals'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'deals': {'type': 'array', 'items': {'type': 'object', 'required': ['deal_id', 'provider_name', 'provider_slug', 'discount_percent', 'in_stock', 'fetched_at', 'purchase_url', 'variant', 'variant_label', 'coupon', 'conditions', 'seller_terms', 'relationship', 'disclosure'], 'properties': {'coupon': {'anyOf': [{'type': 'object', 'required': ['code', 'label', 'expiration'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}, 'expiration': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'deal_id': {'type': 'string'}, 'variant': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean', 'const': True}, 'listings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'balance', 'price', 'discount_percent', 'currency', 'purchase_url'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'number', 'exclusiveMinimum': 0}, 'balance': {'type': 'number', 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'const': 'USD'}, 'purchase_url': {'type': 'string', 'format': 'uri'}, 'discount_percent': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}}, 'conditions': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}, 'fetched_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'purchase_url': {'type': 'string', 'format': 'uri'}, 'relationship': {'enum': ['affiliate', 'direct'], 'type': 'string'}, 'seller_terms': {'type': 'object', 'required': ['reported_guarantee_days', 'note'], 'properties': {'note': {'type': 'string'}, 'reported_guarantee_days': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provider_name': {'type': 'string'}, 'provider_slug': {'type': 'string'}, 'variant_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'discount_percent': {'type': 'number'}}, 'additionalProperties': False}}, 'category': {'anyOf': [{'type': 'object', 'required': ['name', 'slug'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'product_id': {'type': 'string'}, 'base_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_url': {'type': 'string', 'format': 'uri'}, 'best_discount_percent': {'type': 'number', 'exclusiveMinimum': 0}, 'carddeals_inventory_status': {'enum': ['included', 'unavailable'], 'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'currency': {'type': 'string', 'const': 'USD'}, 'schema_version': {'type': 'string'}, 'freshness_notice': {'type': 'string'}, 'affiliate_disclosure': {'type': 'string'}}, 'additionalProperties': False}
lookup_gift_card_deals
Look up multiple gift-card brands
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', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['ids'], 'properties': {'ids': {'type': 'array', 'items': {'type': 'string', 'maxLength': 120, 'minLength': 1}, 'maxItems': 10, 'minItems': 1, 'description': 'CardDeals product IDs or exact brand slugs.'}}}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['schema_version', 'as_of', 'currency', 'affiliate_disclosure', 'freshness_notice', 'products', 'not_found'], 'properties': {'as_of': {'type': 'string'}, 'currency': {'type': 'string', 'const': 'USD'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['product_id', 'name', 'slug', 'canonical_url', 'base_domain', 'category', 'best_discount_percent', 'carddeals_inventory_status', 'deals'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'deals': {'type': 'array', 'items': {'type': 'object', 'required': ['deal_id', 'provider_name', 'provider_slug', 'discount_percent', 'in_stock', 'fetched_at', 'purchase_url', 'variant', 'variant_label', 'coupon', 'conditions', 'seller_terms', 'relationship', 'disclosure'], 'properties': {'coupon': {'anyOf': [{'type': 'object', 'required': ['code', 'label', 'expiration'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}, 'expiration': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'deal_id': {'type': 'string'}, 'variant': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean', 'const': True}, 'listings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'balance', 'price', 'discount_percent', 'currency', 'purchase_url'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'number', 'exclusiveMinimum': 0}, 'balance': {'type': 'number', 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'const': 'USD'}, 'purchase_url': {'type': 'string', 'format': 'uri'}, 'discount_percent': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}}, 'conditions': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}, 'fetched_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'purchase_url': {'type': 'string', 'format': 'uri'}, 'relationship': {'enum': ['affiliate', 'direct'], 'type': 'string'}, 'seller_terms': {'type': 'object', 'required': ['reported_guarantee_days', 'note'], 'properties': {'note': {'type': 'string'}, 'reported_guarantee_days': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provider_name': {'type': 'string'}, 'provider_slug': {'type': 'string'}, 'variant_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'discount_percent': {'type': 'number'}}, 'additionalProperties': False}}, 'category': {'anyOf': [{'type': 'object', 'required': ['name', 'slug'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'product_id': {'type': 'string'}, 'base_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_url': {'type': 'string', 'format': 'uri'}, 'best_discount_percent': {'type': 'number', 'exclusiveMinimum': 0}, 'carddeals_inventory_status': {'enum': ['included', 'unavailable'], 'type': 'string'}}, 'additionalProperties': False}}, 'not_found': {'type': 'array', 'items': {'type': 'string'}}, 'schema_version': {'type': 'string'}, 'freshness_notice': {'type': 'string'}, 'affiliate_disclosure': {'type': 'string'}}, 'additionalProperties': False}
search_gift_card_deals
Search live gift-card deals
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', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'sort': {'enum': ['best_discount', 'name'], 'type': 'string', 'default': 'best_discount'}, 'limit': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1}, 'query': {'type': 'string', 'maxLength': 100, 'description': 'Brand or merchant text, such as Starbucks or Home Depot.'}, 'category': {'type': 'string', 'maxLength': 80, 'description': 'Optional CardDeals category slug, such as food-dining.'}, 'min_discount_percent': {'type': 'number', 'default': 0, 'maximum': 100, 'minimum': 0, 'description': 'Minimum current percentage discount.'}}}
输出模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['schema_version', 'as_of', 'currency', 'affiliate_disclosure', 'freshness_notice', 'query', 'total', 'products'], 'properties': {'as_of': {'type': 'string'}, 'query': {'type': 'object', 'required': ['text', 'category', 'min_discount_percent', 'limit', 'sort'], 'properties': {'sort': {'enum': ['best_discount', 'name'], 'type': 'string'}, 'text': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'limit': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'min_discount_percent': {'type': 'number'}}, 'additionalProperties': False}, 'total': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'currency': {'type': 'string', 'const': 'USD'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['product_id', 'name', 'slug', 'canonical_url', 'base_domain', 'category', 'best_discount_percent', 'carddeals_inventory_status', 'deals'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}, 'deals': {'type': 'array', 'items': {'type': 'object', 'required': ['deal_id', 'provider_name', 'provider_slug', 'discount_percent', 'in_stock', 'fetched_at', 'purchase_url', 'variant', 'variant_label', 'coupon', 'conditions', 'seller_terms', 'relationship', 'disclosure'], 'properties': {'coupon': {'anyOf': [{'type': 'object', 'required': ['code', 'label', 'expiration'], 'properties': {'code': {'type': 'string'}, 'label': {'type': 'string'}, 'expiration': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'deal_id': {'type': 'string'}, 'variant': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'in_stock': {'type': 'boolean', 'const': True}, 'listings': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'balance', 'price', 'discount_percent', 'currency', 'purchase_url'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'number', 'exclusiveMinimum': 0}, 'balance': {'type': 'number', 'exclusiveMinimum': 0}, 'currency': {'type': 'string', 'const': 'USD'}, 'purchase_url': {'type': 'string', 'format': 'uri'}, 'discount_percent': {'type': 'number', 'exclusiveMinimum': 0}}, 'additionalProperties': False}}, 'conditions': {'type': 'array', 'items': {'type': 'string'}}, 'disclosure': {'type': 'string'}, 'fetched_at': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'purchase_url': {'type': 'string', 'format': 'uri'}, 'relationship': {'enum': ['affiliate', 'direct'], 'type': 'string'}, 'seller_terms': {'type': 'object', 'required': ['reported_guarantee_days', 'note'], 'properties': {'note': {'type': 'string'}, 'reported_guarantee_days': {'anyOf': [{'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, {'type': 'null'}]}}, 'additionalProperties': False}, 'provider_name': {'type': 'string'}, 'provider_slug': {'type': 'string'}, 'variant_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'discount_percent': {'type': 'number'}}, 'additionalProperties': False}}, 'category': {'anyOf': [{'type': 'object', 'required': ['name', 'slug'], 'properties': {'name': {'type': 'string'}, 'slug': {'type': 'string'}}, 'additionalProperties': False}, {'type': 'null'}]}, 'product_id': {'type': 'string'}, 'base_domain': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_url': {'type': 'string', 'format': 'uri'}, 'best_discount_percent': {'type': 'number', 'exclusiveMinimum': 0}, 'carddeals_inventory_status': {'enum': ['included', 'unavailable'], 'type': 'string'}}, 'additionalProperties': False}}, 'schema_version': {'type': 'string'}, 'freshness_notice': {'type': 'string'}, 'affiliate_disclosure': {'type': 'string'}}, 'additionalProperties': False}
已添加
get_gift_card_deals
2026年9月17日 12:40
已添加
lookup_gift_card_deals
2026年9月17日 12:40
已添加
search_gift_card_deals
2026年9月17日 12:40