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)

  1. Avaa Asetukset → Liittimet (Claude Desktopissa: Asetukset → Liittimet; claude.ai-sivustolla: liitinkuvake keskustelussa).
  2. Napsauta "Lisää mukautettu liitin".
  3. Syötä URL-osoite: https://mcp.gotcashback.com
  4. Anna sille nimi (esim. "GotCashback") ja tallenna.
  5. 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.com

Suorita /mcp Claude Codessa tarkistaaksesi yhteyden ja kirjautuaksesi sisään, kun haluat käyttää tilityökaluja.

ChatGPT

  1. Avaa Asetukset → Liittimet (saatavilla tilauksissa, jotka tukevat mukautettuja liittimiä tai kehittäjäliittimiä).
  2. Valitse mukautetun liittimen lisääminen ja syötä palvelimen URL-osoite: https://mcp.gotcashback.com
  3. 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ökaluMitä se tekeeTärkeimmät syötteet
get_cashback_rates_by_store_nameVertailee 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_idSama, kun kaupan tunnus tiedetään jo aiemmasta tuloksestastore_id
get_gift_cards_by_store_nameLöytää kaupan alennetut lahjakortit nimen perusteella ja vertailee alennuksiastore_name, country_code (optional)
get_gift_cards_by_store_idSama, kun kaupan tunnus tiedetään jostore_id
get_best_deals_by_brandJärjestää brändiä myyvät kaupat parhaan cashback-hyvityksen ja lahjakorttialennuksen mukaanbrand_name, country_code (optional)
get_best_deals_by_categorySama ostoskategorialle (esim. "Lemmikkitarvikkeet")category_name, country_code (optional)
get_stores_by_nameLöytää kaupan tunnuksen, maan ja sivulinkin (ei prosentteja)store_name, country_code (optional)
get_stores_by_countrySelaa kaikkia maan cashback-kauppoja — vain kauppojen tunnukset ja linkit, ei prosentteja; lista voi olla pitkäcountry_code
get_portalsListaa cashback-portaalit maksuehtoineen (liittymisbonus, vähimmäismaksu, maksutiheys, maksutavat), halutessa maittain — ei kauppojen prosenttejacountry_code (optional)
get_portals_by_nameHakee portaaleja nimellä ja palauttaa niiden maksuehdot — ei kauppojen prosenttejaportal_name, country_code (optional)
get_portal_by_idHakee tietyn portaalin ID:n perusteella maksuehtoineenportal_id
get_countriesListaa 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ökaluMitä se tekeeTärkeimmät syötteetScope
get_my_profilePalauttaa GotCashback-profiilisi (nimi, sähköposti, avatar)—profile
get_my_favorite_storesListaa suosikkikauppasi—favorites
toggle_favorite_storeLisää kaupan suosikkeihisi tai poistaa sen niistästore_id, favoritefavorites
get_my_alertsListaa cashback- ja lahjakorttihälytyksesi (kauppa, tyyppi, raja-arvo, viimeisin ilmoitus)—alerts
set_store_alertLuo tai päivittää hälytyksen, joka lähettää sinulle sähköpostia, kun kaupan cashback-hyvitys tai lahjakorttialennus saavuttaa raja-arvoprosentin tai ylittää senstore_id, alert_type, threshold_percentalerts
remove_store_alertPoistaa kaupan hälytyksenstore_id, alert_typealerts

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

  1. 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.
  2. 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.
  3. 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.
ScopeMitä se sallii
profileLukea nimesi, sähköpostisi ja avatarisi
favoritesLukea ja muuttaa suosikkikauppojasi
alertsLukea, luoda ja poistaa cashback- ja lahjakorttihälytyksiäsi
offline_accessRefresh-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ä.

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.