MCP-Server
CardDeals Live Gift Card Deals
io.github.cello305/carddeals-mcp
Was dieses MCP kann
Searches and compares current U.S. gift-card discounts from validated providers without enabling purchases.
Funktionen
Tools
3
Tools
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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Nur Lesen
Externer Zugriff
Idempotent
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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}
Verlauf
Letzte Tool-Änderungen
Hinzugefügt
get_gift_card_deals
17. September 2026 12:40
Hinzugefügt
lookup_gift_card_deals
17. September 2026 12:40
Hinzugefügt
search_gift_card_deals
17. September 2026 12:40
Entdecken
Ähnliche MCP-Server
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
apex-x1
xyz.apexfaucet/apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
SpellBook Finance
com.spellbook-finance/mcp
Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Digital Manager Guru
io.github.mcp-dir/guru-mcp
Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…
Pagar.me
io.github.mcp-dir/pagarme-mcp
Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
AgentLux
io.github.agentlux/agentlux
Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…