GotCashback MCP Server

Підключіть Claude, ChatGPT та інших MCP-сумісних ШІ-асистентів безпосередньо до актуальних ставок кешбеку GotCashback (онлайн і в магазинах, за всіма кешбек-порталами), порівняння порталів та умов виплат, даних магазинів і пропозицій подарункових карток — дані оновлюються кілька разів на день.

GotCashback.com.ua порівнює ставки кешбеку 113 кешбек-сервісів у 42 країнах світу (сервісів в Україні: 6, магазинів: 543). Заснований у 2020 році; оператор — MNP Enterprises, LLC.

Що таке MCP?

Model Context Protocol (MCP) — відкритий стандарт, який дає змогу ШІ-асистентам викликати зовнішні інструменти та отримувати актуальні дані просто під час розмови. Замість того щоб вгадувати ставки кешбеку за застарілими навчальними даними, ШІ може напряму звернутися до сервера GotCashback і отримати сьогоднішні цифри.

Інструкції зі встановлення

Claude (claude.ai / Claude Desktop)

  1. Відкрийте «Налаштування → Конектори» (у Claude Desktop: «Налаштування → Конектори»; на claude.ai: значок конекторів у чаті).
  2. Натисніть «Додати власний конектор».
  3. Введіть URL: https://mcp.gotcashback.com
  4. Дайте йому назву (наприклад, «GotCashback») і збережіть.
  5. Увімкніть конектор у будь-якій розмові, де потрібні запити кешбеку — Claude викликатиме інструменти автоматично, коли це доречно.

Claude Code (термінал)

Додайте сервер однією командою:

claude mcp add --transport http gotcashback https://mcp.gotcashback.com

Виконайте /mcp у Claude Code, щоб перевірити підключення та увійти, коли знадобляться інструменти акаунта.

ChatGPT

  1. Відкрийте «Налаштування → Конектори» (доступно на тарифах з підтримкою власних конекторів / конекторів для розробників).
  2. Виберіть додавання власного конектора та введіть URL сервера: https://mcp.gotcashback.com
  3. Дотримуйтеся підказок, щоб авторизувати його та ввімкнути для використання в чаті або в конфігурації власного GPT.

VS Code (режим агента GitHub Copilot)

Виконайте «MCP: Add Server» з палітри команд або додайте це до .vscode/mcp.json:

{
  "servers": {
    "gotcashback": {
      "type": "http",
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Інші MCP-сумісні клієнти (Cursor, Windsurf тощо)

Більшість MCP-клієнтів приймають JSON-конфігурацію з адресою віддаленого сервера. Типовий запис виглядає так:

{
  "mcpServers": {
    "gotcashback": {
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Де розташований цей конфігураційний файл, дивіться в документації вашого клієнта (наприклад, ~/.cursor/mcp.json для Cursor) — URL і структура вище однакові для більшості клієнтів, оскільки всі вони дотримуються тієї самої специфікації MCP.

Приклади запитів після підключення

  • "Яка зараз найкраща ставка кешбеку для Best Buy?"
  • "Чи є подарункові картки Target зі знижкою?"
  • "What's the best cashback rate for Walmart in Canada?"
  • "Compare gift card discounts for Home Depot."
  • "Які кешбек-портали доступні у Великій Британії?"
  • "Де купити товари Adidas з найкращим кешбеком?"
  • "Де купити корм для собак із найбільшою знижкою?"
  • "Які кешбек-портали Великої Британії виплачують через PayPal, і в якого з них найнижча мінімальна сума виплати?"
  • "Чи дає TopCashback бонус за реєстрацію і як часто він виплачує гроші?"
  • "Повідом мене, коли ставка кешбеку Nike досягне 10%."
  • "Додай Best Buy до моїх улюблених магазинів."

Останні два приклади використовують необов'язкові інструменти акаунта та попросять вас увійти з акаунтом GotCashback.

Зручніше спілкуватися в Telegram? Спробуйте Telegram-бота GotCashback

Що робить MCP-сервер GotCashback

Після підключення ШІ-асистент може порівняти актуальні ставки кешбеку магазину онлайн і в магазині за всіма порталами, знайти подарункові картки зі знижкою, упорядкувати магазини, що продають бренд або категорію товарів, за найкращою пропозицією, переглянути магазини за країнами та дізнатися умови виплат кожного порталу (бонус за реєстрацію, мінімальна виплата, періодичність виплат, способи оплати). Сервер повідомляє асистентові, який інструмент відповідає на який тип запитання, тож просте запитання на кшталт "best cashback for Walmart" одразу потрапляє в потрібний запит. Ставки оновлюються кілька разів на день.

Як асистент обирає інструмент

Сервер повідомляє підключеним асистентам, який інструмент відповідає на яке запитання, тож запитувати можна звичайною мовою:

  • Кешбек для конкретного магазину ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
  • Подарункові картки зі знижкою для конкретного магазину ("best Gap gift card discount") → get_gift_cards_by_store_name
  • Де найвигідніше купити товари бренду ("best cashback on Adidas products") → get_best_deals_by_brand
  • Де найвигідніше купити товари певного типу ("cheapest dog food with cashback") → get_best_deals_by_category
  • Бонус за реєстрацію, мінімальна виплата, графік або способи виплат порталу → get_portals_by_name / get_portals
  • Які магазини пропонують кешбек у країні → get_stores_by_country

Вкажіть країну, коли це важливо ("in Canada", "UK cashback"): асистент передає код країни малими літерами, наприклад us, ca, gb (Велика Британія) або de, а інакше шукає по всіх підтримуваних країнах.

Асистенти звертаються до цих інструментів напряму — їм ніколи не потрібно спочатку перелічувати країни, магазини чи портали.

Доступні інструменти

ІнструментЩо робитьКлючові параметри
get_cashback_rates_by_store_nameПорівнює актуальні ставки кешбеку магазину онлайн і в магазині за всіма порталами за назвою — пряма відповідь на "best cashback for Walmart"store_name, country_code (optional)
get_cashback_rates_by_store_idТе саме, коли ID магазину вже відомий із попереднього результатуstore_id
get_gift_cards_by_store_nameЗнаходить подарункові картки магазину зі знижкою за назвою та порівнює знижкиstore_name, country_code (optional)
get_gift_cards_by_store_idТе саме, коли ID магазину вже відомийstore_id
get_best_deals_by_brandРанжує магазини, що продають бренд, за найкращою ставкою кешбеку та знижкою на подарункові карткиbrand_name, country_code (optional)
get_best_deals_by_categoryТе саме для категорії покупок (наприклад, «Зоотовари»)category_name, country_code (optional)
get_stores_by_nameЗнаходить ID, країну та посилання на сторінку магазину (без ставок)store_name, country_code (optional)
get_stores_by_countryПерегляд усіх магазинів із кешбеком у країні — лише ID магазинів і посилання, без ставок; список може бути довгимcountry_code
get_portalsПерелік кешбек-порталів з умовами виплат (бонус за реєстрацію, мінімальна виплата, періодичність виплат, способи оплати), за бажанням по країні — без ставок магазинівcountry_code (optional)
get_portals_by_nameШукає портали за назвою та повертає їхні умови виплат — без ставок магазинівportal_name, country_code (optional)
get_portal_by_idОтримання конкретного порталу за ID разом з його умовами виплатportal_id
get_countriesПерелік підтримуваних країн та їхніх кодів (Велика Британія — gb)

country_code — ISO-код малими літерами, наприклад us, ca, gb (Велика Британія) або de; він необов'язковий, якщо не зазначено інше. store_id, portal_id та подібні ідентифікатори беруться з попереднього результату.

Відстежувані посилання в результатах

Кожен магазин, ставка кешбеку, подарункова картка та бонус за реєстрацію на порталі в результатах супроводжується відстежуваним посиланням GotCashback (url, а також gift_cards_url, де це доречно). Кешбек нараховується, знижки на подарункові картки застосовуються, а бонуси за реєстрацію надаються лише за переходу за цими посиланнями. Сервер вказує ШІ-клієнтам завжди показувати їх — якщо асистент називає ставку без посилання, попросіть у нього посилання.

Інструменти акаунта (необов'язковий вхід)

Вхід з акаунтом GotCashback (OAuth 2.1 — ваш ШІ-клієнт запропонує його автоматично) відкриває додаткові персональні інструменти. Усі інструменти порівняння вище продовжують працювати без входу.

ІнструментЩо робитьКлючові параметриОбласть доступу
get_my_profileПовертає ваш профіль GotCashback (ім'я, e-mail, аватар)profile
get_my_favorite_storesСписок ваших улюблених магазинівfavorites
toggle_favorite_storeДодає магазин до улюблених або видаляє йогоstore_id, favoritefavorites
get_my_alertsСписок ваших сповіщень про кешбек і подарункові картки (магазин, тип, поріг, останнє повідомлення)alerts
set_store_alertСтворює або оновлює сповіщення, яке надсилає вам лист, коли ставка кешбеку або знижка на подарункові картки магазину досягає порогового відсотка або вищеstore_id, alert_type, threshold_percentalerts
remove_store_alertВидаляє сповіщення для магазинуstore_id, alert_typealerts

Це ті самі сповіщення, якими ви керуєте в розділі «Акаунт → Сповіщення» на сайті: alert_type — cashback або gift_card, threshold_percent — від 1 до 100, повторне збереження наявного сповіщення оновлює його поріг і активує його знову, а кожен акаунт може мати не більше 10 активних сповіщень.

Як працює вхід

  1. Під час першого використання інструмента акаунта сервер відповідає запитом авторизації, і ваш ШІ-клієнт відкриває в браузері сторінку входу GotCashback — той самий вхід через соцмережі, що й на сайті. Реєстрація чи API-ключ не потрібні.
  2. Підтвердьте запитані дозволи (scopes) і поверніться до клієнта. Виклик інструмента завершиться, а підключення залишиться авторизованим — клієнти, які запитують offline_access, отримують refresh-токени, тож повторно входити не доведеться.
  3. Щоб відключитися, видаліть конектор зі свого ШІ-клієнта. Якщо згодом інструмент повідомить про відсутній дозвіл (scope), видаліть і повторно додайте конектор, щоб клієнт запросив авторизацію заново.
Область доступуЩо надає
profileЧитання вашого імені, e-mail та аватара
favoritesЧитання та зміна ваших улюблених магазинів
alertsЧитання, створення та видалення ваших сповіщень про кешбек і подарункові картки
offline_accessRefresh-токени, щоб підключення залишалося авторизованим

Адреса сервера

https://mcp.gotcashback.com

Це віддалений MCP-сервер (транспорт Streamable HTTP). Нічого встановлювати чи хостити не потрібно — просто вкажіть сумісному ШІ-асистенту URL вище.

Для розробників і ШІ-агентів

Сервер (версія 1.1.0) надає лише інструменти (без ресурсів і промптів). Кожен інструмент має назву, опис того, коли його використовувати, анотації «лише читання» та — для інструментів порівняння — опубліковану схему виводу. Ці кінцеві точки дають змогу агенту або інтеграції знайти сервер і підключитися до нього, не читаючи цю сторінку:

Інструменти порівняння повертають необроблений JSON API у вигляді тексту плюс типізований структурований вміст за своєю схемою виводу, тож інтеграції можуть читати магазин, портал, ставку, «до» та онлайн/у магазині без здогадок. Невідомі ID та збої API повертаються як помилки інструмента, а не як збої протоколу.

CORS відкритий для будь-якого джерела, тому браузерні агенти можуть підключатися напряму; заголовки відповіді Mcp-Session-Id і WWW-Authenticate доступні для читання.

Питання чи проблеми?

Якщо підключення не вдається або виклик інструмента завершується помилкою, переконайтеся, що URL введено точно як https://mcp.gotcashback.com без шляху в кінці. Якщо інструмент акаунта знову й знову просить увійти, видаліть і повторно додайте конектор. По додаткову допомогу звертайтеся до підтримки GotCashback.