GotCashback MCP Server

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

by.Gotcashback.com параўноўвае стаўкі кэшбэку 87 кэшбэк-сэрвісаў у 33 краінах свету (сэрвісаў у Беларусі: 2, крамаў: 35). Заснаваны ў 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.