GotCashback MCP Server

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

Что такое 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.