CardDeals Live Gift Card Deals
Server Details
Search current U.S. gift-card discounts from validated providers. Anonymous and read-only.
- Status
- Healthy
- Uptime
- 100.0% over 55 days
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- cello305/carddeals-mcp
- GitHub Stars
- 0
TDQS
Scored across 3 tools
The three tools have clearly delineated purposes: get for one exact brand's full provider set, lookup for batching up to 10 known IDs, and search for fuzzy discovery/category browsing. Descriptions explicitly cross-reference each other (e.g. 'use search_gift_card_deals instead') to steer agents away from misselection.
All three tools follow the identical verb_noun_gift_card_deals pattern (get/lookup/search), making the suffix a stable domain marker and the verbs the only differentiator. No mixing of conventions.
Three tools is lean but justified for a read-only deals feed, since each maps to a distinct access mode (single, batch, discovery). Slightly thin—a category-listing tool could round it out—but nothing feels redundant.
The read-only surface covers the core lifecycle: discover via search, resolve single brands fully via get, and batch-compare via lookup with explicit not_found handling. Missing only ancillary operations like listing available categories or providers, which search likely absorbs as workarounds.
Available Tools
3 toolsget_gift_card_dealsGet live deals for one gift-card brandARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| brand | Yes | Exact CardDeals brand slug, product ID, or brand name. |
Output Schema
| Name | Required | Description |
|---|---|---|
| as_of | Yes | |
| message | No | |
| product | Yes | |
| currency | Yes | |
| schema_version | Yes | |
| freshness_notice | Yes | |
| affiliate_disclosure | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
While annotations cover safety (readOnlyHint), the description adds crucial behavioral context regarding the *output*. It informs the agent that the tool 'Returns no purchase action—only current provider or CardDeals checkout links,' which dictates the expected function and scope of the resulting data.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is highly concise and well-structured, logically flowing from the use case to input constraints, to exclusion rules, and finally to output characteristics. No part is superfluous.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given that the schema is fully defined and the output schema exists, the description provides all necessary context—input formats, scope limitations, and operational guarantees—to correctly select and invoke the tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although the schema has 100% coverage, the description adds vital semantic meaning by detailing the expected format of the input parameter 'brand': 'brand slug, product ID such as brand:starbucks, or exact brand name.' This guides the agent on expected input syntax.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the purpose (getting live deals) and the specific scope (one exact brand). By explicitly stating, 'Do not use it for broad category discovery,' it successfully distinguishes this tool from potential siblings like search_gift_card_deals.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides crystal clear usage rules by defining the precise user intent ('when the user asks for complete current provider details for one exact gift-card brand') and explicitly defining a negative use case ('Do not use it for broad category discovery').
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
lookup_gift_card_dealsLook up multiple gift-card brandsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | CardDeals product IDs or exact brand slugs. |
Output Schema
| Name | Required | Description |
|---|---|---|
| as_of | Yes | |
| currency | Yes | |
| products | Yes | |
| not_found | Yes | |
| schema_version | Yes | |
| freshness_notice | Yes | |
| affiliate_disclosure | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
While annotations cover read-only status, the description adds crucial behavioral traits regarding execution. Specifically, it discloses that unknown IDs will be returned in a 'not_found' status rather than being 'guessed' or silently failed, which is vital operational knowledge.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The definition is highly condensed and effective. It front-loads the constraints and use cases while maintaining a concise structure, ensuring every sentence adds instructional or clarifying value with zero unnecessary filler.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The definition is complete for an orchestration layer. It defines the scope, input constraints, error handling for unknown inputs, and the operational boundary against which other sibling tools operate, leaving no significant logical gaps for the agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Although schema coverage is 100%, the description adds critical semantic meaning that the schema lacks: the required format for product IDs ('brand:starbucks'). This informs the agent exactly how to structure the data provided in the 'ids' array.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool's purpose: to compare multiple exact product IDs or brand slugs in a single call. It specifies the constraints (up to 10 IDs), making the intent unambiguous and distinct from the 'search' functionality.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The usage guidelines are explicit and robust. It defines the boundaries of the tool (exact IDs/slug format) and provides a direct instruction for when *not* to use it, explicitly routing users toward 'search_gift_card_deals' for fuzzy discovery.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_gift_card_dealsSearch live gift-card dealsARead-onlyIdempotentInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | best_discount | |
| limit | No | ||
| query | No | Brand or merchant text, such as Starbucks or Home Depot. | |
| category | No | Optional CardDeals category slug, such as food-dining. | |
| min_discount_percent | No | Minimum current percentage discount. |
Output Schema
| Name | Required | Description |
|---|---|---|
| as_of | Yes | |
| query | Yes | |
| total | Yes | |
| currency | Yes | |
| products | Yes | |
| schema_version | Yes | |
| freshness_notice | Yes | |
| affiliate_disclosure | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint, openWorldHint, idempotentHint and destructiveHint=false, and an output schema exists, so the safety and return-shape burden is largely covered. The description adds genuine context the annotations lack — U.S.-only coverage and that results are live/current — but says nothing about pagination, rate limits, or freshness lag. Under rich annotation coverage this is a moderate, not exceptional, contribution.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Three compact sentences, front-loaded with the use case before the exclusion, and the return-shape note last. No filler or restatement of the title.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a read-only search tool with an output schema and full annotation coverage, the description supplies everything missing from structured fields: region scope, liveness of the deals, and the sibling routing rule. Remaining gaps (pagination, sorting behavior) are covered by the schema's defaults and bounds.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 60%, with query and category documented in-schema; the description only restates the brand/category axis implicitly. It adds nothing for sort, limit, or min_discount_percent, so it neither compensates for the coverage gap nor detracts.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Specific verb (discover/compare) paired with a specific resource (current U.S. gift-card discounts) and scope (across brands or within a category). It explicitly names the sibling it is not, so an agent can separate it from get_gift_card_deals without opening either schema.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Gives both a when-to-use condition (discover or compare across brands/categories) and a when-not-to-use condition (exact single brand), naming the alternative get_gift_card_deals as the fallback. Nothing about routing is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
3 tool updates
- Changed
get_gift_card_deals1 field changed- changed
Output schema / properties / product / anyOfPrevious value: -[ - { - "additionalProperties": false, - "properties": { - "base_domain": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "best_discount_percent": { - "exclusiveMinimum": 0, - "type": "number" - }, - "canonical_url": { - "format": "uri", - "type": "string" - }, - "carddeals_inventory_status": { - "enum": [ - "included", - "unavailable" - ], - "type": "string" - }, - "category": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "name": { - "type": "string" - }, - "slug": { - "type": "string" - } - }, - "required": [ - "name", - "slug" - ], - "type": "object" - }, - { - "type": "null" - } - ] - }, - "deals": { - "items": { - "additionalProperties": false, - "properties": { - "conditions": { - "items": { - "type": "string" - }, - "type": "array" - }, - "coupon": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "code": { - "type": "string" - }, - "expiration": { - "type": "string" - }, - "label": { - "type": "string" - } - }, - "required": [ - "code", - "label", - "expiration" - ], - "type": "object" - }, - { - "type": "null" - } - ] - }, - "deal_id": { - "type": "string" - }, - "disclosure": { - "type": "string" - }, - "discount_percent": { - "type": "number" - }, - "fetched_at": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "id_verification_required": { - "type": "boolean" - }, - "in_stock": { - "const": true, - "type": "boolean" - }, - "listings": { - "items": { - "additionalProperties": false, - "properties": { - "balance": { - "exclusiveMinimum": 0, - "type": "number" - }, - "currency": { - "const": "USD", - "type": "string" - }, - "discount_percent": { - "exclusiveMinimum": 0, - "type": "number" - }, - "id": { - "type": "string" - }, - "price": { - "exclusiveMinimum": 0, - "type": "number" - }, - "purchase_url": { - "format": "uri", - "type": "string" - } - }, - "required": [ - "id", - "balance", - "price", - "discount_percent", - "currency", - "purchase_url" - ], - "type": "object" - }, - "type": "array" - }, - "provider_name": { - "type": "string" - }, - "provider_slug": { - "type": "string" - }, - "purchase_url": { - "format": "uri", - "type": "string" - }, - "relationship": { - "enum": [ - "affiliate", - "direct" - ], - "type": "string" - }, - "seller_terms": { - "additionalProperties": false, - "properties": { - "note": { - "type": "string" - }, - "reported_guarantee_days": { - "anyOf": [ - { - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "reported_guarantee_days", - "note" - ], - "type": "object" - }, - "variant": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "variant_label": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "deal_id", - "provider_name", - "provider_slug", - "discount_percent", - "in_stock", - "fetched_at", - "purchase_url", - "variant", - "variant_label", - "coupon", - "conditions", - "seller_terms", - "relationship", - "disclosure", - "id_verification_required" - ], - "type": "object" - }, - "type": "array" - }, - "name": { - "type": "string" - }, - "product_id": { - "type": "string" - }, - "slug": { - "type": "string" - } - }, - "required": [ - "product_id", - "name", - "slug", - "canonical_url", - "base_domain", - "category", - "best_discount_percent", - "carddeals_inventory_status", - "deals" - ], - "type": "object" - }, - { - "type": "null" - } -]New value: +[ + { + "additionalProperties": false, + "properties": { + "base_domain": { + "type": [ + "string", + "null" + ] + }, + "best_discount_percent": { + "exclusiveMinimum": 0, + "type": "number" + }, + "canonical_url": { + "format": "uri", + "type": "string" + }, + "carddeals_inventory_status": { + "enum": [ + "included", + "unavailable" + ], + "type": "string" + }, + "category": { + "anyOf": [ + { + "additionalProperties": false, + "properties": { + "name": { + "type": "string" + }, + "slug": { + "type": "string" + } + }, + "required": [ + "name", + "slug" + ], + "type": "object" + }, + { + "type": "null" + } + ] + }, + "deals": { + "items": { + "additionalProperties": false, + "properties": { + "conditions": { + "items": { + "type": "string" + }, + "type": "array" + }, + "coupon": { + "anyOf": [ + { + "additionalProperties": false, + "properties": { + "code": { + "type": "string" + }, + "expiration": { + "type": "string" + }, + "label": { + "type": "string" + } + }, + "required": [ + "code", + "label", + "expiration" + ], + "type": "object" + }, + { + "type": "null" + } + ] + }, + "deal_id": { + "type": "string" + }, + "disclosure": { + "type": "string" + }, + "discount_percent": { + "type": "number" + }, + "fetched_at": { + "type": [ + "string", + "null" + ] + }, + "id_verification_required": { + "type": "boolean" + }, + "in_stock": { + "const": true, + "type": "boolean" + }, + "listings": { + "items": { + "additionalProperties": false, + "properties": { + "balance": { + "exclusiveMinimum": 0, + "type": "number" + }, + "currency": { + "const": "USD", + "type": "string" + }, + "discount_percent": { + "exclusiveMinimum": 0, + "type": "number" + }, + "id": { + "type": "string" + }, + "price": { + "exclusiveMinimum": 0, + "type": "number" + }, + "purchase_url": { + "format": "uri", + "type": "string" + } + }, + "required": [ + "id", + "balance", + "price", + "discount_percent", + "currency", + "purchase_url" + ], + "type": "object" + }, + "type": "array" + }, + "provider_name": { + "type": "string" + }, + "provider_slug": { + "type": "string" + }, + "purchase_url": { + "format": "uri", + "type": "string" + }, + "relationship": { + "enum": [ + "affiliate", + "direct" + ], + "type": "string" + }, + "seller_terms": { + "additionalProperties": false, + "properties": { + "note": { + "type": "string" + }, + "reported_guarantee_days": { + "anyOf": [ + { + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "reported_guarantee_days", + "note" + ], + "type": "object" + }, + "variant": { + "type": [ + "string", + "null" + ] + }, + "variant_label": { + "type": [ + "string", + "null" + ] + } + }, + "required": [ + "deal_id", + "provider_name", + "provider_slug", + "discount_percent", + "in_stock", + "fetched_at", + "purchase_url", + "variant", + "variant_label", + "coupon", + "conditions", + "seller_terms", + "relationship", + "disclosure", + "id_verification_required" + ], + "type": "object" + }, + "type": "array" + }, + "name": { + "type": "string" + }, + "product_id": { + "type": "string" + }, + "slug": { + "type": "string" + } + }, + "required": [ + "product_id", + "name", + "slug", + "canonical_url", + "base_domain", + "category", + "best_discount_percent", + "carddeals_inventory_status", + "deals" + ], + "type": "object" + }, + { + "type": "null" + } +]
- Changed
lookup_gift_card_deals8 fields changed- removed
Output schema / properties / products / items / properties / base_domain / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / base_domain / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / products / items / properties / deals / items / properties / fetched_at / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / deals / items / properties / fetched_at / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / products / items / properties / deals / items / properties / variant / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / deals / items / properties / variant / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / products / items / properties / deals / items / properties / variant_label / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / deals / items / properties / variant_label / typeAdded value: +[ + "string", + "null" +]
- Changed
search_gift_card_deals12 fields changed- removed
Output schema / properties / products / items / properties / base_domain / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / base_domain / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / products / items / properties / deals / items / properties / fetched_at / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / deals / items / properties / fetched_at / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / products / items / properties / deals / items / properties / variant / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / deals / items / properties / variant / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / products / items / properties / deals / items / properties / variant_label / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / products / items / properties / deals / items / properties / variant_label / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / query / properties / category / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / query / properties / category / typeAdded value: +[ + "string", + "null" +] - removed
Output schema / properties / query / properties / text / anyOfRemoved value: -[ - { - "type": "string" - }, - { - "type": "null" - } -] - added
Output schema / properties / query / properties / text / typeAdded value: +[ + "string", + "null" +]
3 tool updates
- Changed
get_gift_card_deals1 field changed- changed
Output schema / properties / product / anyOfPrevious value: -[ - { - "additionalProperties": false, - "properties": { - "base_domain": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "best_discount_percent": { - "exclusiveMinimum": 0, - "type": "number" - }, - "canonical_url": { - "format": "uri", - "type": "string" - }, - "carddeals_inventory_status": { - "enum": [ - "included", - "unavailable" - ], - "type": "string" - }, - "category": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "name": { - "type": "string" - }, - "slug": { - "type": "string" - } - }, - "required": [ - "name", - "slug" - ], - "type": "object" - }, - { - "type": "null" - } - ] - }, - "deals": { - "items": { - "additionalProperties": false, - "properties": { - "conditions": { - "items": { - "type": "string" - }, - "type": "array" - }, - "coupon": { - "anyOf": [ - { - "additionalProperties": false, - "properties": { - "code": { - "type": "string" - }, - "expiration": { - "type": "string" - }, - "label": { - "type": "string" - } - }, - "required": [ - "code", - "label", - "expiration" - ], - "type": "object" - }, - { - "type": "null" - } - ] - }, - "deal_id": { - "type": "string" - }, - "disclosure": { - "type": "string" - }, - "discount_percent": { - "type": "number" - }, - "fetched_at": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "in_stock": { - "const": true, - "type": "boolean" - }, - "listings": { - "items": { - "additionalProperties": false, - "properties": { - "balance": { - "exclusiveMinimum": 0, - "type": "number" - }, - "currency": { - "const": "USD", - "type": "string" - }, - "discount_percent": { - "exclusiveMinimum": 0, - "type": "number" - }, - "id": { - "type": "string" - }, - "price": { - "exclusiveMinimum": 0, - "type": "number" - }, - "purchase_url": { - "format": "uri", - "type": "string" - } - }, - "required": [ - "id", - "balance", - "price", - "discount_percent", - "currency", - "purchase_url" - ], - "type": "object" - }, - "type": "array" - }, - "provider_name": { - "type": "string" - }, - "provider_slug": { - "type": "string" - }, - "purchase_url": { - "format": "uri", - "type": "string" - }, - "relationship": { - "enum": [ - "affiliate", - "direct" - ], - "type": "string" - }, - "seller_terms": { - "additionalProperties": false, - "properties": { - "note": { - "type": "string" - }, - "reported_guarantee_days": { - "anyOf": [ - { - "exclusiveMinimum": 0, - "maximum": 9007199254740991, - "type": "integer" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "reported_guarantee_days", - "note" - ], - "type": "object" - }, - "variant": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - }, - "variant_label": { - "anyOf": [ - { - "type": "string" - }, - { - "type": "null" - } - ] - } - }, - "required": [ - "deal_id", - "provider_name", - "provider_slug", - "discount_percent", - "in_stock", - "fetched_at", - "purchase_url", - "variant", - "variant_label", - "coupon", - "conditions", - "seller_terms", - "relationship", - "disclosure" - ], - "type": "object" - }, - "type": "array" - }, - "name": { - "type": "string" - }, - "product_id": { - "type": "string" - }, - "slug": { - "type": "string" - } - }, - "required": [ - "product_id", - "name", - "slug", - "canonical_url", - "base_domain", - "category", - "best_discount_percent", - "carddeals_inventory_status", - "deals" - ], - "type": "object" - }, - { - "type": "null" - } -]New value: +[ + { + "additionalProperties": false, + "properties": { + "base_domain": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "best_discount_percent": { + "exclusiveMinimum": 0, + "type": "number" + }, + "canonical_url": { + "format": "uri", + "type": "string" + }, + "carddeals_inventory_status": { + "enum": [ + "included", + "unavailable" + ], + "type": "string" + }, + "category": { + "anyOf": [ + { + "additionalProperties": false, + "properties": { + "name": { + "type": "string" + }, + "slug": { + "type": "string" + } + }, + "required": [ + "name", + "slug" + ], + "type": "object" + }, + { + "type": "null" + } + ] + }, + "deals": { + "items": { + "additionalProperties": false, + "properties": { + "conditions": { + "items": { + "type": "string" + }, + "type": "array" + }, + "coupon": { + "anyOf": [ + { + "additionalProperties": false, + "properties": { + "code": { + "type": "string" + }, + "expiration": { + "type": "string" + }, + "label": { + "type": "string" + } + }, + "required": [ + "code", + "label", + "expiration" + ], + "type": "object" + }, + { + "type": "null" + } + ] + }, + "deal_id": { + "type": "string" + }, + "disclosure": { + "type": "string" + }, + "discount_percent": { + "type": "number" + }, + "fetched_at": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "id_verification_required": { + "type": "boolean" + }, + "in_stock": { + "const": true, + "type": "boolean" + }, + "listings": { + "items": { + "additionalProperties": false, + "properties": { + "balance": { + "exclusiveMinimum": 0, + "type": "number" + }, + "currency": { + "const": "USD", + "type": "string" + }, + "discount_percent": { + "exclusiveMinimum": 0, + "type": "number" + }, + "id": { + "type": "string" + }, + "price": { + "exclusiveMinimum": 0, + "type": "number" + }, + "purchase_url": { + "format": "uri", + "type": "string" + } + }, + "required": [ + "id", + "balance", + "price", + "discount_percent", + "currency", + "purchase_url" + ], + "type": "object" + }, + "type": "array" + }, + "provider_name": { + "type": "string" + }, + "provider_slug": { + "type": "string" + }, + "purchase_url": { + "format": "uri", + "type": "string" + }, + "relationship": { + "enum": [ + "affiliate", + "direct" + ], + "type": "string" + }, + "seller_terms": { + "additionalProperties": false, + "properties": { + "note": { + "type": "string" + }, + "reported_guarantee_days": { + "anyOf": [ + { + "exclusiveMinimum": 0, + "maximum": 9007199254740991, + "type": "integer" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "reported_guarantee_days", + "note" + ], + "type": "object" + }, + "variant": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + }, + "variant_label": { + "anyOf": [ + { + "type": "string" + }, + { + "type": "null" + } + ] + } + }, + "required": [ + "deal_id", + "provider_name", + "provider_slug", + "discount_percent", + "in_stock", + "fetched_at", + "purchase_url", + "variant", + "variant_label", + "coupon", + "conditions", + "seller_terms", + "relationship", + "disclosure", + "id_verification_required" + ], + "type": "object" + }, + "type": "array" + }, + "name": { + "type": "string" + }, + "product_id": { + "type": "string" + }, + "slug": { + "type": "string" + } + }, + "required": [ + "product_id", + "name", + "slug", + "canonical_url", + "base_domain", + "category", + "best_discount_percent", + "carddeals_inventory_status", + "deals" + ], + "type": "object" + }, + { + "type": "null" + } +]
- Changed
lookup_gift_card_deals2 fields changed- added
Output schema / properties / products / items / properties / deals / items / properties / id_verification_requiredAdded value: +{ + "type": "boolean" +} - changed
Output schema / properties / products / items / properties / deals / items / requiredPrevious value: -[ - "deal_id", - "provider_name", - "provider_slug", - "discount_percent", - "in_stock", - "fetched_at", - "purchase_url", - "variant", - "variant_label", - "coupon", - "conditions", - "seller_terms", - "relationship", - "disclosure" -]New value: +[ + "deal_id", + "provider_name", + "provider_slug", + "discount_percent", + "in_stock", + "fetched_at", + "purchase_url", + "variant", + "variant_label", + "coupon", + "conditions", + "seller_terms", + "relationship", + "disclosure", + "id_verification_required" +]
- Changed
search_gift_card_deals2 fields changed- added
Output schema / properties / products / items / properties / deals / items / properties / id_verification_requiredAdded value: +{ + "type": "boolean" +} - changed
Output schema / properties / products / items / properties / deals / items / requiredPrevious value: -[ - "deal_id", - "provider_name", - "provider_slug", - "discount_percent", - "in_stock", - "fetched_at", - "purchase_url", - "variant", - "variant_label", - "coupon", - "conditions", - "seller_terms", - "relationship", - "disclosure" -]New value: +[ + "deal_id", + "provider_name", + "provider_slug", + "discount_percent", + "in_stock", + "fetched_at", + "purchase_url", + "variant", + "variant_label", + "coupon", + "conditions", + "seller_terms", + "relationship", + "disclosure", + "id_verification_required" +]
3 tool updates
- First observed
get_gift_card_deals - First observed
lookup_gift_card_deals - First observed
search_gift_card_deals
Related MCP Connectors
Live search across 250,000+ verified UK and Canada retail deals. Read-only, no auth required.
Search live credit card merchant offers across Amex, Chase, Citi, PayPal, Rakuten, Capital One.
Verified deals, store policies & a trust score for thousands of online retailers. No auth.
Live coupons, promo codes and deals from online shops in the United States. Read-only, no login.
Related MCP Servers
- AlicenseAqualityBmaintenanceFinds coupon codes for any online store, returning likely-to-work codes for a given store domain or URL.125 npmMIT
- FlicenseNot gradedqualityDmaintenanceEnables searching and comparing live credit card merchant offers (cash back, points, statement credits) across Amex, Chase, Citi, PayPal, Rakuten, and Capital One from any AI agent.-
- AlicenseAqualityDmaintenanceEnables AI agents to browse the giftcardshop catalog and purchase gift cards using Lightning payments, with no account or signup required.533 npmMIT

StackTheDeal Dealsofficial
AlicenseNot gradedqualityDmaintenanceLets AI assistants search and browse a continuously verified feed of live retail and travel deals, filtering by category, store, discount, or hot status, and fetch individual deal details with current live/expired state. Results render as interactive cards in MCP Apps clients or structured text elsewhere, always linking to the deal page where the price is re-verified.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.