GotCashback MCP Server
Подключите Claude, ChatGPT и других MCP-совместимых ИИ-ассистентов напрямую к актуальным ставкам кэшбэка GotCashback (онлайн и в магазинах, по всем кэшбэк-порталам), сравнению порталов и условиям выплат, данным магазинов и предложениям подарочных карт — данные обновляются несколько раз в день.
Что такое MCP?
Model Context Protocol (MCP) — открытый стандарт, который позволяет ИИ-ассистентам вызывать внешние инструменты и получать актуальные данные прямо во время разговора. Вместо того чтобы угадывать ставки кэшбэка по устаревшим обучающим данным, ИИ может напрямую обратиться к серверу GotCashback и получить сегодняшние цифры.
Инструкции по установке
Claude (claude.ai / Claude Desktop)
- Откройте «Настройки → Коннекторы» (в Claude Desktop: «Настройки → Коннекторы»; на claude.ai: значок коннекторов в чате).
- Нажмите «Добавить пользовательский коннектор».
- Введите URL:
https://mcp.gotcashback.com - Задайте имя (например, «GotCashback») и сохраните.
- Включите коннектор в любом разговоре, где нужны запросы кэшбэка — Claude будет вызывать инструменты автоматически, когда это уместно.
Claude Code (терминал)
Добавьте сервер одной командой:
claude mcp add --transport http gotcashback https://mcp.gotcashback.comВыполните /mcp в Claude Code, чтобы проверить подключение и войти, когда понадобятся инструменты аккаунта.
ChatGPT
- Откройте «Настройки → Коннекторы» (доступно на тарифах с поддержкой пользовательских коннекторов / коннекторов для разработчиков).
- Выберите добавление пользовательского коннектора и введите URL сервера:
https://mcp.gotcashback.com - Следуйте подсказкам, чтобы авторизовать его и включить для использования в чате или в конфигурации пользовательского 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, favorite | favorites |
get_my_alerts | Список ваших оповещений о кэшбэке и подарочных картах (магазин, тип, порог, последнее уведомление) | — | alerts |
set_store_alert | Создаёт или обновляет оповещение, которое отправляет вам письмо, когда ставка кэшбэка или скидка на подарочные карты магазина достигает порогового процента или выше | store_id, alert_type, threshold_percent | alerts |
remove_store_alert | Удаляет оповещение для магазина | store_id, alert_type | alerts |
Это те же оповещения, которыми вы управляете в разделе «Аккаунт → Оповещения» на сайте: alert_type — cashback или gift_card, threshold_percent — от 1 до 100, повторное сохранение существующего оповещения обновляет его порог и активирует его заново, а у каждого аккаунта может быть не более 10 активных оповещений.
Как работает вход
- При первом использовании инструмента аккаунта сервер отвечает запросом авторизации, и ваш ИИ-клиент открывает в браузере страницу входа GotCashback — тот же вход через соцсети, что и на сайте. Регистрация или API-ключ не нужны.
- Подтвердите запрошенные разрешения (scopes) и вернитесь в клиент. Вызов инструмента завершится, а подключение останется авторизованным — клиенты, запрашивающие offline_access, получают refresh-токены, так что повторно входить не придётся.
- Чтобы отключиться, удалите коннектор из своего ИИ-клиента. Если позже инструмент сообщит об отсутствующем разрешении (scope), удалите и заново добавьте коннектор, чтобы клиент запросил авторизацию заново.
| Область доступа | Что даёт |
|---|---|
profile | Чтение вашего имени, e-mail и аватара |
favorites | Чтение и изменение ваших избранных магазинов |
alerts | Чтение, создание и удаление ваших оповещений о кэшбэке и подарочных картах |
offline_access | Refresh-токены, чтобы подключение оставалось авторизованным |
Адрес сервера
https://mcp.gotcashback.com
Это удалённый MCP-сервер (транспорт Streamable HTTP). Ничего устанавливать или хостить не нужно — просто укажите совместимому ИИ-ассистенту URL выше.
Для разработчиков и ИИ-агентов
Сервер (версия 1.1.0) предоставляет только инструменты (без ресурсов и промптов). У каждого инструмента есть название, описание того, когда его использовать, аннотации «только чтение» и — для инструментов сравнения — опубликованная схема вывода. Эти конечные точки позволяют агенту или интеграции найти сервер и подключиться к нему, не читая эту страницу:
Инструменты сравнения возвращают необработанный JSON API в виде текста плюс типизированное структурированное содержимое по своей схеме вывода, поэтому интеграции могут читать магазин, портал, ставку, «до» и онлайн/в магазине без догадок. Неизвестные ID и сбои API возвращаются как ошибки инструмента, а не как сбои протокола.
https://mcp.gotcashback.com— Адрес MCP — Streamable HTTP, JSON-RPC через POST, без сохранения состояния (привязка к сессии не требуется)https://mcp.gotcashback.com/.well-known/mcp/server-card.json— Карточка MCP-сервера с описанием сервера, транспорта и аутентификации (также доступна на этом сайте)https://mcp.gotcashback.com/.well-known/oauth-protected-resource— Метаданные защищённого ресурса OAuth: поддерживаемые области доступа (scopes) и сервер авторизацииhttps://www.gotcashback.com/.well-known/oauth-authorization-server— Метаданные сервера авторизации — authorization code flow с PKCE, динамическая регистрация клиентов (публичных и конфиденциальных), refresh-токеныhttps://www.gotcashback.com/auth.md— Политика аутентификации агентовhttps://www.gotcashback.com/llms.txt— Индекс сайта для агентовhttps://api.gotcashback.com/swagger/— Бесплатный REST API, лежащий в основе инструментов (спецификация OpenAPI, ключ не требуется)https://mcp.gotcashback.com/health— Проверка работоспособности
CORS открыт для любого источника, поэтому браузерные агенты могут подключаться напрямую; заголовки ответа Mcp-Session-Id и WWW-Authenticate доступны для чтения.
Вопросы или проблемы?
Если подключение не удаётся или вызов инструмента завершается ошибкой, убедитесь, что URL введён точно как https://mcp.gotcashback.com без пути в конце. Если инструмент аккаунта снова и снова просит войти, удалите и заново добавьте коннектор. За дополнительной помощью обращайтесь в поддержку GotCashback.