Server MCP GotCashback

Conectează Claude, ChatGPT și alți asistenți AI compatibili MCP direct la ratele de cashback actuale ale GotCashback (online și în magazin, pe toate portalurile de cashback), la comparațiile între portaluri și condițiile de plată, la datele magazinelor și la ofertele de carduri cadou — actualizate de mai multe ori pe zi.

ro.Gotcashback.com compară ratele de cashback ale 112 de portaluri de cashback din 42 de țări din întreaga lume, inclusiv 3 portaluri și 1.087 de magazine în România. Fondat în 2020; operat de MNP Enterprises, LLC.

Ce este MCP?

Model Context Protocol (MCP) este un standard deschis care permite asistenților AI să apeleze instrumente externe și să obțină date actuale în timpul unei conversații. În loc să ghicească ratele de cashback din date de antrenare învechite, un AI poate interoga direct serverul GotCashback și poate obține cifrele de astăzi.

Instrucțiuni de instalare

Claude (claude.ai / Claude Desktop)

1. Deschide Setări → Conectori (în Claude Desktop: Setări → Conectori; pe claude.ai: pictograma conectorilor dintr-o conversație).
2. Apasă pe "Adaugă conector personalizat".
3. Introdu URL-ul: https://mcp.gotcashback.com
4. Dă-i un nume (de ex. "GotCashback") și salvează.
5. Activează conectorul în orice conversație în care vrei căutări de cashback — Claude va apela automat instrumentele atunci când este relevant.

Claude Code (terminal)

Adaugă serverul cu o singură comandă:

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

Rulează /mcp în Claude Code pentru a verifica conexiunea și pentru a te autentifica atunci când vrei să folosești instrumentele de cont.

ChatGPT

1. Deschide Setări → Conectori (disponibil în planurile care acceptă conectori personalizați/pentru dezvoltatori).
2. Alege să adaugi un conector personalizat și introdu URL-ul serverului: https://mcp.gotcashback.com
3. Urmează pașii pentru a-l autoriza și a-l activa în conversație sau în configurația unui GPT personalizat.

VS Code (modul agent GitHub Copilot)

Rulează "MCP: Add Server" din paleta de comenzi sau adaugă asta în .vscode/mcp.json:

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

Alți clienți compatibili cu MCP (Cursor, Windsurf etc.)

Majoritatea clienților MCP acceptă o configurație JSON care indică un server la distanță. O intrare tipică arată astfel:

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

Consultă documentația clientului tău pentru a afla unde se află acest fișier de configurare (de ex. ~/.cursor/mcp.json pentru Cursor) — URL-ul și structura de mai sus sunt aceleași la majoritatea clienților, deoarece respectă aceeași specificație MCP.

Exemple de întrebări după conectare

• "Care este cea mai bună rată de cashback pentru Best Buy în acest moment?"
• "Există carduri cadou cu reducere pentru Target?"
• "What's the best cashback rate for Walmart in Canada?"
• "Compare gift card discounts for Home Depot."
• "Ce portaluri de cashback sunt disponibile în Regatul Unit?"
• "De unde pot cumpăra produse Adidas cu cel mai bun cashback?"
• "De unde pot cumpăra hrană pentru câini cu cea mai mare reducere?"
• "Ce portaluri de cashback din Regatul Unit plătesc prin PayPal și care are cea mai mică plată minimă?"
• "TopCashback oferă un bonus de înscriere și cât de des plătește?"
• "Anunță-mă când rata de cashback pentru Nike ajunge la 10%."
• "Adaugă Best Buy la magazinele mele favorite."

Ultimele două folosesc instrumentele de cont opționale și îți vor cere să te autentifici cu contul tău GotCashback.

Preferi să discuți pe Telegram? Încearcă botul de Telegram GotCashback

Ce face serverul MCP GotCashback

Odată conectat, un asistent AI poate compara ratele de cashback actuale online și în magazin ale unui magazin pe toate portalurile, poate găsi carduri cadou cu reducere, poate ordona magazinele care vând un brand sau o categorie de cumpărături după cea mai bună ofertă, poate parcurge magazinele pe țări și poate consulta condițiile de plată ale fiecărui portal (bonus de înscriere, plată minimă, frecvența plăților, metode de plată). Serverul îi spune asistentului ce instrument răspunde la fiecare tip de întrebare, astfel încât o întrebare simplă precum "best cashback for Walmart" ajunge direct la căutarea potrivită. Ratele sunt actualizate de mai multe ori pe zi.

Cum alege un asistent instrumentul

Serverul le spune asistenților conectați ce instrument răspunde la fiecare întrebare, așa că poți întreba în mod natural:

• Cashback pentru un anumit magazin ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
• Carduri cadou cu reducere pentru un anumit magazin ("best Gap gift card discount") → get_gift_cards_by_store_name
• De unde cumperi produsele unui brand cu cea mai mare economie ("best cashback on Adidas products") → get_best_deals_by_brand
• De unde cumperi un tip de produs cu cea mai mare economie ("cheapest dog food with cashback") → get_best_deals_by_category
• Bonusul de înscriere, plata minimă, calendarul sau metodele de plată ale unui portal → get_portals_by_name / get_portals
• Ce magazine oferă cashback într-o țară → get_stores_by_country

