Servidor MCP
GotCashback
com.gotcashback/gotcashback
Qué hace este MCP
Compares cashback rates, discounted gift cards, portal terms, store offers, favorites, and price alerts across supported countries.
Capacidades
Herramientas
18
herramientas
get_best_deals_by_brand
Best deals for a brand
Finds where to buy a brand's products with the most savings: returns the matching brands and, for each, the stores carrying it ranked by best current cashback rate, then best gift card discount. Use it when the user names a product brand rather than a specific retailer — 'where is the best cashback for Adidas products?', 'cheapest place to buy Apple products with cashback'. When the user names a retailer ('Nike cashback' meaning the Nike store), call get_cashback_rates_by_store_name instead; for a type of product use get_best_deals_by_category. Returns up to 5 matching brands, best match first; empty when nothing matched. Rates reflect GotCashback's current data, refreshed several times a day. Always show each store's links to the user: best_cashback_rate.url (clickable link that activates the cashback) and gift_cards_url (where to buy the discounted gift cards).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['brand_name'], 'properties': {'brand_name': {'type': 'string', 'description': "The product brand name, e.g. 'Adidas', 'Dyson', 'LEGO'. Matched case-insensitively at word boundaries of the brand name and its alternate names, best match first; multi-word names fall back to matching individual words."}, 'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}}}
Esquema de salida
{'type': 'object', 'properties': {'matches': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': "The matched brand or category name as GotCashback knows it. Several partial matches can be returned; pick the one that fits the user's request."}, 'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'GotCashback store page. Show it as a clickable link.'}, 'name': {'type': 'string', 'description': 'Store (retailer) name.'}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier."}, 'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code of the store's country."}, 'gift_cards_url': {'type': ['string', 'null'], 'description': "GotCashback page listing the store's discounted gift cards. Present when best_gift_card_discount_percent is set; show it as a clickable link."}, 'best_cashback_rate': {'type': ['object', 'null'], 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback click-through link that activates this cashback offer at the portal. Always show it to the user as a clickable link; cashback is only credited when they shop through it.'}, 'rate': {'type': 'number', 'description': "The cashback rate value. A percentage when type is 'percent' (5 means 5%), otherwise a fixed amount of cashback per purchase."}, 'type': {'type': 'string', 'description': "How the rate is expressed: 'percent' (rate is a percentage of the purchase amount) or 'fixedamount' (rate is a fixed amount in the store's local currency)."}, 'upto': {'type': 'boolean', 'description': "True when the rate is a maximum ('up to X%') that varies by product category or terms; false when it applies to all qualifying purchases. Rank 'up to' rates below a guaranteed rate of the same value."}, 'portal': {'type': 'string', 'description': "Name of the cashback portal offering this rate, e.g. 'Rakuten', 'TopCashback'."}, 'location': {'type': 'string', 'description': "Where the cashback applies: 'online' (shop on the store's website through the link) or 'in-store' (linked-card cashback at physical locations)."}}, 'description': "The store's best percentage cashback rate across all portals, with the portal name and the tracked 'url' that activates it. Null when the store has no percentage cashback."}, 'best_gift_card_discount_percent': {'type': ['number', 'null'], 'description': "The largest discount off face value (in percent) among the store's discounted gift cards. Null when no discounted gift cards are available."}}, 'description': "A store's current best money-saving options for the matched brand or category."}, 'description': 'Stores carrying the brand / in the category that currently have cashback or discounted gift cards, best cashback rate first. Empty when none qualify.'}, 'country_code': {'type': 'string', 'description': 'Lowercase ISO 3166-1 alpha-2 code of the country this match belongs to.'}}, 'description': 'A matched brand or shopping category and the stores carrying it, ranked by best cashback rate, then best gift card discount.'}, 'description': 'Matched brands / categories (up to 5, best match first). Empty when nothing matched.'}}, 'description': 'Brands or categories matching the query, each with its stores ranked by savings.'}
get_best_deals_by_category
Best deals for a category
Finds where to buy products from a shopping category with the most savings: returns the matching categories and, for each, the stores in it ranked by best current cashback rate, then best gift card discount. Use it when the user names a type of product or a category rather than a store or brand — 'where can I buy dog food with the biggest discount?', 'best cashback for electronics', 'travel booking sites with cashback'. For a specific retailer use get_cashback_rates_by_store_name; for a product brand use get_best_deals_by_brand. Returns up to 5 matching categories, best match first; empty when nothing matched. Rates reflect GotCashback's current data, refreshed several times a day. Always show each store's links to the user: best_cashback_rate.url (clickable link that activates the cashback) and gift_cards_url (where to buy the discounted gift cards).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['category_name'], 'properties': {'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}, 'category_name': {'type': 'string', 'description': "The shopping category or product type, e.g. 'Pet Supplies', 'dog food', 'electronics', 'travel'. Matched case-insensitively at word boundaries of the category name and its alternate names, best match first; multi-word phrases fall back to matching individual words."}}}
Esquema de salida
{'type': 'object', 'properties': {'matches': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': "The matched brand or category name as GotCashback knows it. Several partial matches can be returned; pick the one that fits the user's request."}, 'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'GotCashback store page. Show it as a clickable link.'}, 'name': {'type': 'string', 'description': 'Store (retailer) name.'}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier."}, 'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code of the store's country."}, 'gift_cards_url': {'type': ['string', 'null'], 'description': "GotCashback page listing the store's discounted gift cards. Present when best_gift_card_discount_percent is set; show it as a clickable link."}, 'best_cashback_rate': {'type': ['object', 'null'], 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback click-through link that activates this cashback offer at the portal. Always show it to the user as a clickable link; cashback is only credited when they shop through it.'}, 'rate': {'type': 'number', 'description': "The cashback rate value. A percentage when type is 'percent' (5 means 5%), otherwise a fixed amount of cashback per purchase."}, 'type': {'type': 'string', 'description': "How the rate is expressed: 'percent' (rate is a percentage of the purchase amount) or 'fixedamount' (rate is a fixed amount in the store's local currency)."}, 'upto': {'type': 'boolean', 'description': "True when the rate is a maximum ('up to X%') that varies by product category or terms; false when it applies to all qualifying purchases. Rank 'up to' rates below a guaranteed rate of the same value."}, 'portal': {'type': 'string', 'description': "Name of the cashback portal offering this rate, e.g. 'Rakuten', 'TopCashback'."}, 'location': {'type': 'string', 'description': "Where the cashback applies: 'online' (shop on the store's website through the link) or 'in-store' (linked-card cashback at physical locations)."}}, 'description': "The store's best percentage cashback rate across all portals, with the portal name and the tracked 'url' that activates it. Null when the store has no percentage cashback."}, 'best_gift_card_discount_percent': {'type': ['number', 'null'], 'description': "The largest discount off face value (in percent) among the store's discounted gift cards. Null when no discounted gift cards are available."}}, 'description': "A store's current best money-saving options for the matched brand or category."}, 'description': 'Stores carrying the brand / in the category that currently have cashback or discounted gift cards, best cashback rate first. Empty when none qualify.'}, 'country_code': {'type': 'string', 'description': 'Lowercase ISO 3166-1 alpha-2 code of the country this match belongs to.'}}, 'description': 'A matched brand or shopping category and the stores carrying it, ranked by best cashback rate, then best gift card discount.'}, 'description': 'Matched brands / categories (up to 5, best match first). Empty when nothing matched.'}}, 'description': 'Brands or categories matching the query, each with its stores ranked by savings.'}
get_cashback_rates_by_store_id
Cashback rates by store ID
Returns the current online and in-store cashback rates from every cashback portal for one store identified by its numeric store_id, so the user can compare every portal and see the best. Use it only when a store_id is already known from an earlier result (a store, deals, favorites or alerts response). When the user gives a store name instead, call get_cashback_rates_by_store_name directly — do not look the id up first. Returns an error when the id does not exist. Rates reflect GotCashback's current data, refreshed several times a day. Present every returned portal's rate to the user (a table with a link column, not only the best one) and always show each rate's 'url' as a clickable link — cashback is only credited when the user clicks through it.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_id'], 'properties': {'store_id': {'type': 'integer', 'description': "GotCashback's numeric store_id, taken from an earlier result (a store, cashback rate, gift card, deals, favorites or alerts response). If you only have a store name, use the by-name tool instead."}}}
Esquema de salida
{'type': 'object', 'properties': {'store': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': "GotCashback store page listing all of this store's offers. Show it as a clickable link."}, 'name': {'type': 'string', 'description': 'Store (retailer) name as shown on GotCashback.'}, 'domain': {'type': ['string', 'null'], 'description': "The store's website domain, e.g. 'walmart.com'. Null when unknown."}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier. Pass it as store_id to the *_by_store_id, favorite and alert tools."}, 'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code of the country this store entry belongs to (e.g. 'us', 'ca', 'gb'). The same retailer appears once per country with country-specific rates."}, 'cashback_rates': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback click-through link that activates this cashback offer at the portal. Always show it to the user as a clickable link; cashback is only credited when they shop through it.'}, 'rate': {'type': 'number', 'description': "The cashback rate value. A percentage when type is 'percent' (5 means 5%), otherwise a fixed amount of cashback per purchase."}, 'type': {'type': 'string', 'description': "How the rate is expressed: 'percent' (rate is a percentage of the purchase amount) or 'fixedamount' (rate is a fixed amount in the store's local currency)."}, 'upto': {'type': 'boolean', 'description': "True when the rate is a maximum ('up to X%') that varies by product category or terms; false when it applies to all qualifying purchases. Rank 'up to' rates below a guaranteed rate of the same value."}, 'portal': {'type': 'string', 'description': "Name of the cashback portal offering this rate, e.g. 'Rakuten', 'TopCashback'."}, 'location': {'type': 'string', 'description': "Where the cashback applies: 'online' (shop on the store's website through the link) or 'in-store' (linked-card cashback at physical locations)."}}, 'description': 'One cashback offer for the store from one cashback portal.'}, 'description': 'Current cashback offers for this store, one per portal and location (online / in-store). Empty when no portal currently offers cashback here; null/absent for tools that return store identity only.'}, 'gift_cards_url': {'type': ['string', 'null'], 'description': "GotCashback page listing the store's discounted gift cards. Present when has_gift_cards is true; show it as a clickable link."}, 'has_gift_cards': {'type': ['boolean', 'null'], 'description': 'True when discounted gift cards are currently available for this store (present in get_stores_by_country results only; null/absent otherwise).'}}, 'description': 'A store (retailer) in one country, with its current cashback rates when returned by a cashback tool.'}}, 'description': 'One store with its current cashback rates.'}
get_cashback_rates_by_store_name
Cashback rates by store name
Finds a store by name and returns its current cashback rates from every cashback portal that lists it — online and in-store, percentage or fixed amount, with 'up to' flags — so the user can compare every portal and see the best. This is the preferred first call for any cashback question that names a store: 'best cashback for Walmart', 'highest Nike cashback', 'cashback at Expedia', 'Walmart cashback today', 'compare Walmart cashback portals', 'Best Buy in-store cashback', 'Dell cashback in Germany'. No prior lookup is needed — do not call get_stores_by_name, get_stores_by_country or get_countries first. Returns every matching store (best match first, one entry per country), each with its 'cashback_rates'; an empty list means no match — retry with a shorter name or without country_code. Use get_cashback_rates_by_store_id only when a store_id is already known, get_gift_cards_by_store_name for gift card discounts, and get_best_deals_by_brand when the user asks where to buy a brand's products rather than about a specific store. Rates reflect GotCashback's current data, refreshed several times a day. Present every returned portal's rate to the user (a table with a link column, not only the best one) and always show each rate's 'url' as a clickable link — cashback is only credited when the user clicks through it.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_name'], 'properties': {'store_name': {'type': 'string', 'description': "The retailer or brand name as a shopper would say it, e.g. 'Walmart', 'Nike', 'Best Buy', 'Expedia', 'Home Depot'. Matched case-insensitively at word boundaries of the store name and its known alternate names (exact name, then names starting with it, then names containing it as a word), best match first; a partial-word match (e.g. 'gap' inside 'Singapore') is only returned when nothing better exists. Pass the plain name only — no words like 'cashback', 'gift card' or a country."}, 'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}}}
Esquema de salida
{'type': 'object', 'properties': {'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': "GotCashback store page listing all of this store's offers. Show it as a clickable link."}, 'name': {'type': 'string', 'description': 'Store (retailer) name as shown on GotCashback.'}, 'domain': {'type': ['string', 'null'], 'description': "The store's website domain, e.g. 'walmart.com'. Null when unknown."}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier. Pass it as store_id to the *_by_store_id, favorite and alert tools."}, 'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code of the country this store entry belongs to (e.g. 'us', 'ca', 'gb'). The same retailer appears once per country with country-specific rates."}, 'cashback_rates': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback click-through link that activates this cashback offer at the portal. Always show it to the user as a clickable link; cashback is only credited when they shop through it.'}, 'rate': {'type': 'number', 'description': "The cashback rate value. A percentage when type is 'percent' (5 means 5%), otherwise a fixed amount of cashback per purchase."}, 'type': {'type': 'string', 'description': "How the rate is expressed: 'percent' (rate is a percentage of the purchase amount) or 'fixedamount' (rate is a fixed amount in the store's local currency)."}, 'upto': {'type': 'boolean', 'description': "True when the rate is a maximum ('up to X%') that varies by product category or terms; false when it applies to all qualifying purchases. Rank 'up to' rates below a guaranteed rate of the same value."}, 'portal': {'type': 'string', 'description': "Name of the cashback portal offering this rate, e.g. 'Rakuten', 'TopCashback'."}, 'location': {'type': 'string', 'description': "Where the cashback applies: 'online' (shop on the store's website through the link) or 'in-store' (linked-card cashback at physical locations)."}}, 'description': 'One cashback offer for the store from one cashback portal.'}, 'description': 'Current cashback offers for this store, one per portal and location (online / in-store). Empty when no portal currently offers cashback here; null/absent for tools that return store identity only.'}, 'gift_cards_url': {'type': ['string', 'null'], 'description': "GotCashback page listing the store's discounted gift cards. Present when has_gift_cards is true; show it as a clickable link."}, 'has_gift_cards': {'type': ['boolean', 'null'], 'description': 'True when discounted gift cards are currently available for this store (present in get_stores_by_country results only; null/absent otherwise).'}}, 'description': 'A store (retailer) in one country, with its current cashback rates when returned by a cashback tool.'}, 'description': 'Matching stores (one entry per country). Empty when nothing matched.'}}, 'description': 'Stores matching the query, best match first, each with its current cashback rates.'}
get_countries
Supported countries
Returns the countries GotCashback covers, each with the lowercase ISO 3166-1 alpha-2 'code' to pass as country_code to the other tools (the United Kingdom is 'gb'). Use it only to confirm whether a country is supported or which code to use; it is not needed before store, cashback or gift card lookups — those tools accept country_code directly and search all countries when it is omitted.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'type': 'object', 'properties': {'countries': {'type': 'array', 'items': {'type': 'object', 'properties': {'code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code to pass as country_code to other tools, e.g. 'us', 'ca', 'gb' (United Kingdom), 'de'."}, 'name': {'type': 'string', 'description': "Country name in English, e.g. 'United Kingdom'."}, 'country_id': {'type': 'integer', 'description': "GotCashback's numeric country identifier (informational; tools take country_code, not this id)."}, 'localized_name': {'type': 'string', 'description': "Country name in its own language, e.g. 'Deutschland'."}}, 'description': "A country covered by GotCashback's cashback comparison."}}}, 'description': 'Countries covered by GotCashback.'}
get_gift_cards_by_store_id
Gift card discounts by store ID
Returns the discounted gift cards currently on sale for one store identified by its numeric store_id, from multiple sellers, so the discounts can be compared. Use it only when a store_id is already known from an earlier result. When the user gives a store name instead, call get_gift_cards_by_store_name directly — do not look the id up first. Returns an empty list when no discounted cards are available and an error when the id does not exist. Present every returned seller's listing to the user (a table with a link column, not only the best discount) and always show each gift card's 'url' as a clickable link — that tracked link is where the user buys the card at the discounted price.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_id'], 'properties': {'store_id': {'type': 'integer', 'description': "GotCashback's numeric store_id, taken from an earlier result (a store, cashback rate, gift card, deals, favorites or alerts response). If you only have a store name, use the by-name tool instead."}}}
Esquema de salida
{'type': 'object', 'properties': {'gift_cards': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback purchase link that leads to this card at the seller. Always show it to the user as a clickable link; the discount is only obtained by buying through it.'}, 'type': {'type': 'string', 'description': "Card format, e.g. 'Digital' (e-gift code delivered online) or 'Physical' (plastic card shipped)."}, 'count': {'type': ['integer', 'null'], 'description': 'Number of cards in stock at the seller, when published. Null when unknown.'}, 'price': {'type': ['number', 'null'], 'description': 'What the buyer pays for the card, when value_type is 1. The saving is value minus price.'}, 'value': {'type': ['number', 'null'], 'description': "Face value of the card in the store's currency, when value_type is 1. Null for ranges."}, 'seller': {'type': 'string', 'description': "Name of the gift card seller / marketplace offering the card, e.g. 'CardCash', 'Raise'."}, 'price_to': {'type': ['number', 'null'], 'description': 'Price of the largest face value, when value_type is 2.'}, 'value_to': {'type': ['number', 'null'], 'description': 'Largest face value available, when value_type is 2. Null for fixed-value cards.'}, 'price_from': {'type': ['number', 'null'], 'description': 'Price of the smallest face value, when value_type is 2.'}, 'value_from': {'type': ['number', 'null'], 'description': 'Smallest face value available, when value_type is 2. Null for fixed-value cards.'}, 'value_type': {'type': 'integer', 'description': '1 = a single fixed face value (see value and price); 2 = a range of face values (see value_from/value_to and price_from/price_to).'}, 'gift_card_id': {'type': 'integer', 'description': "GotCashback's numeric identifier of this listing."}, 'seller_icon_url': {'type': ['string', 'null'], 'description': 'Seller logo image URL. Null when none.'}, 'discount_percent': {'type': ['number', 'null'], 'description': 'Discount off face value in percent (e.g. 8.5 means the card costs 8.5% less than it is worth). Null when it cannot be computed. Compare listings by this field to find the best gift card discount.'}}, 'description': 'One discounted gift card listing for the store from one gift card seller.'}, 'description': 'Gift card listings from all sellers. Empty when none are available right now.'}}, 'description': 'Discounted gift cards currently on sale for one store.'}
get_gift_cards_by_store_name
Gift card discounts by store name
Finds a store by name and returns the discounted gift cards currently on sale for it from multiple gift card sellers — face value, price, discount percent, digital or physical — so the user can compare every seller and see the best discount. This is the preferred first call for any gift card question that names a store: 'best gift card discount for Gap', 'where can I buy discounted Instacart gift cards', 'compare Home Depot gift card discounts', 'current Target gift card deals'. No prior lookup is needed. Returns every matching store (best match first, one entry per country), each with its 'gift_cards' list and a 'gift_cards_url' page; an empty 'gift_cards' list means no discounted cards right now. Use get_gift_cards_by_store_id only when a store_id is already known, and get_cashback_rates_by_store_name when the user asks about cashback rates instead. Present every returned seller's listing to the user (a table with a link column, not only the best discount) and always show each gift card's 'url' as a clickable link — that tracked link is where the user buys the card at the discounted price. Also mention the store's 'gift_cards_url' page.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_name'], 'properties': {'store_name': {'type': 'string', 'description': "The retailer or brand name as a shopper would say it, e.g. 'Walmart', 'Nike', 'Best Buy', 'Expedia', 'Home Depot'. Matched case-insensitively at word boundaries of the store name and its known alternate names (exact name, then names starting with it, then names containing it as a word), best match first; a partial-word match (e.g. 'gap' inside 'Singapore') is only returned when nothing better exists. Pass the plain name only — no words like 'cashback', 'gift card' or a country."}, 'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}}}
Esquema de salida
{'type': 'object', 'properties': {'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': ['string', 'null'], 'description': 'GotCashback store page. Show it as a clickable link.'}, 'name': {'type': 'string', 'description': 'Store (retailer) name.'}, 'domain': {'type': ['string', 'null'], 'description': "The store's website domain. Null when unknown."}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier."}, 'gift_cards': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback purchase link that leads to this card at the seller. Always show it to the user as a clickable link; the discount is only obtained by buying through it.'}, 'type': {'type': 'string', 'description': "Card format, e.g. 'Digital' (e-gift code delivered online) or 'Physical' (plastic card shipped)."}, 'count': {'type': ['integer', 'null'], 'description': 'Number of cards in stock at the seller, when published. Null when unknown.'}, 'price': {'type': ['number', 'null'], 'description': 'What the buyer pays for the card, when value_type is 1. The saving is value minus price.'}, 'value': {'type': ['number', 'null'], 'description': "Face value of the card in the store's currency, when value_type is 1. Null for ranges."}, 'seller': {'type': 'string', 'description': "Name of the gift card seller / marketplace offering the card, e.g. 'CardCash', 'Raise'."}, 'price_to': {'type': ['number', 'null'], 'description': 'Price of the largest face value, when value_type is 2.'}, 'value_to': {'type': ['number', 'null'], 'description': 'Largest face value available, when value_type is 2. Null for fixed-value cards.'}, 'price_from': {'type': ['number', 'null'], 'description': 'Price of the smallest face value, when value_type is 2.'}, 'value_from': {'type': ['number', 'null'], 'description': 'Smallest face value available, when value_type is 2. Null for fixed-value cards.'}, 'value_type': {'type': 'integer', 'description': '1 = a single fixed face value (see value and price); 2 = a range of face values (see value_from/value_to and price_from/price_to).'}, 'gift_card_id': {'type': 'integer', 'description': "GotCashback's numeric identifier of this listing."}, 'seller_icon_url': {'type': ['string', 'null'], 'description': 'Seller logo image URL. Null when none.'}, 'discount_percent': {'type': ['number', 'null'], 'description': 'Discount off face value in percent (e.g. 8.5 means the card costs 8.5% less than it is worth). Null when it cannot be computed. Compare listings by this field to find the best gift card discount.'}}, 'description': 'One discounted gift card listing for the store from one gift card seller.'}, 'description': 'Discounted gift card listings from all sellers. Empty when no discounted cards are available right now.'}, 'country_code': {'type': 'string', 'description': 'Lowercase ISO 3166-1 alpha-2 code of the country this store entry belongs to.'}, 'gift_cards_url': {'type': ['string', 'null'], 'description': 'GotCashback page listing all discounted gift cards for this store. Mention it as a clickable link.'}}, 'description': 'A store in one country with the discounted gift cards currently on sale for it.'}, 'description': 'Matching stores (one entry per country). Empty when nothing matched.'}}, 'description': 'Stores matching the query, best match first, each with its discounted gift cards.'}
get_my_alerts
My alerts
Returns the signed-in user's cashback and gift card alerts. Use it for 'what alerts do I have?' or before changing an alert. Each alert carries store_id, alert_type ('cashback' or 'gift_card'), threshold_percent and the last notification; pass store_id and alert_type straight to set_store_alert or remove_store_alert — the values are identical. Requires OAuth sign-in with a GotCashback account and the 'alerts' scope; anonymous callers are prompted to authorize.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'type': 'object', 'properties': {'alerts': {'type': 'array', 'items': {'type': 'object', 'properties': {'active': {'type': 'boolean', 'description': 'True while the alert is armed. Inactive alerts no longer notify and do not count against the 10-alert limit.'}, 'alert_id': {'type': 'integer', 'description': "GotCashback's numeric identifier for this alert subscription. Informational — remove_store_alert takes store_id and alert_type, not this id."}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier. Pass it as store_id to set_store_alert, remove_store_alert and the *_by_store_id tools."}, 'alert_type': {'enum': ['gift_card', 'cashback'], 'type': 'string', 'description': "What the alert watches: 'cashback' (the store's best cashback rate) or 'gift_card' (the store's best gift card discount). Pass this value unchanged to set_store_alert or remove_store_alert."}, 'created_on': {'type': 'string', 'format': 'date-time', 'description': 'UTC timestamp when the user created the alert.'}, 'store_name': {'type': 'string', 'description': 'Store (retailer) name as shown on GotCashback.'}, 'country_code': {'type': ['string', 'null'], 'description': "Lowercase ISO 3166-1 alpha-2 code of the country this alert's store entry belongs to (e.g. 'us', 'ca', 'gb')."}, 'country_name': {'type': ['string', 'null'], 'description': "Country name in English, e.g. 'United States'."}, 'last_notified_on': {'type': ['string', 'null'], 'format': 'date-time', 'description': 'UTC timestamp of the last notification sent for this alert. Null/absent when it has never fired.'}, 'threshold_percent': {'type': 'number', 'description': 'The alert fires when the rate or discount reaches this percent or higher (10 means 10%).'}, 'last_notified_value': {'type': ['number', 'null'], 'description': 'The rate or discount percent that triggered the last notification. Null/absent when the alert has never fired.'}}, 'description': "An alert the user has set on a store: it notifies them by email when the store's cashback rate or gift card discount reaches the threshold."}, 'description': "The user's alerts, newest first. Empty when they have none."}}, 'description': "The signed-in user's store alerts."}
get_my_favorite_stores
My favorite stores
Returns the signed-in user's favorite stores (with their store_id). Use it when the user asks about 'my favorites' or 'my saved stores'; pair the store_ids with get_cashback_rates_by_store_id to report current rates for them. Requires OAuth sign-in with a GotCashback account; anonymous callers are prompted to authorize. All comparison tools work without signing in. Scope: 'favorites'.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'type': 'object', 'properties': {'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Store (retailer) name as shown on GotCashback.'}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier. Pass it as store_id to get_cashback_rates_by_store_id, get_gift_cards_by_store_id, set_store_alert or toggle_favorite_store."}, 'country_code': {'type': ['string', 'null'], 'description': "Lowercase ISO 3166-1 alpha-2 code of the country this store entry belongs to (e.g. 'us', 'ca', 'gb')."}, 'country_name': {'type': ['string', 'null'], 'description': "Country name in English, e.g. 'United States'."}}, 'description': 'A store the user has saved to their GotCashback favorites.'}, 'description': "The user's favorite stores. Empty when they have none."}}, 'description': "The signed-in user's favorite stores."}
get_my_profile
My profile
Returns the signed-in user's GotCashback profile (name, email, avatar). Use it when the user asks who they are signed in as or wants their account details. Requires OAuth sign-in with a GotCashback account; anonymous callers are prompted to authorize. All comparison tools work without signing in. Scope: 'profile'.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {}}
Esquema de salida
{'type': 'object', 'properties': {'profile': {'type': 'object', 'properties': {'email': {'type': ['string', 'null'], 'description': "The account's email address — where alert notifications are sent."}, 'avatar': {'type': ['string', 'null'], 'description': "URL of the user's profile picture. Null/absent when they have none."}, 'user_id': {'type': 'integer', 'description': "GotCashback's numeric identifier for the account. Informational — no tool takes it as a parameter."}, 'first_name': {'type': ['string', 'null'], 'description': 'The name the user registered with. Null/absent when they never set one.'}}, 'description': "The signed-in user's GotCashback account profile."}}, 'description': "The signed-in user's GotCashback profile."}
get_portal_by_id
Portal by ID
Returns one cashback portal by its numeric id (the 'id' from a get_portals or get_portals_by_name result) with its payout terms for that country. Use it only when the id is already known; when the user names a portal, call get_portals_by_name instead. Returns an error when the id does not exist. Each portal includes its payout terms for that country: 'sign_up_bonus' (amount and the url that grants it, null when none), 'minimum_payout' with 'minimum_payout_currency' (smallest balance paid out, null when not published, 0 means no minimum), 'payment_frequency' (how often it pays, e.g. 'On demand', 'Weekly', 'Monthly'), and 'payment_methods' (payout options, e.g. 'PayPal', 'Direct deposit', 'Check', 'Gift card'). Use these to answer questions about a portal's sign-up bonus, payout threshold, payment schedule and payment options. When mentioning a sign-up bonus, show its 'url' as a clickable link — the bonus is only credited when the user signs up through it.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['portal_id'], 'properties': {'portal_id': {'type': 'integer', 'description': "GotCashback's numeric portal id, taken from the 'id' field of an earlier get_portals or get_portals_by_name result."}}}
Esquema de salida
{'type': 'object', 'properties': {'portal': {'type': 'object', 'properties': {'id': {'type': 'integer', 'description': "GotCashback's numeric identifier of this portal-in-country entry. Pass it as portal_id to get_portal_by_id."}, 'url': {'type': 'string', 'description': "Link to join or open the portal (GotCashback's referral link when the portal has one). Show it as a clickable link."}, 'name': {'type': 'string', 'description': "Portal name, e.g. 'Rakuten', 'TopCashback'."}, 'icon_url': {'type': 'string', 'description': 'Portal logo image URL.'}, 'country_code': {'type': 'string', 'description': 'Lowercase ISO 3166-1 alpha-2 code of the country these terms apply to. The same portal appears once per country.'}, 'sign_up_bonus': {'type': ['object', 'null'], 'properties': {'url': {'type': 'string', 'description': 'Link that grants the bonus. Always show it as a clickable link; the bonus is only credited when the user signs up through it.'}, 'amount': {'type': 'string', 'description': "Bonus as the portal advertises it, e.g. '$10' or '£5 after your first purchase'."}}, 'description': 'Sign-up bonus the portal currently offers new members in this country. Null when no active bonus is published.'}, 'minimum_payout': {'type': ['number', 'null'], 'description': 'Smallest balance the portal pays out in this country, in minimum_payout_currency. Null when not published; 0 means there is no minimum.'}, 'payment_methods': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': "Payout methods offered in this country, e.g. 'PayPal', 'Direct deposit', 'Check', 'Gift card'. Null when none are published."}, 'payment_frequency': {'type': ['string', 'null'], 'description': "How often the portal pays out in this country, e.g. 'On demand', 'Weekly', 'Monthly', 'Quarterly'. Null when not published."}, 'minimum_payout_currency': {'type': ['string', 'null'], 'description': "ISO 4217 currency code of minimum_payout, e.g. 'USD', 'GBP'. Null when minimum_payout is null."}}, 'description': 'A cashback portal in one country, with the payout terms it offers there.'}}, 'description': 'One cashback portal with its payout terms.'}
get_portals
List cashback portals
Returns the cashback portals GotCashback compares, optionally for one country, each with its payout terms. Use it to list the portals available in a country ('which cashback portals are there in Canada?') or to compare portals side by side — which pays fastest, has the lowest minimum payout, offers PayPal, or gives the biggest sign-up bonus. It does not return store rates: for 'which portal has the best cashback for [store]' call get_cashback_rates_by_store_name instead; for one named portal use get_portals_by_name. Each portal includes its payout terms for that country: 'sign_up_bonus' (amount and the url that grants it, null when none), 'minimum_payout' with 'minimum_payout_currency' (smallest balance paid out, null when not published, 0 means no minimum), 'payment_frequency' (how often it pays, e.g. 'On demand', 'Weekly', 'Monthly'), and 'payment_methods' (payout options, e.g. 'PayPal', 'Direct deposit', 'Check', 'Gift card'). Use these to answer questions about a portal's sign-up bonus, payout threshold, payment schedule and payment options. When mentioning a sign-up bonus, show its 'url' as a clickable link — the bonus is only credited when the user signs up through it.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'properties': {'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}}}
Esquema de salida
{'type': 'object', 'properties': {'portals': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'integer', 'description': "GotCashback's numeric identifier of this portal-in-country entry. Pass it as portal_id to get_portal_by_id."}, 'url': {'type': 'string', 'description': "Link to join or open the portal (GotCashback's referral link when the portal has one). Show it as a clickable link."}, 'name': {'type': 'string', 'description': "Portal name, e.g. 'Rakuten', 'TopCashback'."}, 'icon_url': {'type': 'string', 'description': 'Portal logo image URL.'}, 'country_code': {'type': 'string', 'description': 'Lowercase ISO 3166-1 alpha-2 code of the country these terms apply to. The same portal appears once per country.'}, 'sign_up_bonus': {'type': ['object', 'null'], 'properties': {'url': {'type': 'string', 'description': 'Link that grants the bonus. Always show it as a clickable link; the bonus is only credited when the user signs up through it.'}, 'amount': {'type': 'string', 'description': "Bonus as the portal advertises it, e.g. '$10' or '£5 after your first purchase'."}}, 'description': 'Sign-up bonus the portal currently offers new members in this country. Null when no active bonus is published.'}, 'minimum_payout': {'type': ['number', 'null'], 'description': 'Smallest balance the portal pays out in this country, in minimum_payout_currency. Null when not published; 0 means there is no minimum.'}, 'payment_methods': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': "Payout methods offered in this country, e.g. 'PayPal', 'Direct deposit', 'Check', 'Gift card'. Null when none are published."}, 'payment_frequency': {'type': ['string', 'null'], 'description': "How often the portal pays out in this country, e.g. 'On demand', 'Weekly', 'Monthly', 'Quarterly'. Null when not published."}, 'minimum_payout_currency': {'type': ['string', 'null'], 'description': "ISO 4217 currency code of minimum_payout, e.g. 'USD', 'GBP'. Null when minimum_payout is null."}}, 'description': 'A cashback portal in one country, with the payout terms it offers there.'}}}, 'description': 'Cashback portals with their payout terms, one entry per portal and country.'}
get_portals_by_name
Search portals by name
Searches cashback portals by name (e.g. 'Rakuten', 'TopCashback', 'Honey') and returns each match with its payout terms, one entry per country the portal operates in. Use it when the user asks about a named portal: its sign-up bonus, minimum payout, how often it pays, or which payout methods it offers. For a store's cashback rate at that portal, call get_cashback_rates_by_store_name and read the 'portal' field of each rate instead. Each portal includes its payout terms for that country: 'sign_up_bonus' (amount and the url that grants it, null when none), 'minimum_payout' with 'minimum_payout_currency' (smallest balance paid out, null when not published, 0 means no minimum), 'payment_frequency' (how often it pays, e.g. 'On demand', 'Weekly', 'Monthly'), and 'payment_methods' (payout options, e.g. 'PayPal', 'Direct deposit', 'Check', 'Gift card'). Use these to answer questions about a portal's sign-up bonus, payout threshold, payment schedule and payment options. When mentioning a sign-up bonus, show its 'url' as a clickable link — the bonus is only credited when the user signs up through it.
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['portal_name'], 'properties': {'portal_name': {'type': 'string', 'description': "The cashback portal name as users say it, e.g. 'Rakuten', 'TopCashback', 'Honey', 'Quidco'. Matched case-insensitively at word boundaries (exact, prefix, then word), best match first; a partial-word match is only returned when nothing better exists."}, 'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}}}
Esquema de salida
{'type': 'object', 'properties': {'portals': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'integer', 'description': "GotCashback's numeric identifier of this portal-in-country entry. Pass it as portal_id to get_portal_by_id."}, 'url': {'type': 'string', 'description': "Link to join or open the portal (GotCashback's referral link when the portal has one). Show it as a clickable link."}, 'name': {'type': 'string', 'description': "Portal name, e.g. 'Rakuten', 'TopCashback'."}, 'icon_url': {'type': 'string', 'description': 'Portal logo image URL.'}, 'country_code': {'type': 'string', 'description': 'Lowercase ISO 3166-1 alpha-2 code of the country these terms apply to. The same portal appears once per country.'}, 'sign_up_bonus': {'type': ['object', 'null'], 'properties': {'url': {'type': 'string', 'description': 'Link that grants the bonus. Always show it as a clickable link; the bonus is only credited when the user signs up through it.'}, 'amount': {'type': 'string', 'description': "Bonus as the portal advertises it, e.g. '$10' or '£5 after your first purchase'."}}, 'description': 'Sign-up bonus the portal currently offers new members in this country. Null when no active bonus is published.'}, 'minimum_payout': {'type': ['number', 'null'], 'description': 'Smallest balance the portal pays out in this country, in minimum_payout_currency. Null when not published; 0 means there is no minimum.'}, 'payment_methods': {'type': ['array', 'null'], 'items': {'type': 'string'}, 'description': "Payout methods offered in this country, e.g. 'PayPal', 'Direct deposit', 'Check', 'Gift card'. Null when none are published."}, 'payment_frequency': {'type': ['string', 'null'], 'description': "How often the portal pays out in this country, e.g. 'On demand', 'Weekly', 'Monthly', 'Quarterly'. Null when not published."}, 'minimum_payout_currency': {'type': ['string', 'null'], 'description': "ISO 4217 currency code of minimum_payout, e.g. 'USD', 'GBP'. Null when minimum_payout is null."}}, 'description': 'A cashback portal in one country, with the payout terms it offers there.'}}}, 'description': 'Cashback portals with their payout terms, one entry per portal and country.'}
get_stores_by_country
List stores in a country
Lists every store that currently has cashback offers in one country — identity, store page url and whether discounted gift cards exist ('has_gift_cards', 'gift_cards_url'), but no rates. The list can run to hundreds of stores. Use it when the user wants to browse or count what is available in a country ('which stores offer cashback in Canada?', 'what stores have gift card deals in the UK?'). Do not use it to find a particular store or its rates: get_cashback_rates_by_store_name and get_gift_cards_by_store_name accept a store name plus an optional country_code directly. Use get_countries to see the supported country codes. When presenting stores, include each store's 'url' as a clickable link (and 'gift_cards_url' when present).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['country_code'], 'properties': {'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 country code, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia). Call get_countries to list every supported code."}}}
Esquema de salida
{'type': 'object', 'properties': {'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': "GotCashback store page listing all of this store's offers. Show it as a clickable link."}, 'name': {'type': 'string', 'description': 'Store (retailer) name as shown on GotCashback.'}, 'domain': {'type': ['string', 'null'], 'description': "The store's website domain, e.g. 'walmart.com'. Null when unknown."}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier. Pass it as store_id to the *_by_store_id, favorite and alert tools."}, 'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code of the country this store entry belongs to (e.g. 'us', 'ca', 'gb'). The same retailer appears once per country with country-specific rates."}, 'cashback_rates': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback click-through link that activates this cashback offer at the portal. Always show it to the user as a clickable link; cashback is only credited when they shop through it.'}, 'rate': {'type': 'number', 'description': "The cashback rate value. A percentage when type is 'percent' (5 means 5%), otherwise a fixed amount of cashback per purchase."}, 'type': {'type': 'string', 'description': "How the rate is expressed: 'percent' (rate is a percentage of the purchase amount) or 'fixedamount' (rate is a fixed amount in the store's local currency)."}, 'upto': {'type': 'boolean', 'description': "True when the rate is a maximum ('up to X%') that varies by product category or terms; false when it applies to all qualifying purchases. Rank 'up to' rates below a guaranteed rate of the same value."}, 'portal': {'type': 'string', 'description': "Name of the cashback portal offering this rate, e.g. 'Rakuten', 'TopCashback'."}, 'location': {'type': 'string', 'description': "Where the cashback applies: 'online' (shop on the store's website through the link) or 'in-store' (linked-card cashback at physical locations)."}}, 'description': 'One cashback offer for the store from one cashback portal.'}, 'description': 'Current cashback offers for this store, one per portal and location (online / in-store). Empty when no portal currently offers cashback here; null/absent for tools that return store identity only.'}, 'gift_cards_url': {'type': ['string', 'null'], 'description': "GotCashback page listing the store's discounted gift cards. Present when has_gift_cards is true; show it as a clickable link."}, 'has_gift_cards': {'type': ['boolean', 'null'], 'description': 'True when discounted gift cards are currently available for this store (present in get_stores_by_country results only; null/absent otherwise).'}}, 'description': 'A store (retailer) in one country, with its current cashback rates when returned by a cashback tool.'}, 'description': 'Matching stores (one entry per country). Empty when nothing matched.'}}, 'description': 'Stores matching the query, best match first, each with its current cashback rates.'}
get_stores_by_name
Search stores by name
Searches stores by name and returns the matching stores' identity only — store_id, name, country_code, website domain and GotCashback store page url — without cashback rates or gift cards. Use it when the user wants to know whether GotCashback covers a store, in which countries a store is listed, or when you need a store_id for the account tools (toggle_favorite_store, set_store_alert). For any question about cashback rates or gift card discounts call get_cashback_rates_by_store_name or get_gift_cards_by_store_name directly instead — they search by name themselves, so this tool is not a required first step. Returns matches best first; empty when nothing matched. When presenting stores, include each store's 'url' as a clickable link (and 'gift_cards_url' when present).
Solo lectura
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_name'], 'properties': {'store_name': {'type': 'string', 'description': "The retailer or brand name as a shopper would say it, e.g. 'Walmart', 'Nike', 'Best Buy', 'Expedia', 'Home Depot'. Matched case-insensitively at word boundaries of the store name and its known alternate names (exact name, then names starting with it, then names containing it as a word), best match first; a partial-word match (e.g. 'gap' inside 'Singapore') is only returned when nothing better exists. Pass the plain name only — no words like 'cashback', 'gift card' or a country."}, 'country_code': {'type': ['string', 'null'], 'default': None, 'description': "Optional. Lowercase ISO 3166-1 alpha-2 country code that limits results to one country, e.g. 'us' (United States), 'ca' (Canada), 'gb' (United Kingdom — use 'gb', not 'uk'), 'de' (Germany), 'au' (Australia), 'fr' (France). Pass it when the user names a country ('in Canada', 'UK cashback'); omit it to search all supported countries."}}}
Esquema de salida
{'type': 'object', 'properties': {'stores': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': "GotCashback store page listing all of this store's offers. Show it as a clickable link."}, 'name': {'type': 'string', 'description': 'Store (retailer) name as shown on GotCashback.'}, 'domain': {'type': ['string', 'null'], 'description': "The store's website domain, e.g. 'walmart.com'. Null when unknown."}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store identifier. Pass it as store_id to the *_by_store_id, favorite and alert tools."}, 'country_code': {'type': 'string', 'description': "Lowercase ISO 3166-1 alpha-2 code of the country this store entry belongs to (e.g. 'us', 'ca', 'gb'). The same retailer appears once per country with country-specific rates."}, 'cashback_rates': {'type': ['array', 'null'], 'items': {'type': 'object', 'properties': {'url': {'type': 'string', 'description': 'Tracked GotCashback click-through link that activates this cashback offer at the portal. Always show it to the user as a clickable link; cashback is only credited when they shop through it.'}, 'rate': {'type': 'number', 'description': "The cashback rate value. A percentage when type is 'percent' (5 means 5%), otherwise a fixed amount of cashback per purchase."}, 'type': {'type': 'string', 'description': "How the rate is expressed: 'percent' (rate is a percentage of the purchase amount) or 'fixedamount' (rate is a fixed amount in the store's local currency)."}, 'upto': {'type': 'boolean', 'description': "True when the rate is a maximum ('up to X%') that varies by product category or terms; false when it applies to all qualifying purchases. Rank 'up to' rates below a guaranteed rate of the same value."}, 'portal': {'type': 'string', 'description': "Name of the cashback portal offering this rate, e.g. 'Rakuten', 'TopCashback'."}, 'location': {'type': 'string', 'description': "Where the cashback applies: 'online' (shop on the store's website through the link) or 'in-store' (linked-card cashback at physical locations)."}}, 'description': 'One cashback offer for the store from one cashback portal.'}, 'description': 'Current cashback offers for this store, one per portal and location (online / in-store). Empty when no portal currently offers cashback here; null/absent for tools that return store identity only.'}, 'gift_cards_url': {'type': ['string', 'null'], 'description': "GotCashback page listing the store's discounted gift cards. Present when has_gift_cards is true; show it as a clickable link."}, 'has_gift_cards': {'type': ['boolean', 'null'], 'description': 'True when discounted gift cards are currently available for this store (present in get_stores_by_country results only; null/absent otherwise).'}}, 'description': 'A store (retailer) in one country, with its current cashback rates when returned by a cashback tool.'}, 'description': 'Matching stores (one entry per country). Empty when nothing matched.'}}, 'description': 'Stores matching the query, best match first, each with its current cashback rates.'}
remove_store_alert
Remove a store alert
Removes the signed-in user's alert for a store and alert type ('cashback' or 'gift_card'). Use it for 'stop alerting me about Nike cashback'. Use get_my_alerts to find the store_id and alert_type of an existing alert and pass both through unchanged. Requires OAuth sign-in with a GotCashback account and the 'alerts' scope; anonymous callers are prompted to authorize.
Destructivo
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_id', 'alert_type'], 'properties': {'store_id': {'type': 'integer', 'description': "GotCashback's numeric store_id, taken from an earlier result (a store, cashback rate, gift card, deals, favorites or alerts response). If you only have a store name, use the by-name tool instead."}, 'alert_type': {'enum': ['gift_card', 'cashback'], 'type': 'string', 'description': "Alert type: 'cashback' (fires on the store's best flat cash rate: 'up to' rates and airline miles, credit card and points portals are ignored) or 'gift_card' (fires on the store's best gift card discount). Use the alert_type value from get_my_alerts as-is."}}}
set_store_alert
Set a store alert
Creates or updates an alert that emails the signed-in user when a store's cashback rate or gift card discount reaches the threshold percent or higher. Use it for 'alert me when Nike cashback hits 10%' or 'tell me when Target gift cards are 15% off'. Re-saving an existing alert updates its threshold and re-arms it. At most 10 active alerts per user. Needs the store_id: take it from an earlier result, or find it with get_stores_by_name (optionally with country_code). Requires OAuth sign-in with a GotCashback account and the 'alerts' scope; anonymous callers are prompted to authorize.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_id', 'alert_type', 'threshold_percent'], 'properties': {'store_id': {'type': 'integer', 'description': "GotCashback's numeric store_id, taken from an earlier result (a store, cashback rate, gift card, deals, favorites or alerts response). If you only have a store name, use the by-name tool instead."}, 'alert_type': {'enum': ['gift_card', 'cashback'], 'type': 'string', 'description': "Alert type: 'cashback' (fires on the store's best flat cash rate: 'up to' rates and airline miles, credit card and points portals are ignored) or 'gift_card' (fires on the store's best gift card discount). Use the alert_type value from get_my_alerts as-is."}, 'threshold_percent': {'type': 'number', 'description': 'Fire when the rate/discount reaches this percent or higher (greater than 0, at most 100), e.g. 10 for 10%'}}}
toggle_favorite_store
Add or remove a favorite store
Adds a store to, or removes it from, the signed-in user's favorite stores. Use it for 'add Best Buy to my favorites' or 'remove Nike from my favorites'. Needs the store_id: take it from an earlier result, or find it with get_stores_by_name (optionally with country_code). Requires OAuth sign-in with a GotCashback account; anonymous callers are prompted to authorize. All comparison tools work without signing in. Scope: 'favorites'.
Idempotente
Esquema de entrada
{'type': 'object', 'required': ['store_id', 'favorite'], 'properties': {'favorite': {'type': 'boolean', 'description': 'true to add the store to favorites, false to remove it'}, 'store_id': {'type': 'integer', 'description': "GotCashback's numeric store_id, taken from an earlier result (a store, cashback rate, gift card, deals, favorites or alerts response). If you only have a store name, use the by-name tool instead."}}}
Historial
Cambios recientes en herramientas
Añadido
get_best_deals_by_category
17 de September de 2026 a las 12:35
Añadido
get_best_deals_by_brand
17 de September de 2026 a las 12:35
Añadido
remove_store_alert
17 de September de 2026 a las 12:35
Añadido
get_my_favorite_stores
17 de September de 2026 a las 12:35
Añadido
toggle_favorite_store
17 de September de 2026 a las 12:35
Añadido
set_store_alert
17 de September de 2026 a las 12:35
Añadido
get_cashback_rates_by_store_name
17 de September de 2026 a las 12:35
Añadido
get_portal_by_id
17 de September de 2026 a las 12:35
Añadido
get_stores_by_name
17 de September de 2026 a las 12:35
Añadido
get_my_profile
17 de September de 2026 a las 12:35
Añadido
get_gift_cards_by_store_name
17 de September de 2026 a las 12:35
Añadido
get_my_alerts
17 de September de 2026 a las 12:35
Añadido
get_stores_by_country
17 de September de 2026 a las 12:35
Añadido
get_portals_by_name
17 de September de 2026 a las 12:35
Añadido
get_gift_cards_by_store_id
17 de September de 2026 a las 12:35
Añadido
get_countries
17 de September de 2026 a las 12:35
Añadido
get_cashback_rates_by_store_id
17 de September de 2026 a las 12:35
Añadido
get_portals
17 de September de 2026 a las 12:35
Descubrir
Servidores MCP similares
Ask AI
com.ask-ai-data-connector/ask-ai
Answers questions about connected e-commerce data from Shopify, Klaviyo, GA4, Triple Whale, and other sources, covering sales, ma…
Neonjelly
io.neonjelly/mcp
Analyzes Shopify stores, products, apps, traffic, competitors, catalog changes, market cohorts and outreach contacts across a lar…
Resonance Reward Agent
network.rsnc/reward-agent
Finds cashback deals and rewards, compares brands and offers, and provides analytics and management tools for reward programs.
Real Real Genuine
io.github.richardjhobbs/rrg-marketplace
Enables browsing fashion brands and listings, submitting designs, purchasing digital or physical products, referrals, vouchers, l…
Postscript
io.github.pipeworx-io/postscript
Retrieves Shopify Postscript SMS marketing subscribers, opt-in keywords, and subscriber or keyword details.
AgentIQ
io.github.chrisgu/agentiq-mcp
Operates an agent-oriented advertising network for campaigns, placements, creative and coupon delivery, attribution, affiliate li…
Jungle Scout
io.github.pipeworx-io/jungle-scout
Provides Amazon product searches, sales estimates, keyword metrics, pricing, rankings, and marketplace research.
Finewisdom 社媒与电商数据接口
io.github.yy05idiot/finewisdom
Retrieves social media content and engagement data and searches products, shops, reviews, and sellers across Chinese and internat…