GotCashback MCP Server

Połącz Claude, ChatGPT i innych asystentów AI zgodnych z MCP bezpośrednio z aktualnymi stawkami cashback GotCashback (online i w sklepach stacjonarnych, we wszystkich portalach cashback), porównaniami portali i warunkami wypłat, danymi sklepów i ofertami kart podarunkowych — odświeżanymi kilka razy dziennie.

GotCashback.pl porównuje stawki cashback 110 portali cashback w 41 krajach na całym świecie (liczba portali w Polsce: 12, sklepów: 3 433). Założony w 2020 r.; operator: MNP Enterprises, LLC.

Czym jest MCP?

Model Context Protocol (MCP) to otwarty standard, który pozwala asystentom AI wywoływać zewnętrzne narzędzia i pobierać aktualne dane w trakcie rozmowy. Zamiast zgadywać stawki cashback na podstawie nieaktualnych danych treningowych, AI może bezpośrednio odpytać serwer GotCashback i otrzymać dzisiejsze liczby.

Instrukcja instalacji

Claude (claude.ai / Claude Desktop)

1. Otwórz „Ustawienia → Konektory” (w Claude Desktop: „Ustawienia → Konektory”; na claude.ai: ikona konektorów w czacie).
2. Kliknij „Dodaj niestandardowy konektor”.
3. Wprowadź adres URL: https://mcp.gotcashback.com
4. Nadaj mu nazwę (np. „GotCashback”) i zapisz.
5. Włącz konektor w dowolnej rozmowie, w której chcesz sprawdzać cashback — Claude będzie wywoływać narzędzia automatycznie, gdy będzie to potrzebne.

Claude Code (terminal)

Dodaj serwer jednym poleceniem:

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

Uruchom /mcp w Claude Code, aby sprawdzić połączenie i zalogować się, gdy potrzebujesz narzędzi konta.

ChatGPT

1. Otwórz „Ustawienia → Konektory” (dostępne w planach obsługujących niestandardowe konektory / konektory deweloperskie).
2. Wybierz dodanie niestandardowego konektora i wprowadź adres URL serwera: https://mcp.gotcashback.com
3. Postępuj zgodnie z instrukcjami, aby go autoryzować i włączyć do użytku w czacie lub w konfiguracji niestandardowego GPT.

VS Code (tryb agenta GitHub Copilot)

Uruchom „MCP: Add Server” z palety poleceń lub dodaj to do pliku .vscode/mcp.json:

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

Inne klienty zgodne z MCP (Cursor, Windsurf itp.)

Większość klientów MCP przyjmuje konfigurację JSON wskazującą zdalny serwer. Typowy wpis wygląda tak:

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

Lokalizację tego pliku konfiguracyjnego znajdziesz w dokumentacji swojego klienta (np. ~/.cursor/mcp.json dla Cursor) — adres URL i struktura powyżej są takie same w większości klientów, ponieważ wszystkie stosują tę samą specyfikację MCP.

Przykładowe zapytania po połączeniu

• "Jaka jest teraz najlepsza stawka cashback dla Best Buy?"
• "Czy są przecenione karty podarunkowe Target?"
• "What's the best cashback rate for Walmart in Canada?"
• "Compare gift card discounts for Home Depot."
• "Które portale cashback są dostępne w Wielkiej Brytanii?"
• "Gdzie kupić produkty Adidas z najlepszym cashbackiem?"
• "Gdzie kupić karmę dla psa z największą zniżką?"
• "Które brytyjskie portale cashback wypłacają przez PayPal i który z nich ma najniższą minimalną kwotę wypłaty?"
• "Czy TopCashback oferuje bonus za rejestrację i jak często wypłaca pieniądze?"
• "Powiadom mnie, gdy stawka cashback w Nike osiągnie 10%."
• "Dodaj Best Buy do moich ulubionych sklepów."

Dwa ostatnie przykłady korzystają z opcjonalnych narzędzi konta i poproszą Cię o zalogowanie się kontem GotCashback.

Wolisz rozmawiać w Telegramie? Wypróbuj bota Telegram GotCashback

Co robi serwer MCP GotCashback

Po połączeniu asystent AI może porównać aktualne stawki cashback sklepu online i stacjonarnie we wszystkich portalach, znaleźć przecenione karty podarunkowe, uszeregować sklepy oferujące markę lub kategorię zakupową według najlepszej oferty, przeglądać sklepy według kraju i sprawdzić warunki wypłat każdego portalu (bonus za rejestrację, minimalna wypłata, częstotliwość wypłat, metody płatności). Serwer informuje asystenta, które narzędzie odpowiada na jaki rodzaj pytania, więc zwykłe pytanie w rodzaju "best cashback for Walmart" trafia od razu do właściwego wyszukiwania. Stawki są odświeżane kilka razy dziennie.

Jak asystent wybiera narzędzie

Serwer informuje podłączonych asystentów, które narzędzie odpowiada na które pytanie, więc możesz pytać naturalnie:

• Cashback dla konkretnego sklepu ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
• Przecenione karty podarunkowe dla konkretnego sklepu ("best Gap gift card discount") → get_gift_cards_by_store_name
• Gdzie kupić produkty marki z największą oszczędnością ("best cashback on Adidas products") → get_best_deals_by_brand
• Gdzie kupić dany rodzaj produktu z największą oszczędnością ("cheapest dog food with cashback") → get_best_deals_by_category
• Bonus za rejestrację, minimalna wypłata, harmonogram lub metody wypłat portalu → get_portals_by_name / get_portals
• Które sklepy oferują cashback w danym kraju → get_stores_by_country

