Servidor MCP do GotCashback

Conecte Claude, ChatGPT e outros assistentes de IA compatíveis com MCP diretamente às taxas de cashback atuais da GotCashback (online e em loja, em todos os portais de cashback), às comparações de portais e condições de pagamento, aos dados das lojas e às ofertas de gift cards — atualizados várias vezes ao dia.

br.GotCashback.com compara taxas de cashback de 113 portais de cashback em 42 países no mundo todo, incluindo 5 portais e 1.155 lojas no Brasil. Fundado em 2020; operado por MNP Enterprises, LLC.

O que é MCP?

O Model Context Protocol (MCP) é um padrão aberto que permite aos assistentes de IA chamar ferramentas externas e buscar dados atuais durante uma conversa. Em vez de chutar taxas de cashback a partir de dados de treinamento desatualizados, uma IA pode consultar diretamente o servidor da GotCashback e obter os números de hoje.

Instruções de instalação

Claude (claude.ai / Claude Desktop)

Abra Configurações → Conectores (no Claude Desktop: Configurações → Conectores; no claude.ai: o ícone de conectores em um chat).
Clique em "Adicionar conector personalizado".
Informe a URL: https://mcp.gotcashback.com
Dê um nome a ele (ex.: "GotCashback") e salve.
Ative o conector em qualquer conversa em que você queira consultas de cashback — o Claude chamará as ferramentas automaticamente quando for relevante.

Claude Code (terminal)

Adicione o servidor com um único comando:

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

Execute /mcp dentro do Claude Code para verificar a conexão e para fazer login quando quiser usar as ferramentas de conta.

ChatGPT

Abra Configurações → Conectores (disponível nos planos que oferecem conectores personalizados/de desenvolvedor).
Escolha adicionar um conector personalizado e informe a URL do servidor: https://mcp.gotcashback.com
Siga as instruções para autorizá-lo e ativá-lo no chat ou na configuração de um GPT personalizado.

O suporte a conectores do ChatGPT vem sendo liberado em etapas e a disponibilidade varia conforme o plano. Se você não vir a opção "conector personalizado" ou "modo desenvolvedor", consulte a documentação atual da OpenAI para o seu tipo de conta.

VS Code (modo agente do GitHub Copilot)

Execute "MCP: Add Server" na paleta de comandos ou adicione isto ao .vscode/mcp.json:

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

Outros clientes compatíveis com MCP (Cursor, Windsurf etc.)

A maioria dos clientes MCP aceita uma configuração JSON que aponta para um servidor remoto. Uma entrada típica é assim:

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

Consulte a documentação do seu cliente para saber onde fica esse arquivo de configuração (ex.: ~/.cursor/mcp.json para o Cursor) — a URL e a estrutura acima são as mesmas na maioria dos clientes, já que seguem a mesma especificação MCP.

Exemplos de perguntas depois de conectar

"Qual é a melhor taxa de cashback da Best Buy agora?"
"Existem cartões-presente com desconto da Target?"
"What's the best cashback rate for Walmart in Canada?"
"Compare gift card discounts for Home Depot."
"Quais portais de cashback estão disponíveis no Reino Unido?"
"Onde posso comprar produtos Adidas com o melhor cashback?"
"Onde posso comprar ração para cachorro com o maior desconto?"
"Quais portais de cashback do Reino Unido pagam via PayPal, e qual tem o menor pagamento mínimo?"
"A TopCashback oferece bônus de cadastro, e com que frequência ela paga?"
"Me avise quando a taxa de cashback da Nike chegar a 10%."
"Adicione a Best Buy às minhas lojas favoritas."

Os dois últimos usam as ferramentas de conta opcionais e vão pedir que você faça login com sua conta do GotCashback.

Prefere conversar no Telegram? Experimente o bot do Telegram do GotCashback

O que o servidor MCP do GotCashback faz

Depois de conectado, um assistente de IA pode comparar as taxas de cashback atuais online e em loja de uma loja em todos os portais, encontrar gift cards com desconto, classificar as lojas que vendem uma marca ou categoria de compra pela melhor oferta, navegar pelas lojas por país e consultar as condições de pagamento de cada portal (bônus de cadastro, pagamento mínimo, frequência de pagamento, formas de pagamento). O servidor informa ao assistente qual ferramenta responde a cada tipo de pergunta, então uma pergunta simples como "best cashback for Walmart" vai direto para a consulta certa. As taxas são atualizadas várias vezes ao dia.