Menționează o țară când contează ("in Canada", "UK cashback"): asistentul transmite un cod de țară cu litere mici precum us, ca, gb (Regatul Unit) sau de, iar altfel caută în toate țările acceptate.

Asistenții folosesc direct aceste instrumente — nu trebuie niciodată să listeze mai întâi țări, magazine sau portaluri.

Instrumente disponibile

country_code este un cod ISO cu litere mici precum us, ca, gb (Regatul Unit) sau de; este opțional dacă nu este marcat ca obligatoriu. store_id, portal_id și ID-urile similare provin dintr-un rezultat anterior.

Linkuri urmărite în rezultate

Fiecare magazin, rată de cashback, card cadou și bonus de înscriere la un portal dintr-un rezultat include un link urmărit GotCashback (url, plus gift_cards_url unde este cazul). Cashback-ul este creditat, reducerile la cardurile cadou se aplică și bonusurile de înscriere sunt acordate doar dacă accesezi prin acele linkuri. Serverul instruiește clienții AI să le afișeze întotdeauna — dacă un asistent citează o rată fără link, cere-i linkul.

Instrumente de cont (autentificare opțională)

Autentificarea cu contul tău GotCashback (OAuth 2.1 — clientul tău AI ți-o va propune automat) deblochează instrumente suplimentare, specifice fiecărui utilizator. Toate instrumentele de comparare de mai sus funcționează și fără autentificare.

Alertele sunt aceleași pe care le gestionezi în Cont → Alerte pe site: alert_type este cashback sau gift_card, threshold_percent este între 1 și 100, resalvarea unei alerte existente îi actualizează pragul și o reactivează, iar fiecare cont poate avea cel mult 10 alerte active.

Cum funcționează autentificarea

1. Prima dată când folosești un instrument de cont, serverul răspunde cu o cerere de autorizare, iar clientul tău AI deschide pagina de autentificare GotCashback în browser — aceeași autentificare prin rețele sociale ca pe site. Nu este nevoie de înregistrare sau de cheie API.
2. Aprobă permisiunile solicitate (domeniile de acces) și revino în clientul tău. Apelul instrumentului se finalizează, iar conexiunea rămâne autentificată — clienții care solicită offline_access primesc refresh tokenuri, așa că nu ți se va mai cere din nou.
3. Pentru a te deconecta, elimină conectorul din clientul tău AI. Dacă ulterior un instrument raportează un domeniu de acces lipsă, elimină și adaugă din nou conectorul, astfel încât clientul să solicite autorizarea de la zero.

Endpointul serverului

https://mcp.gotcashback.com

Acesta este un server MCP la distanță (transport Streamable HTTP). Nu trebuie să instalezi sau să găzduiești nimic — doar îndreaptă un asistent AI compatibil către URL-ul de mai sus.

Pentru dezvoltatori și agenți AI

Serverul (versiunea 1.1.1) expune doar instrumente (fără resurse sau prompturi). Fiecare instrument are un titlu, o descriere care spune când să fie folosit, adnotări doar în citire și — pentru instrumentele de comparare — o schemă de ieșire publicată. Aceste endpointuri permit unui agent sau unei integrări să îl descopere și să se conecteze fără a citi această pagină:

Instrumentele de comparare returnează JSON-ul brut al API-ului ca text plus conținut structurat tipizat conform schemei lor de ieșire, astfel încât integrările pot citi magazinul, portalul, rata, „până la" și online/în magazin fără să ghicească. ID-urile necunoscute și căderile API-ului se întorc ca erori ale instrumentului, nu ca eșecuri de protocol.

• https://mcp.gotcashback.com — Endpoint MCP — Streamable HTTP, JSON-RPC prin POST, fără stare (nu este necesară afinitatea de sesiune)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — Fișa serverului MCP care descrie serverul, transportul și autentificarea (servită și pe acest site)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — Metadate OAuth ale resursei protejate: domeniile de acces acceptate și serverul de autorizare
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Metadatele serverului de autorizare — flux cu cod de autorizare cu PKCE, înregistrare dinamică a clienților (publici și confidențiali), refresh tokenuri
• https://www.gotcashback.com/auth.md — Politica de autentificare a agenților
• https://www.gotcashback.com/llms.txt — Index al site-ului care poate fi citit de agenți
• https://api.gotcashback.com/swagger/ — API-ul REST gratuit din spatele instrumentelor (specificație OpenAPI, fără cheie)
• https://mcp.gotcashback.com/health — Verificare de stare

CORS este deschis pentru orice origine, astfel încât agenții care rulează în browser se pot conecta direct; anteturile de răspuns Mcp-Session-Id și WWW-Authenticate sunt expuse.

Întrebări sau probleme?

Dacă o conexiune eșuează sau un apel de instrument returnează o eroare, verifică dacă URL-ul este introdus exact ca https://mcp.gotcashback.com, fără vreo cale la final. Dacă un instrument de cont îți cere în continuare să te autentifici, elimină și adaugă din nou conectorul. Pentru ajutor suplimentar, contactează suportul GotCashback.