Wskaż kraj, gdy ma to znaczenie ("in Canada", "UK cashback"): asystent przekazuje kod kraju małymi literami, np. us, ca, gb (Wielka Brytania) lub de, a w przeciwnym razie przeszukuje wszystkie obsługiwane kraje.

Asystenci sięgają po te narzędzia bezpośrednio — nigdy nie muszą najpierw wypisywać krajów, sklepów ani portali.

Dostępne narzędzia

country_code to kod ISO małymi literami, np. us, ca, gb (Wielka Brytania) lub de; jest opcjonalny, chyba że oznaczono go jako wymagany. store_id, portal_id i podobne identyfikatory pochodzą z wcześniejszego wyniku.

Śledzone linki w wynikach

Każdy sklep, stawka cashback, karta podarunkowa i bonus za rejestrację w portalu w wynikach ma śledzony link GotCashback (url, a tam, gdzie to dotyczy, także gift_cards_url). Cashback jest naliczany, zniżki na karty podarunkowe obowiązują, a bonusy za rejestrację są przyznawane tylko po przejściu przez te linki. Serwer instruuje klientów AI, aby zawsze je pokazywali — jeśli asystent podaje stawkę bez linku, poproś go o link.

Narzędzia konta (opcjonalne logowanie)

Zalogowanie się kontem GotCashback (OAuth 2.1 — Twój klient AI zaproponuje je automatycznie) odblokowuje dodatkowe narzędzia osobiste. Wszystkie powyższe narzędzia porównawcze działają dalej bez logowania.

To te same alerty, którymi zarządzasz w sekcji „Konto → Alerty” na stronie: alert_type to cashback lub gift_card, threshold_percent mieści się w zakresie od 1 do 100, ponowne zapisanie istniejącego alertu aktualizuje jego próg i uzbraja go na nowo, a każde konto może mieć maksymalnie 10 aktywnych alertów.

Jak działa logowanie

1. Przy pierwszym użyciu narzędzia konta serwer odpowiada żądaniem autoryzacji, a Twój klient AI otwiera w przeglądarce stronę logowania GotCashback — to samo logowanie społecznościowe co na stronie. Rejestracja ani klucz API nie są potrzebne.
2. Zatwierdź żądane uprawnienia (zakresy) i wróć do klienta. Wywołanie narzędzia zostanie ukończone, a połączenie pozostanie zalogowane — klienci żądający offline_access otrzymują tokeny odświeżania, więc nie zostaniesz ponownie poproszony o logowanie.
3. Aby się rozłączyć, usuń konektor ze swojego klienta AI. Jeśli narzędzie zgłosi później brakujący zakres, usuń konektor i dodaj go ponownie, aby klient na nowo zażądał autoryzacji.

Adres serwera

https://mcp.gotcashback.com

To zdalny serwer MCP (transport Streamable HTTP). Niczego nie trzeba instalować ani hostować — wystarczy wskazać zgodnemu asystentowi AI powyższy adres URL.

Dla deweloperów i agentów AI

Serwer (wersja 1.1.0) udostępnia wyłącznie narzędzia (bez zasobów i promptów). Każde narzędzie ma tytuł, opis mówiący, kiedy go użyć, adnotacje tylko do odczytu oraz — w przypadku narzędzi porównawczych — opublikowany schemat wyjścia. Te punkty końcowe pozwalają agentowi lub integracji odnaleźć serwer i połączyć się z nim bez czytania tej strony:

Narzędzia porównawcze zwracają surowy JSON API jako tekst oraz typowaną treść strukturalną zgodną ze schematem wyjścia, dzięki czemu integracje mogą odczytać sklep, portal, stawkę, „do" oraz online/stacjonarnie bez zgadywania. Nieznane identyfikatory i awarie API wracają jako błędy narzędzia, a nie błędy protokołu.

• https://mcp.gotcashback.com — Punkt końcowy MCP — Streamable HTTP, JSON-RPC przez POST, bezstanowy (nie wymaga powiązania z sesją)
• https://mcp.gotcashback.com/.well-known/mcp/server-card.json — Karta serwera MCP opisująca serwer, transport i uwierzytelnianie (dostępna także na tej stronie)
• https://mcp.gotcashback.com/.well-known/oauth-protected-resource — Metadane chronionego zasobu OAuth: obsługiwane zakresy i serwer autoryzacji
• https://www.gotcashback.com/.well-known/oauth-authorization-server — Metadane serwera autoryzacji — authorization code flow z PKCE, dynamiczna rejestracja klientów (publicznych i poufnych), tokeny odświeżania
• https://www.gotcashback.com/auth.md — Polityka uwierzytelniania agentów
• https://www.gotcashback.com/llms.txt — Indeks strony czytelny dla agentów
• https://api.gotcashback.com/swagger/ — Bezpłatne REST API stojące za narzędziami (specyfikacja OpenAPI, klucz nie jest wymagany)
• https://mcp.gotcashback.com/health — Kontrola stanu

CORS jest otwarty dla dowolnego źródła, więc agenci działający w przeglądarce mogą łączyć się bezpośrednio; nagłówki odpowiedzi Mcp-Session-Id i WWW-Authenticate są udostępniane.

Pytania lub problemy?

Jeśli połączenie się nie powiedzie lub wywołanie narzędzia zakończy się błędem, upewnij się, że adres URL wpisano dokładnie jako https://mcp.gotcashback.com bez dodatkowej ścieżki na końcu. Jeśli narzędzie konta wciąż prosi o zalogowanie, usuń konektor i dodaj go ponownie. Po dalszą pomoc skontaktuj się z pomocą techniczną GotCashback.