GotCashback MCP Server

Ühenda Claude, ChatGPT ja teised MCP-ga ühilduvad AI-assistendid otse GotCashbacki ajakohaste cashback-määradega (veebis ja poes, kõigis cashback-portaalides), portaalide võrdluste ja väljamaksetingimustega, poeandmete ja kinkekaardipakkumistega — uuendatakse mitu korda päevas.

ee.Gotcashback.com võrdleb 113 cashback-portaali määrasid 42 riigis üle maailma, sealhulgas 2 portaali ja 172 poodi Eestis. Asutatud 2020; haldab MNP Enterprises, LLC.

Mis on MCP?

Model Context Protocol (MCP) on avatud standard, mis võimaldab AI-assistentidel vestluse ajal kutsuda väliseid tööriistu ja hankida ajakohaseid andmeid. Selle asemel, et AI arvaks cashback-määrasid aegunud treeningandmete põhjal, saab ta pöörduda otse GotCashbacki serveri poole ja saada tänased numbrid.

Paigaldusjuhised

Claude (claude.ai / Claude Desktop)

1. Ava Seaded → Konnektorid (Claude Desktopis: Seaded → Konnektorid; claude.ai-s: konnektorite ikoon vestluses).
2. Klõpsa "Lisa kohandatud konnektor".
3. Sisesta URL: https://mcp.gotcashback.com
4. Anna sellele nimi (nt "GotCashback") ja salvesta.
5. Luba konnektor igas vestluses, kus soovid cashbacki otsinguid teha — Claude kutsub tööriistu automaatselt, kui see on asjakohane.

Claude Code (terminal)

Lisa server ühe käsuga:

claude mcp add --transport http gotcashback https://mcp.gotcashback.com

Käivita Claude Code'is /mcp, et kontrollida ühendust ja logida sisse, kui soovid kontotööriistu kasutada.

ChatGPT

1. Ava Seaded → Konnektorid (saadaval pakettides, mis toetavad kohandatud või arendaja konnektoreid).
2. Vali kohandatud konnektori lisamine ja sisesta serveri URL: https://mcp.gotcashback.com
3. Järgi juhiseid, et see autoriseerida ja lubada kasutamiseks vestluses või kohandatud GPT seadistuses.

VS Code (GitHub Copilot agendirežiim)

Käivita käsupaletist "MCP: Add Server" või lisa see faili .vscode/mcp.json:

{
  "servers": {
    "gotcashback": {
      "type": "http",
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Teised MCP-ga ühilduvad kliendid (Cursor, Windsurf jne)

Enamik MCP-kliente aktsepteerib JSON-konfiguratsiooni, mis osutab kaugserverile. Tüüpiline kirje näeb välja selline:

{
  "mcpServers": {
    "gotcashback": {
      "url": "https://mcp.gotcashback.com"
    }
  }
}

Vaata oma kliendi dokumentatsioonist, kus see konfiguratsioonifail asub (nt ~/.cursor/mcp.json Cursori puhul) — ülaltoodud URL ja struktuur on enamikus klientides samad, kuna need järgivad sama MCP spetsifikatsiooni.

Näidisküsimused pärast ühendamist

• "Milline on praegu Best Buy parim cashback-määr?"
• "Kas Targeti jaoks on soodushinnaga kinkekaarte?"
• "What's the best cashback rate for Walmart in Canada?"
• "Compare gift card discounts for Home Depot."
• "Millised cashback-portaalid on saadaval Ühendkuningriigis?"
• "Kust saan osta Adidas tooteid parima cashbackiga?"
• "Kust saan osta koeratoitu suurima allahindlusega?"
• "Millised Ühendkuningriigi cashback-portaalid maksavad PayPali kaudu ja millisel neist on madalaim minimaalne väljamakse?"
• "Kas TopCashback pakub liitumisboonust ja kui tihti ta välja maksab?"
• "Teavita mind, kui Nike cashback-määr jõuab 10%-ni."
• "Lisa Best Buy minu lemmikpoodide hulka."

Viimased kaks kasutavad valikulisi kontotööriistu ja paluvad sul GotCashbacki kontoga sisse logida.

Eelistad hoopis Telegramis vestelda? Proovi GotCashbacki Telegrami botti

Mida GotCashbacki MCP server teeb

Pärast ühendamist saab AI-assistent võrrelda poe ajakohaseid veebi- ja poesiseseid cashback-määrasid portaalide lõikes, leida soodushinnaga kinkekaarte, järjestada brändi või ostukategooriat pakkuvad poed parima pakkumise järgi, sirvida poode riigi kaupa ja vaadata iga portaali väljamaksetingimusi (liitumisboonus, minimaalne väljamakse, väljamaksete sagedus, makseviisid). Server ütleb assistendile, milline tööriist millist tüüpi küsimusele vastab, nii et tavaline küsimus nagu "best cashback for Walmart" jõuab otse õige päringuni. Määrasid uuendatakse mitu korda päevas.

Kuidas assistent tööriista valib

Server ütleb ühendatud assistentidele, milline tööriist millisele küsimusele vastab, nii et võid küsida loomulikult:

• Cashback konkreetse poe jaoks ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
• Soodushinnaga kinkekaardid konkreetse poe jaoks ("best Gap gift card discount") → get_gift_cards_by_store_name
• Kust osta brändi tooteid suurima säästuga ("best cashback on Adidas products") → get_best_deals_by_brand
• Kust osta teatud tüüpi toodet suurima säästuga ("cheapest dog food with cashback") → get_best_deals_by_category
• Portaali liitumisboonus, minimaalne väljamakse, väljamaksegraafik või makseviisid → get_portals_by_name / get_portals
• Millised poed pakuvad riigis cashbacki → get_stores_by_country

Maini riiki, kui see on oluline ("in Canada", "UK cashback"): assistent edastab väiketähtedega riigikoodi, näiteks us, ca, gb (Ühendkuningriik) või de, ning muidu otsib kõigist toetatud riikidest.

Assistendid kasutavad neid tööriistu otse — neil ei ole kunagi vaja enne riike, poode ega portaale loetleda.

Saadaolevad tööriistad

country_code on väiketähtedega ISO-kood, näiteks us, ca, gb (Ühendkuningriik) või de; see on valikuline, kui pole märgitud kohustuslikuks. store_id, portal_id ja sarnased ID-d pärinevad varasemast tulemusest.

Jälgitavad lingid tulemustes

Iga pood, cashback-määr, kinkekaart ja portaali liitumisboonus tulemustes sisaldab jälgitavat GotCashbacki linki (url ning vajaduse korral ka gift_cards_url). Cashback krediteeritakse, kinkekaardiallahindlus kehtib ja liitumisboonus antakse ainult siis, kui klõpsad nende linkide kaudu. Server annab AI-klientidele korralduse neid alati näidata — kui assistent nimetab määra ilma lingita, küsi temalt linki.

Kontotööriistad (valikuline sisselogimine)

GotCashbacki kontoga sisselogimine (OAuth 2.1 — sinu AI-klient pakub seda automaatselt) avab täiendavad kasutajapõhised tööriistad. Kõik ülaltoodud võrdlustööriistad töötavad ka ilma sisselogimiseta.

Need on samad teavitused, mida haldad veebisaidil jaotises Konto → Teavitused: alert_type on cashback või gift_card, threshold_percent on vahemikus 1 kuni 100, olemasoleva teavituse uuesti salvestamine uuendab selle läve ja aktiveerib selle uuesti ning igal kontol võib olla kuni 10 aktiivset teavitust.

Kuidas sisselogimine toimib

1. Kui kasutad kontotööriista esimest korda, vastab server autoriseerimispäringuga ja sinu AI-klient avab brauseris GotCashbacki sisselogimislehe — sama sotsiaalmeedia sisselogimine nagu veebisaidil. Registreerimist ega API-võtit pole vaja.
2. Kinnita küsitud õigused (scope'id) ja naase oma klienti. Tööriista kutse viiakse lõpule ja ühendus jääb sisselogituks — kliendid, kes küsivad offline_access õigust, saavad värskendustokenid, nii et sinult ei küsita seda uuesti.
3. Ühenduse katkestamiseks eemalda konnektor oma AI-kliendist. Kui tööriist teatab hiljem puuduvast õigusest (scope), eemalda konnektor ja lisa see uuesti, et klient küsiks autoriseerimist uuesti.

Serveri lõpp-punkt

https://mcp.gotcashback.com

See on kaug-MCP-server (Streamable HTTP transport). Sul pole vaja midagi installida ega majutada — suuna lihtsalt ühilduv AI-assistent ülaltoodud URL-ile.

Arendajatele ja AI-agentidele

Server (versioon 1.1.1) pakub ainult tööriistu (ressursse ega prompte mitte). Igal tööriistal on pealkiri, kirjeldus selle kohta, millal seda kasutada, kirjutuskaitstud annotatsioonid ja — võrdlustööriistadel — avaldatud väljundskeem. Need lõpp-punktid võimaldavad agendil või integratsioonil serveri leida ja sellega ühenduda ilma seda lehte lugemata:

Võrdlustööriistad tagastavad API toor-JSON-i tekstina ja lisaks nende väljundskeemile vastava tüübitud struktureeritud sisu, nii et integratsioonid saavad lugeda poodi, portaali, määra, „kuni" märget ja veebi/poe välju ilma arvamata. Tundmatud ID-d ja API katkestused tagastatakse tööriistavigadena, mitte protokollivigadena.

• https://mcp.gotcashback.com — MCP lõpp-punkt — Streamable HTTP, JSON-RPC üle POST-i, olekuta (seansi sidumist pole vaja)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — MCP serverikaart, mis kirjeldab serverit, transporti ja autentimist (saadaval ka sellel saidil)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — OAuth kaitstud ressursi metaandmed: toetatud õigused (scope'id) ja autoriseerimisserver
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Autoriseerimisserveri metaandmed — authorization code flow koos PKCE-ga, dünaamiline kliendiregistreerimine (avalikud ja konfidentsiaalsed kliendid), värskendustokenid
• https://www.gotcashback.com/auth.md — Agentide autentimispoliitika
• https://www.gotcashback.com/llms.txt — Agentidele loetav saidi indeks
• https://api.gotcashback.com/swagger/ — Tööriistade taga olev tasuta REST API (OpenAPI spetsifikatsioon, võtit pole vaja)
• https://mcp.gotcashback.com/health — Tervisekontroll

CORS on avatud kõigile päritoludele, nii et brauseripõhised agendid saavad otse ühenduda; vastuse päised Mcp-Session-Id ja WWW-Authenticate on avalikustatud.

Küsimused või probleemid?

Kui ühendus ebaõnnestub või tööriista kutse annab vea, kontrolli üle, et URL oleks sisestatud täpselt kujul https://mcp.gotcashback.com ilma lõpus oleva teeta. Kui kontotööriist palub sul pidevalt sisse logida, eemalda konnektor ja lisa see uuesti. Lisaabi saamiseks võta ühendust GotCashbacki toega.