Como um assistente escolhe a ferramenta

O servidor informa aos assistentes conectados qual ferramenta responde a cada pergunta, então você pode perguntar naturalmente:

Cashback de uma loja específica ("best cashback for Walmart", "Best Buy in-store cashback", "compare Expedia cashback portals") → get_cashback_rates_by_store_name
Gift cards com desconto de uma loja específica ("best Gap gift card discount") → get_gift_cards_by_store_name
Onde comprar os produtos de uma marca com a maior economia ("best cashback on Adidas products") → get_best_deals_by_brand
Onde comprar um tipo de produto com a maior economia ("cheapest dog food with cashback") → get_best_deals_by_category
O bônus de cadastro, o pagamento mínimo, o cronograma ou as formas de pagamento de um portal → get_portals_by_name / get_portals
Quais lojas oferecem cashback em um país → get_stores_by_country

Mencione um país quando isso importar ("in Canada", "UK cashback"): o assistente envia um código de país em minúsculas como us, ca, gb (Reino Unido) ou de e, caso contrário, pesquisa em todos os países suportados.

Os assistentes vão direto para essas ferramentas — nunca precisam listar antes países, lojas ou portais.

Ferramentas disponíveis

Ferramenta	O que faz	Entradas principais
`get_cashback_rates_by_store_name`	Compara as taxas de cashback atuais online e em loja de uma loja em todos os portais pelo nome — a resposta direta para "best cashback for Walmart"	store_name, country_code (optional)
`get_cashback_rates_by_store_id`	O mesmo, quando o ID da loja já é conhecido de um resultado anterior	store_id
`get_gift_cards_by_store_name`	Encontra gift cards com desconto de uma loja pelo nome e compara os descontos	store_name, country_code (optional)
`get_gift_cards_by_store_id`	O mesmo, quando o ID da loja já é conhecido	store_id
`get_best_deals_by_brand`	Classifica as lojas que vendem uma marca pela melhor taxa de cashback e pelo melhor desconto em cartões-presente	brand_name, country_code (optional)
`get_best_deals_by_category`	Igual para uma categoria de compras (ex.: "Pet Supplies")	category_name, country_code (optional)
`get_stores_by_name`	Encontra o ID, o país e o link da página de uma loja (sem taxas)	store_name, country_code (optional)
`get_stores_by_country`	Navega por todas as lojas com cashback em um país — apenas IDs e links das lojas, sem taxas; a lista pode ser longa	country_code
`get_portals`	Lista os portais de cashback com as condições de pagamento (bônus de cadastro, pagamento mínimo, frequência de pagamento, formas de pagamento), opcionalmente por país — não as taxas das lojas	country_code (optional)
`get_portals_by_name`	Busca portais pelo nome e retorna suas condições de pagamento — não as taxas das lojas	portal_name, country_code (optional)
`get_portal_by_id`	Obtém um portal específico por ID com suas condições de pagamento	portal_id
`get_countries`	Lista os países suportados e seus códigos (o Reino Unido é gb)	—

country_code é um código ISO em minúsculas como us, ca, gb (Reino Unido) ou de; é opcional, salvo quando indicado como obrigatório. store_id, portal_id e IDs semelhantes vêm de um resultado anterior.

Links rastreados nos resultados

Cada loja, taxa de cashback, cartão-presente e bônus de cadastro de portal em um resultado traz um link rastreado do GotCashback (url, além de gift_cards_url quando aplicável). O cashback só é creditado, os descontos em cartões-presente só valem e os bônus de cadastro só são concedidos quando você acessa por esses links. O servidor instrui os clientes de IA a sempre exibi-los — se um assistente citar uma taxa sem link, peça o link a ele.

Ferramentas de conta (login opcional)

Entrar com sua conta do GotCashback (OAuth 2.1 — seu cliente de IA vai oferecer isso automaticamente) desbloqueia ferramentas adicionais por usuário. Todas as ferramentas de comparação acima continuam funcionando sem login.

