Servidor MCP da GotCashback

Ligue o Claude, o 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 cartões-presente — atualizados várias vezes por dia.

pt.GotCashback.com compara taxas de cashback de 113 portais de cashback em 42 países em todo o mundo, incluindo 2 portais e 774 lojas em Portugal. Fundado em 2020; operado por MNP Enterprises, LLC.

O que é o MCP?

O Model Context Protocol (MCP) é uma norma aberta que permite aos assistentes de IA chamar ferramentas externas e obter dados atuais durante uma conversa. Em vez de adivinhar taxas de cashback a partir de dados de treino 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 Definições → Conectores (no Claude Desktop: Definições → Conectores; em claude.ai: o ícone de conectores numa conversa).
Clique em "Adicionar conector personalizado".
Introduza o URL: https://mcp.gotcashback.com
Dê-lhe um nome (p. ex., "GotCashback") e guarde.
Ative o conector em qualquer conversa em que pretenda fazer consultas de cashback — o Claude irá invocar 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 ligação e para iniciar sessão quando quiser utilizar as ferramentas de conta.

ChatGPT

Abra Definições → Conectores (disponível nos planos que suportam conectores personalizados/de programador).
Escolha adicionar um conector personalizado e introduza o URL do servidor: https://mcp.gotcashback.com
Siga as instruções para o autorizar e ativar na conversa ou na configuração de um GPT personalizado.

O suporte a conectores do ChatGPT tem sido disponibilizado por fases e a disponibilidade varia consoante o plano. Se não vir a opção "conector personalizado" ou "modo de programador", consulte a documentação atual da OpenAI para o seu tipo de conta.

VS Code (modo agente do GitHub Copilot)

Execute "MCP: Add Server" a partir da 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 se encontra este ficheiro de configuração (p. ex., ~/.cursor/mcp.json para o Cursor) — o URL e a estrutura acima são os mesmos na maioria dos clientes, uma vez que seguem a mesma especificação MCP.

Exemplos de perguntas depois de ligar

"Qual é a melhor taxa de cashback da Best Buy neste momento?"
"Existem cartões de oferta com desconto da Target?"
"What's the best cashback rate for Walmart in Canada?"
"Compare gift card discounts for Home Depot."
"Que portais de cashback estão disponíveis no Reino Unido?"
"Onde posso comprar produtos Adidas com o melhor cashback?"
"Onde posso comprar comida para cão com o maior desconto?"
"Que portais de cashback do Reino Unido pagam por PayPal, e qual tem o pagamento mínimo mais baixo?"
"A TopCashback oferece um bónus de registo, e com que frequência paga?"
"Avisa-me quando a taxa de cashback da Nike atingir 10%."
"Adiciona a Best Buy às minhas lojas favoritas."

Os dois últimos utilizam as ferramentas de conta opcionais e irão pedir-lhe que inicie sessão com a sua conta GotCashback.

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

O que faz o servidor MCP da GotCashback

Depois de ligado, um assistente de IA pode comparar as taxas de cashback atuais online e em loja de uma loja em todos os portais, encontrar cartões-presente com desconto, ordenar as lojas que vendem uma marca ou categoria de compra pela melhor oferta, percorrer lojas por país e consultar as condições de pagamento de cada portal (bónus de registo, pagamento mínimo, frequência de pagamento, métodos de pagamento). O servidor indica ao assistente que ferramenta responde a cada tipo de pergunta, pelo que uma pergunta simples como "best cashback for Walmart" vai diretamente para a consulta certa. As taxas são atualizadas várias vezes por dia.

Como um assistente escolhe a ferramenta

O servidor indica aos assistentes ligados que ferramenta responde a cada pergunta, pelo que pode perguntar com naturalidade:

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
Cartões-presente 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 poupança ("best cashback on Adidas products") → get_best_deals_by_brand
Onde comprar um tipo de produto com a maior poupança ("cheapest dog food with cashback") → get_best_deals_by_category
O bónus de registo, o pagamento mínimo, o calendário ou os métodos de pagamento de um portal → get_portals_by_name / get_portals
Que lojas oferecem cashback num país → get_stores_by_country

