GotCashback MCP Server
Yhdistä Claude, ChatGPT ja muut MCP-yhteensopivat tekoälyavustajat suoraan GotCashbackin ajantasaisiin cashback-prosentteihin (verkossa ja myymälässä, kaikista cashback-portaaleista), portaalivertailuihin ja maksuehtoihin, kauppatietoihin ja lahjakorttitarjouksiin — päivitetään useita kertoja päivässä.
fi.GotCashback.com vertailee 113 cashback-portaalin hyvityksiä 42 maassa eri puolilla maailmaa, mukaan lukien 2 portaalia ja 500 kauppaa Suomessa. Perustettu vuonna 2020; ylläpitäjä MNP Enterprises, LLC.
Mikä MCP on?
Model Context Protocol (MCP) on avoin standardi, jonka avulla tekoälyavustajat voivat kutsua ulkoisia työkaluja ja hakea ajantasaista tietoa kesken keskustelun. Sen sijaan että tekoäly arvailisi cashback-prosentteja vanhentuneen koulutusdatan perusteella, se voi kysyä suoraan GotCashbackin palvelimelta ja saada tämän päivän luvut.
Asennusohjeet
Claude (claude.ai / Claude Desktop)
- Avaa Asetukset → Liittimet (Claude Desktopissa: Asetukset → Liittimet; claude.ai-sivustolla: liitinkuvake keskustelussa).
- Napsauta "Lisää mukautettu liitin".
- Syötä URL-osoite:
https://mcp.gotcashback.com - Anna sille nimi (esim. "GotCashback") ja tallenna.
- Ota liitin käyttöön jokaisessa keskustelussa, jossa haluat tehdä cashback-hakuja — Claude kutsuu työkaluja automaattisesti tarvittaessa.
Claude Code (pääte)
Lisää palvelin yhdellä komennolla:
claude mcp add --transport http gotcashback https://mcp.gotcashback.comSuorita /mcp Claude Codessa tarkistaaksesi yhteyden ja kirjautuaksesi sisään, kun haluat käyttää tilityökaluja.
ChatGPT
- Avaa Asetukset → Liittimet (saatavilla tilauksissa, jotka tukevat mukautettuja liittimiä tai kehittäjäliittimiä).
- Valitse mukautetun liittimen lisääminen ja syötä palvelimen URL-osoite:
https://mcp.gotcashback.com - Seuraa ohjeita valtuuttaaksesi sen ja ottaaksesi sen käyttöön keskustelussa tai mukautetun GPT:n asetuksissa.
VS Code (GitHub Copilot -agenttitila)
Suorita "MCP: Add Server" komentopaletista tai lisää tämä tiedostoon .vscode/mcp.json:
{
"servers": {
"gotcashback": {
"type": "http",
"url": "https://mcp.gotcashback.com"
}
}
}Muut MCP-yhteensopivat asiakasohjelmat (Cursor, Windsurf jne.)
Useimmat MCP-asiakasohjelmat hyväksyvät JSON-määrityksen, joka osoittaa etäpalvelimeen. Tyypillinen merkintä näyttää tältä:
{
"mcpServers": {
"gotcashback": {
"url": "https://mcp.gotcashback.com"
}
}
}Tarkista asiakasohjelmasi dokumentaatiosta, missä tämä määritystiedosto sijaitsee (esim. ~/.cursor/mcp.json Cursorissa) — yllä oleva URL-osoite ja rakenne ovat samat useimmissa asiakasohjelmissa, koska ne noudattavat samaa MCP-määrittelyä.
Esimerkkikehotteita yhteyden muodostamisen jälkeen
- "Mikä on Best Buyn paras cashback-hyvitys juuri nyt?"
- "Onko Targetille alennettuja lahjakortteja?"
- "What's the best cashback rate for Walmart in Canada?"
- "Compare gift card discounts for Home Depot."
- "Mitkä cashback-portaalit ovat saatavilla Yhdistyneessä kuningaskunnassa?"
- "Mistä voin ostaa Adidas-tuotteita parhaalla cashbackilla?"
- "Mistä voin ostaa koiranruokaa suurimmalla alennuksella?"
- "Mitkä Yhdistyneen kuningaskunnan cashback-portaalit maksavat PayPalin kautta, ja millä on alhaisin minimimaksu?"
- "Tarjoaako TopCashback liittymisbonuksen, ja kuinka usein se maksaa?"
- "Hälytä minulle, kun Niken cashback-hyvitys saavuttaa 10 %."
- "Lisää Best Buy suosikkikauppoihini."
Kaksi viimeistä käyttävät valinnaisia tilityökaluja ja pyytävät sinua kirjautumaan GotCashback-tililläsi.
Chattailetko mieluummin Telegramissa? Kokeile GotCashbackin Telegram-bottia
Mitä GotCashback MCP Server tekee
Kun yhteys on muodostettu, tekoälyavustaja voi vertailla kaupan ajantasaisia verkko- ja myymälä-cashback-prosentteja eri portaaleissa, löytää alennettuja lahjakortteja, järjestää brändiä tai ostoskategoriaa myyvät kaupat parhaan tarjouksen mukaan, selata kauppoja maittain ja tarkistaa kunkin portaalin maksuehdot (liittymisbonus, vähimmäismaksu, maksutiheys, maksutavat). Palvelin kertoo avustajalle, mikä työkalu vastaa mihinkin kysymykseen, joten tavallinen kysymys kuten "best cashback for Walmart" ohjautuu suoraan oikeaan hakuun. Prosentit päivitetään useita kertoja päivässä.
Miten avustaja valitsee työkalun
Palvelin kertoo yhdistetyille avustajille, mikä työkalu vastaa mihinkin kysymykseen, joten voit kysyä luontevasti:
- Cashback tietylle kaupalle ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") →
get_cashback_rates_by_store_name - Alennetut lahjakortit tietylle kaupalle ("best Gap gift card discount") →
get_gift_cards_by_store_name - Mistä brändin tuotteet saa edullisimmin ("best cashback on Adidas products") →
get_best_deals_by_brand - Mistä tietyn tuotetyypin saa edullisimmin ("cheapest dog food with cashback") →
get_best_deals_by_category - Portaalin liittymisbonus, vähimmäismaksu, maksuaikataulu tai maksutavat →
get_portals_by_name/get_portals - Mitkä kaupat tarjoavat cashbackia tietyssä maassa →
get_stores_by_country
Mainitse maa, kun sillä on merkitystä ("in Canada", "UK cashback"): avustaja välittää pienillä kirjaimilla kirjoitetun maakoodin kuten us, ca, gb (Yhdistynyt kuningaskunta) tai de, ja muuten hakee kaikista tuetuista maista.
Avustajat käyttävät näitä työkaluja suoraan — niiden ei koskaan tarvitse ensin listata maita, kauppoja tai portaaleja.
Käytettävissä olevat työkalut
| Työkalu | Mitä se tekee | Tärkeimmät syötteet |
|---|---|---|
get_cashback_rates_by_store_name | Vertailee kaupan ajantasaisia verkko- ja myymälä-cashback-prosentteja eri portaaleissa nimen perusteella — suora vastaus kysymykseen "best cashback for Walmart" | store_name, country_code (optional) |
get_cashback_rates_by_store_id | Sama, kun kaupan tunnus tiedetään jo aiemmasta tuloksesta | store_id |
get_gift_cards_by_store_name | Löytää kaupan alennetut lahjakortit nimen perusteella ja vertailee alennuksia | store_name, country_code (optional) |
get_gift_cards_by_store_id | Sama, kun kaupan tunnus tiedetään jo | store_id |
get_best_deals_by_brand | Järjestää brändiä myyvät kaupat parhaan cashback-hyvityksen ja lahjakorttialennuksen mukaan | brand_name, country_code (optional) |
get_best_deals_by_category | Sama ostoskategorialle (esim. "Lemmikkitarvikkeet") | category_name, country_code (optional) |
get_stores_by_name | Löytää kaupan tunnuksen, maan ja sivulinkin (ei prosentteja) | store_name, country_code (optional) |
get_stores_by_country | Selaa kaikkia maan cashback-kauppoja — vain kauppojen tunnukset ja linkit, ei prosentteja; lista voi olla pitkä | country_code |
get_portals | Listaa cashback-portaalit maksuehtoineen (liittymisbonus, vähimmäismaksu, maksutiheys, maksutavat), halutessa maittain — ei kauppojen prosentteja | country_code (optional) |
get_portals_by_name | Hakee portaaleja nimellä ja palauttaa niiden maksuehdot — ei kauppojen prosentteja | portal_name, country_code (optional) |
get_portal_by_id | Hakee tietyn portaalin ID:n perusteella maksuehtoineen | portal_id |
get_countries | Listaa tuetut maat ja niiden koodit (Yhdistynyt kuningaskunta on gb) | — |
country_code on pienillä kirjaimilla kirjoitettu ISO-koodi kuten us, ca, gb (Yhdistynyt kuningaskunta) tai de, ja se on valinnainen, ellei sitä ole merkitty pakolliseksi. store_id, portal_id ja vastaavat tunnukset saadaan aiemmasta tuloksesta.
Seuratut linkit tuloksissa
Jokaisella tuloksen kaupalla, cashback-hyvityksellä, lahjakortilla ja portaalin liittymisbonuksella on seurattu GotCashback-linkki (url sekä tarvittaessa gift_cards_url). Cashback hyvitetään, lahjakorttialennukset ovat voimassa ja liittymisbonukset myönnetään vain, kun siirryt kauppaan näiden linkkien kautta. Palvelin ohjeistaa tekoälyasiakkaita näyttämään ne aina — jos avustaja kertoo hyvityksen ilman linkkiä, pyydä siltä linkkiä.
Tilityökalut (valinnainen kirjautuminen)
Kirjautuminen GotCashback-tilillesi (OAuth 2.1 — tekoälyasiakkaasi tarjoaa sitä automaattisesti) avaa käyttöön lisää käyttäjäkohtaisia työkaluja. Kaikki yllä olevat vertailutyökalut toimivat myös ilman kirjautumista.
| Työkalu | Mitä se tekee | Tärkeimmät syötteet | Scope |
|---|---|---|---|
get_my_profile | Palauttaa GotCashback-profiilisi (nimi, sähköposti, avatar) | — | profile |
get_my_favorite_stores | Listaa suosikkikauppasi | — | favorites |
toggle_favorite_store | Lisää kaupan suosikkeihisi tai poistaa sen niistä | store_id, favorite | favorites |
get_my_alerts | Listaa cashback- ja lahjakorttihälytyksesi (kauppa, tyyppi, raja-arvo, viimeisin ilmoitus) | — | alerts |
set_store_alert | Luo tai päivittää hälytyksen, joka lähettää sinulle sähköpostia, kun kaupan cashback-hyvitys tai lahjakorttialennus saavuttaa raja-arvoprosentin tai ylittää sen | store_id, alert_type, threshold_percent | alerts |
remove_store_alert | Poistaa kaupan hälytyksen | store_id, alert_type | alerts |
Hälytykset ovat samat, joita hallitset verkkosivustolla kohdassa Tili → Hälytykset: alert_type on cashback tai gift_card, threshold_percent on välillä 1–100, olemassa olevan hälytyksen tallentaminen uudelleen päivittää sen raja-arvon ja aktivoi sen uudelleen, ja jokaisella tilillä voi olla enintään 10 aktiivista hälytystä.
Miten kirjautuminen toimii
- Kun käytät tilityökalua ensimmäistä kertaa, palvelin vastaa valtuutuspyynnöllä ja tekoälyasiakkaasi avaa GotCashbackin kirjautumissivun selaimessasi — sama sosiaalinen kirjautuminen kuin verkkosivustolla. Rekisteröitymistä tai API-avainta ei tarvita.
- Hyväksy pyydetyt käyttöoikeudet (scopet) ja palaa asiakasohjelmaasi. Työkalukutsu suoritetaan loppuun, ja yhteys pysyy kirjautuneena — offline_access-oikeutta pyytävät asiakasohjelmat saavat refresh-tokenit, joten sinulta ei kysytä uudelleen.
- Katkaise yhteys poistamalla liitin tekoälyasiakkaastasi. Jos työkalu ilmoittaa myöhemmin puuttuvasta scopesta, poista liitin ja lisää se uudelleen, jotta asiakasohjelma pyytää valtuutuksen uudestaan.
| Scope | Mitä se sallii |
|---|---|
profile | Lukea nimesi, sähköpostisi ja avatarisi |
favorites | Lukea ja muuttaa suosikkikauppojasi |
alerts | Lukea, luoda ja poistaa cashback- ja lahjakorttihälytyksiäsi |
offline_access | Refresh-tokenit, jotta yhteys pysyy kirjautuneena |
Palvelimen päätepiste
https://mcp.gotcashback.com
Tämä on etäkäytettävä MCP-palvelin (Streamable HTTP -yhteyskäytäntö). Sinun ei tarvitse asentaa tai ylläpitää mitään — osoita vain yhteensopiva tekoälyavustaja yllä olevaan URL-osoitteeseen.
Kehittäjille ja tekoälyagenteille
Palvelin (versio 1.1.1) tarjoaa vain työkaluja (ei resursseja tai kehotteita). Jokaisella työkalulla on otsikko, kuvaus siitä, milloin sitä käytetään, vain luku -merkinnät ja — vertailutyökaluilla — julkaistu tulosteskeema. Näiden päätepisteiden kautta agentti tai integraatio voi löytää palvelimen ja yhdistää siihen lukematta tätä sivua:
Vertailutyökalut palauttavat raa'an API-JSONin tekstinä sekä tyypitetyn rakenteisen sisällön tulosteskeemansa mukaisesti, joten integraatiot voivat lukea kaupan, portaalin, prosentin, "enintään"-tiedon ja verkko/myymälä-kentät arvailematta. Tuntemattomat tunnukset ja API-katkokset palautuvat työkaluvirheinä, eivät protokollavirheinä.
https://mcp.gotcashback.com— MCP-päätepiste — Streamable HTTP, JSON-RPC POST-pyynnöillä, tilaton (istuntoaffiniteettia ei tarvita)https://mcp.gotcashback.com/.well-known/mcp/server-card.json— MCP-palvelinkortti, joka kuvaa palvelimen, yhteyskäytännön ja todennuksen (tarjolla myös tällä sivustolla)https://mcp.gotcashback.com/.well-known/oauth-protected-resource— OAuth protected resource -metatiedot: tuetut scopet ja valtuutuspalvelinhttps://www.gotcashback.com/.well-known/oauth-authorization-server— Valtuutuspalvelimen metatiedot — authorization code -kulku PKCE:llä, dynaaminen asiakasrekisteröinti (julkiset ja luottamukselliset asiakasohjelmat), refresh-tokenithttps://www.gotcashback.com/auth.md— Agenttien todennuskäytäntöhttps://www.gotcashback.com/llms.txt— Agenttien luettavissa oleva sivustohakemistohttps://api.gotcashback.com/swagger/— Työkalujen taustalla oleva ilmainen REST API (OpenAPI-määrittely, avainta ei tarvita)https://mcp.gotcashback.com/health— Toimivuustarkistus
CORS on avoin kaikille alkuperille, joten selainpohjaiset agentit voivat yhdistää suoraan; vastausotsakkeet Mcp-Session-Id ja WWW-Authenticate ovat luettavissa.
Kysyttävää tai ongelmia?
Jos yhteys epäonnistuu tai työkalukutsu antaa virheen, tarkista, että URL-osoite on syötetty täsmälleen muodossa https://mcp.gotcashback.com ilman perään lisättyä polkua. Jos tilityökalu pyytää sinua kirjautumaan yhä uudelleen, poista liitin ja lisää se uudelleen. Lisäapua saat GotCashbackin tuesta.