Server MCP GotCashback
Collega Claude, ChatGPT e altri assistenti IA compatibili con MCP direttamente ai tassi di cashback attuali di GotCashback (online e in negozio, su tutti i portali di cashback), ai confronti tra portali e alle condizioni di pagamento, ai dati dei negozi e alle offerte di gift card — aggiornati più volte al giorno.
it.GotCashback.com confronta le tariffe cashback di 113 portali cashback in 42 paesi nel mondo, di cui 8 portali e 4.027 negozi in Italia. Fondato nel 2020; gestito da MNP Enterprises, LLC.
Che cos'è MCP?
Il Model Context Protocol (MCP) è uno standard aperto che consente agli assistenti IA di richiamare strumenti esterni e recuperare dati attuali durante una conversazione. Invece di indovinare i tassi di cashback da dati di addestramento obsoleti, un'IA può interrogare direttamente il server di GotCashback e ottenere i numeri di oggi.
Istruzioni di installazione
Claude (claude.ai / Claude Desktop)
- Apri Impostazioni → Connettori (in Claude Desktop: Impostazioni → Connettori; su claude.ai: l'icona dei connettori in una chat).
- Clicca su "Aggiungi connettore personalizzato".
- Inserisci l'URL:
https://mcp.gotcashback.com - Assegnagli un nome (es. "GotCashback") e salva.
- Attiva il connettore in qualsiasi conversazione in cui vuoi effettuare ricerche di cashback — Claude richiamerà automaticamente gli strumenti quando è pertinente.
Claude Code (terminale)
Aggiungi il server con un solo comando:
claude mcp add --transport http gotcashback https://mcp.gotcashback.comEsegui /mcp all'interno di Claude Code per verificare la connessione e per accedere quando vuoi usare gli strumenti per l'account.
ChatGPT
- Apri Impostazioni → Connettori (disponibile nei piani che supportano i connettori personalizzati/per sviluppatori).
- Scegli di aggiungere un connettore personalizzato e inserisci l'URL del server:
https://mcp.gotcashback.com - Segui le istruzioni per autorizzarlo e attivarlo nella chat o nella configurazione di un GPT personalizzato.
VS Code (modalità agente di GitHub Copilot)
Esegui "MCP: Add Server" dalla palette dei comandi, oppure aggiungi questo a .vscode/mcp.json:
{
"servers": {
"gotcashback": {
"type": "http",
"url": "https://mcp.gotcashback.com"
}
}
}Altri client compatibili con MCP (Cursor, Windsurf, ecc.)
La maggior parte dei client MCP accetta una configurazione JSON che punta a un server remoto. Una voce tipica è simile a questa:
{
"mcpServers": {
"gotcashback": {
"url": "https://mcp.gotcashback.com"
}
}
}Consulta la documentazione del tuo client per sapere dove si trova questo file di configurazione (es. ~/.cursor/mcp.json per Cursor) — l'URL e la struttura qui sopra sono gli stessi per la maggior parte dei client, poiché seguono la stessa specifica MCP.
Esempi di richieste una volta connesso
- "Qual è la miglior percentuale di cashback per Best Buy in questo momento?"
- "Ci sono carte regalo scontate per Target?"
- "What's the best cashback rate for Walmart in Canada?"
- "Compare gift card discounts for Home Depot."
- "Quali portali di cashback sono disponibili nel Regno Unito?"
- "Dove posso acquistare prodotti Adidas con il miglior cashback?"
- "Dove posso acquistare cibo per cani con lo sconto più alto?"
- "Quali portali di cashback del Regno Unito pagano tramite PayPal e quale ha il pagamento minimo più basso?"
- "TopCashback offre un bonus di iscrizione e con quale frequenza paga?"
- "Avvisami quando la percentuale di cashback di Nike raggiunge il 10%."
- "Aggiungi Best Buy ai miei negozi preferiti."
Gli ultimi due usano gli strumenti per l'account facoltativi e ti chiederanno di accedere con il tuo account GotCashback.
Preferisci chattare su Telegram? Prova il bot Telegram GotCashback
Cosa fa il server MCP GotCashback
Una volta collegato, un assistente IA può confrontare i tassi di cashback attuali online e in negozio di un negozio su tutti i portali, trovare gift card scontate, ordinare i negozi che trattano un marchio o una categoria di acquisto in base alla migliore offerta, sfogliare i negozi per paese e consultare le condizioni di pagamento di ogni portale (bonus di iscrizione, pagamento minimo, frequenza di pagamento, metodi di pagamento). Il server indica all'assistente quale strumento risponde a quale tipo di domanda, così una domanda semplice come "best cashback for Walmart" arriva direttamente alla ricerca giusta. I tassi vengono aggiornati più volte al giorno.
Come un assistente sceglie lo strumento
Il server indica agli assistenti collegati quale strumento risponde a quale domanda, quindi puoi chiedere in modo naturale:
- Cashback per un negozio specifico ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") →
get_cashback_rates_by_store_name - Gift card scontate per un negozio specifico ("best Gap gift card discount") →
get_gift_cards_by_store_name - Dove acquistare i prodotti di un marchio con il massimo risparmio ("best cashback on Adidas products") →
get_best_deals_by_brand - Dove acquistare un tipo di prodotto con il massimo risparmio ("cheapest dog food with cashback") →
get_best_deals_by_category - Bonus di iscrizione, pagamento minimo, calendario dei pagamenti o metodi di pagamento di un portale →
get_portals_by_name/get_portals - Quali negozi offrono cashback in un paese →
get_stores_by_country
Indica un paese quando è rilevante ("in Canada", "UK cashback"): l'assistente passa un codice paese in minuscolo come us, ca, gb (Regno Unito) o de e altrimenti cerca in tutti i paesi supportati.
Gli assistenti usano direttamente questi strumenti — non devono mai elencare prima paesi, negozi o portali.
Strumenti disponibili
| Strumento | Cosa fa | Input principali |
|---|---|---|
get_cashback_rates_by_store_name | Confronta i tassi di cashback attuali online e in negozio di un negozio su tutti i portali in base al nome — la risposta diretta a "best cashback for Walmart" | store_name, country_code (optional) |
get_cashback_rates_by_store_id | Lo stesso, quando l'ID del negozio è già noto da un risultato precedente | store_id |
get_gift_cards_by_store_name | Trova le gift card scontate di un negozio in base al nome e confronta gli sconti | store_name, country_code (optional) |
get_gift_cards_by_store_id | Lo stesso, quando l'ID del negozio è già noto | store_id |
get_best_deals_by_brand | Classifica i negozi che vendono un marchio in base alla miglior percentuale di cashback e al miglior sconto sulle carte regalo | brand_name, country_code (optional) |
get_best_deals_by_category | Idem per una categoria di acquisto (es. "Pet Supplies") | category_name, country_code (optional) |
get_stores_by_name | Trova ID, paese e link della pagina di un negozio (senza tassi) | store_name, country_code (optional) |
get_stores_by_country | Sfoglia tutti i negozi con cashback in un paese — solo ID e link dei negozi, senza tassi; l'elenco può essere lungo | country_code |
get_portals | Elenca i portali di cashback con le condizioni di pagamento (bonus di iscrizione, pagamento minimo, frequenza di pagamento, metodi di pagamento), facoltativamente per paese — non i tassi dei negozi | country_code (optional) |
get_portals_by_name | Cerca i portali per nome e restituisce le loro condizioni di pagamento — non i tassi dei negozi | portal_name, country_code (optional) |
get_portal_by_id | Recupera un portale specifico tramite ID con le sue condizioni di pagamento | portal_id |
get_countries | Elenca i paesi supportati e i relativi codici (il Regno Unito è gb) | — |
country_code è un codice ISO in minuscolo come us, ca, gb (Regno Unito) o de ed è facoltativo salvo dove indicato come obbligatorio. store_id, portal_id e ID simili provengono da un risultato precedente.
Link tracciati nei risultati
Ogni negozio, percentuale di cashback, carta regalo e bonus di iscrizione a un portale presente in un risultato include un link tracciato GotCashback (url, più gift_cards_url dove pertinente). Il cashback viene accreditato, gli sconti sulle carte regalo vengono applicati e i bonus di iscrizione vengono concessi solo se clicchi su quei link. Il server indica ai client AI di mostrarli sempre — se un assistente cita una percentuale senza link, chiedigli il link.
Strumenti per l'account (accesso facoltativo)
L'accesso con il tuo account GotCashback (OAuth 2.1 — il tuo client AI te lo proporrà automaticamente) sblocca ulteriori strumenti personali. Tutti gli strumenti di confronto qui sopra continuano a funzionare senza accedere.
| Strumento | Cosa fa | Input principali | Ambito |
|---|---|---|---|
get_my_profile | Restituisce il tuo profilo GotCashback (nome, e-mail, avatar) | — | profile |
get_my_favorite_stores | Elenca i tuoi negozi preferiti | — | favorites |
toggle_favorite_store | Aggiunge o rimuove un negozio dai tuoi preferiti | store_id, favorite | favorites |
get_my_alerts | Elenca i tuoi avvisi su cashback e carte regalo (negozio, tipo, soglia, ultima notifica) | — | alerts |
set_store_alert | Crea o aggiorna un avviso che ti invia un'e-mail quando la percentuale di cashback o lo sconto sulla carta regalo di un negozio raggiunge o supera la percentuale di soglia | store_id, alert_type, threshold_percent | alerts |
remove_store_alert | Rimuove un avviso per un negozio | store_id, alert_type | alerts |
Gli avvisi sono gli stessi che gestisci in Account → Avvisi sul sito: alert_type è cashback o gift_card, threshold_percent è compreso tra 1 e 100, salvare di nuovo un avviso esistente ne aggiorna la soglia e lo riattiva, e ogni account può avere al massimo 10 avvisi attivi.
Come funziona l'accesso
- La prima volta che usi uno strumento per l'account, il server risponde con una richiesta di autorizzazione e il tuo client AI apre la pagina di accesso di GotCashback nel browser — lo stesso login social del sito. Non servono registrazione né chiave API.
- Approva le autorizzazioni richieste (ambiti) e torna al tuo client. La chiamata allo strumento viene completata e la connessione resta autenticata — i client che richiedono offline_access ricevono refresh token, quindi non ti verrà chiesto di nuovo.
- Per disconnetterti, rimuovi il connettore dal tuo client AI. Se in seguito uno strumento segnala un ambito mancante, rimuovi e aggiungi di nuovo il connettore in modo che il client richieda nuovamente l'autorizzazione.
| Ambito | Cosa concede |
|---|---|
profile | Leggere nome, e-mail e avatar |
favorites | Leggere e modificare i tuoi negozi preferiti |
alerts | Leggere, creare e rimuovere i tuoi avvisi su cashback e carte regalo |
offline_access | Refresh token affinché la connessione resti autenticata |
Endpoint del server
https://mcp.gotcashback.com
Si tratta di un server MCP remoto (trasporto Streamable HTTP). Non devi installare né ospitare nulla — basta puntare un assistente AI compatibile all'URL qui sopra.
Per sviluppatori e agenti AI
Il server (versione 1.1.1) espone solo strumenti (nessuna risorsa o prompt). Ogni strumento ha un titolo, una descrizione che indica quando usarlo, annotazioni di sola lettura e — per gli strumenti di confronto — uno schema di output pubblicato. Questi endpoint permettono a un agente o a un'integrazione di scoprirlo e collegarsi senza leggere questa pagina:
Gli strumenti di confronto restituiscono il JSON grezzo dell'API come testo più contenuto strutturato tipizzato conforme al loro schema di output, così le integrazioni possono leggere negozio, portale, tasso, "fino a" e online/in negozio senza tirare a indovinare. ID sconosciuti e interruzioni dell'API tornano come errori dello strumento, non come errori di protocollo.
https://mcp.gotcashback.com— Endpoint MCP — Streamable HTTP, JSON-RPC via POST, stateless (nessuna affinità di sessione richiesta)https://mcp.gotcashback.com/.well-known/mcp/server-card.json— Scheda del server MCP che descrive server, trasporto e autenticazione (servita anche su questo sito)https://mcp.gotcashback.com/.well-known/oauth-protected-resource— Metadati OAuth della risorsa protetta: ambiti supportati e server di autorizzazionehttps://www.gotcashback.com/.well-known/oauth-authorization-server— Metadati del server di autorizzazione — flusso authorization code con PKCE, registrazione dinamica dei client (pubblici e confidenziali), refresh tokenhttps://www.gotcashback.com/auth.md— Politica di autenticazione per gli agentihttps://www.gotcashback.com/llms.txt— Indice del sito leggibile dagli agentihttps://api.gotcashback.com/swagger/— L'API REST gratuita dietro gli strumenti (specifica OpenAPI, nessuna chiave richiesta)https://mcp.gotcashback.com/health— Controllo di stato
CORS è aperto a qualsiasi origine, quindi gli agenti basati su browser possono connettersi direttamente; gli header di risposta Mcp-Session-Id e WWW-Authenticate sono esposti.
Domande o problemi?
Se una connessione non riesce o la chiamata a uno strumento restituisce un errore, verifica che l'URL sia inserito esattamente come https://mcp.gotcashback.com, senza percorsi finali. Se uno strumento per l'account continua a chiederti di accedere, rimuovi e aggiungi di nuovo il connettore. Per ulteriore assistenza, contatta il supporto GotCashback.