Ferramenta	O que faz	Entradas principais	Escopo
`get_my_profile`	Retorna seu perfil do GotCashback (nome, e-mail, avatar)	—	`profile`
`get_my_favorite_stores`	Lista suas lojas favoritas	—	`favorites`
`toggle_favorite_store`	Adiciona ou remove uma loja dos seus favoritos	store_id, favorite	`favorites`
`get_my_alerts`	Lista seus alertas de cashback e de cartões-presente (loja, tipo, limite, última notificação)	—	`alerts`
`set_store_alert`	Cria ou atualiza um alerta que envia um e-mail para você quando a taxa de cashback ou o desconto em cartão-presente de uma loja atinge ou supera o percentual limite	store_id, alert_type, threshold_percent	`alerts`
`remove_store_alert`	Remove um alerta de uma loja	store_id, alert_type	`alerts`

Os alertas são os mesmos que você gerencia em Conta → Alertas no site: alert_type é cashback ou gift_card, threshold_percent fica entre 1 e 100, salvar novamente um alerta existente atualiza seu limite e o reativa, e cada conta pode ter no máximo 10 alertas ativos.

Como funciona o login

Na primeira vez que você usa uma ferramenta de conta, o servidor responde com um pedido de autorização e seu cliente de IA abre a página de login do GotCashback no navegador — o mesmo login social do site. Não é preciso cadastro nem chave de API.
Aprove as permissões solicitadas (escopos) e volte ao seu cliente. A chamada da ferramenta é concluída e a conexão permanece logada — clientes que solicitam offline_access recebem refresh tokens, então você não será solicitado novamente.
Para desconectar, remova o conector do seu cliente de IA. Se mais tarde uma ferramenta informar que falta um escopo, remova e adicione o conector novamente para que o cliente solicite a autorização de novo.

Escopo	O que concede
`profile`	Ler seu nome, e-mail e avatar
`favorites`	Ler e alterar suas lojas favoritas
`alerts`	Ler, criar e remover seus alertas de cashback e de cartões-presente
`offline_access`	Refresh tokens para que a conexão permaneça logada

Endpoint do servidor

https://mcp.gotcashback.com

Este é um servidor MCP remoto (transporte Streamable HTTP). Você não precisa instalar nem hospedar nada — basta apontar um assistente de IA compatível para a URL acima.

Para desenvolvedores e agentes de IA

O servidor (versão 1.1.1) expõe apenas ferramentas (sem recursos ou prompts). Cada ferramenta tem um título, uma descrição que diz quando usá-la, anotações somente leitura e — nas ferramentas de comparação — um esquema de saída publicado. Estes endpoints permitem que um agente ou integração o descubra e se conecte sem ler esta página:

As ferramentas de comparação retornam o JSON bruto da API como texto mais conteúdo estruturado tipado conforme seu esquema de saída, para que as integrações leiam loja, portal, taxa, "até" e online/em loja sem adivinhar. IDs desconhecidos e quedas da API voltam como erros de ferramenta, não como falhas de protocolo.

https://mcp.gotcashback.com — Endpoint MCP — Streamable HTTP, JSON-RPC via POST, sem estado (não precisa de afinidade de sessão)
https://mcp.gotcashback.com/.well-known/mcp/server-card.json — Cartão do servidor MCP descrevendo o servidor, o transporte e a autenticação (também servido neste site)
https://mcp.gotcashback.com/.well-known/oauth-protected-resource — Metadados OAuth do recurso protegido: escopos suportados e servidor de autorização
https://www.gotcashback.com/.well-known/oauth-authorization-server — Metadados do servidor de autorização — fluxo de código de autorização com PKCE, registro dinâmico de clientes (públicos e confidenciais), refresh tokens
https://www.gotcashback.com/auth.md — Política de autenticação de agentes
https://www.gotcashback.com/llms.txt — Índice do site legível por agentes
https://api.gotcashback.com/swagger/ — A API REST gratuita por trás das ferramentas (especificação OpenAPI, sem necessidade de chave)
https://mcp.gotcashback.com/health — Verificação de integridade

O CORS está aberto para qualquer origem, então agentes baseados em navegador podem se conectar diretamente; os cabeçalhos de resposta Mcp-Session-Id e WWW-Authenticate são expostos.

Dúvidas ou problemas?

Se uma conexão falhar ou uma chamada de ferramenta retornar erro, confira se a URL foi informada exatamente como https://mcp.gotcashback.com, sem nenhum caminho no final. Se uma ferramenta de conta continuar pedindo para você fazer login, remova e adicione o conector novamente. Para mais ajuda, entre em contato com o suporte do GotCashback.