Mencione um país quando for relevante ("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 recorrem diretamente a estas ferramentas — nunca precisam de listar primeiro 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 a "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 cartões-presente 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 de oferta	brand_name, country_code (optional)
`get_best_deals_by_category`	Igual para uma categoria de compras (p. ex., "Pet Supplies")	category_name, country_code (optional)
`get_stores_by_name`	Encontra o ID, o país e a ligação da página de uma loja (sem taxas)	store_name, country_code (optional)
`get_stores_by_country`	Percorre todas as lojas com cashback num país — apenas IDs e ligações 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 registo, pagamento mínimo, frequência de pagamento, métodos de pagamento), opcionalmente por país — não as taxas das lojas	country_code (optional)
`get_portals_by_name`	Procura portais pelo nome e devolve as 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 as respetivas condições de pagamento	portal_id
`get_countries`	Lista os países suportados e os respetivos 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 provêm de um resultado anterior.

Ligações com rastreio nos resultados

Cada loja, taxa de cashback, cartão de oferta e bónus de registo de portal num resultado inclui uma ligação com rastreio da GotCashback (url, e ainda gift_cards_url quando aplicável). O cashback só é creditado, os descontos em cartões de oferta só se aplicam e os bónus de registo só são concedidos quando acede através dessas ligações. O servidor instrui os clientes de IA a mostrá-las sempre — se um assistente citar uma taxa sem ligação, peça-lhe a ligação.

Ferramentas de conta (início de sessão opcional)

Iniciar sessão com a sua conta GotCashback (OAuth 2.1 — o seu cliente de IA irá propô-lo automaticamente) desbloqueia ferramentas adicionais por utilizador. Todas as ferramentas de comparação acima continuam a funcionar sem iniciar sessão.

Ferramenta	O que faz	Entradas principais	Âmbito
`get_my_profile`	Devolve o seu perfil GotCashback (nome, e-mail, avatar)	—	`profile`
`get_my_favorite_stores`	Lista as suas lojas favoritas	—	`favorites`
`toggle_favorite_store`	Adiciona ou remove uma loja dos seus favoritos	store_id, favorite	`favorites`
`get_my_alerts`	Lista os seus alertas de cashback e de cartões de oferta (loja, tipo, limite, última notificação)	—	`alerts`
`set_store_alert`	Cria ou atualiza um alerta que lhe envia um e-mail quando a taxa de cashback ou o desconto em cartão de oferta de uma loja atinge ou ultrapassa a percentagem 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 gere em Conta → Alertas no site: alert_type é cashback ou gift_card, threshold_percent situa-se entre 1 e 100, voltar a guardar um alerta existente atualiza o seu limite e reativa-o, e cada conta pode ter no máximo 10 alertas ativos.

Como funciona o início de sessão

Na primeira vez que utiliza uma ferramenta de conta, o servidor responde com um pedido de autorização e o seu cliente de IA abre a página de início de sessão da GotCashback no navegador — o mesmo início de sessão com redes sociais do site. Não é necessário registo nem chave de API.
Aprove as permissões pedidas (âmbitos) e regresse ao seu cliente. A chamada à ferramenta é concluída e a ligação mantém a sessão iniciada — os clientes que pedem offline_access recebem refresh tokens, pelo que não lhe voltará a ser pedido.
Para desligar, remova o conector do seu cliente de IA. Se mais tarde uma ferramenta comunicar que falta um âmbito, remova e volte a adicionar o conector para que o cliente peça novamente a autorização.

Âmbito	O que concede
`profile`	Ler o seu nome, e-mail e avatar
`favorites`	Ler e alterar as suas lojas favoritas
`alerts`	Ler, criar e remover os seus alertas de cashback e de cartões de oferta
`offline_access`	Refresh tokens para que a ligação mantenha a sessão iniciada

Endpoint do servidor

https://mcp.gotcashback.com

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

Para programadores e agentes de IA

O servidor (versão 1.1.1) expõe apenas ferramentas (sem recursos nem prompts). Cada ferramenta tem um título, uma descrição que indica quando a usar, anotações só de 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 ligue sem ler esta página:

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

https://mcp.gotcashback.com — Endpoint MCP — Streamable HTTP, JSON-RPC por POST, sem estado (não é necessária afinidade de sessão)
https://mcp.gotcashback.com/.well-known/mcp/server-card.json — Cartão do servidor MCP que descreve o servidor, o transporte e a autenticação (também disponibilizado neste site)
https://mcp.gotcashback.com/.well-known/oauth-protected-resource — Metadados OAuth do recurso protegido: âmbitos 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, registo 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 estado

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

Dúvidas ou problemas?

Se uma ligação falhar ou uma chamada a uma ferramenta devolver um erro, confirme que o URL está introduzido exatamente como https://mcp.gotcashback.com, sem qualquer caminho no final. Se uma ferramenta de conta continuar a pedir-lhe para iniciar sessão, remova e volte a adicionar o conector. Para mais ajuda, contacte o suporte da GotCashback.