Search and Book 3M hotels worldwide

🌍 WinWin.travel MCP Server

O servidor oficial do Model Context Protocol da WinWin.travel. Conecte seus agentes de IA diretamente a um enorme inventário de mais de 3 milhões de hotéis com recursos de reserva em tempo real.

---

🚀 Por que usar este MCP?

A maioria dos MCPs de viagem são apenas scrapers. WinWin.travel é um gateway empresarial oficial.

• 🏢 Inventário de 3M+: Acesse diretamente um dos maiores bancos de dados de hotéis do mundo.
• ⚡ Zero Configuração: Sem Docker, sem npm install, sem túnel localhost. Totalmente hospedado.
• 💰 Ganhe enquanto você cria: Pagamos você pelo uso. Receba até 10% de cashback em cada reserva feita pelo seu agente.
• 🧠 Busca mais inteligente: Filtre por mais de 500 atributos (comodidades, vibes, políticas), não apenas preço/localização.

🗣️ Exemplos de Prompts

Uma vez conectado, sua IA (Claude, etc.) pode lidar com solicitações de viagem complexas:

• "Encontre um hotel boutique em Tóquio, distrito de Shibuya, abaixo de US$ 200/noite que aceite cães (verifique taxas para pets) e tenha cortinas blackout para jet lag."
• "Verifique a disponibilidade do Marriott Marquis em NY. Preciso de um quarto com chuveiro de chuva e vista para a cidade."
• "Quais são os hotéis em alta em Bali agora? Filtre por aqueles com menu de travesseiros e altura de cama acessível para deficientes."
• "Reserve a segunda opção para 2 adultos. Garanta que haja uma solicitação de estação para pets anexada e envie o link de pagamento para meu e-mail."

🔌 Guias de Conexão

Escolha o método de configuração que se adequa ao seu fluxo de trabalho:

Método	Descrição	Guia
Quick Connect	Maneira mais rápida — conecte-se via configuração do Claude Desktop em minutos	→ Guia de Quick Connect
Connect with Skills (recomendado)	Abordagem aprimorada — instale uma skill para busca de hotéis mais inteligente e sensível ao contexto	→ Guia de Configuração de Skills

---

🧰 Recursos

Ferramenta	Descrição
search	Pesquisa ofertas de quartos de hotel disponíveis por destino, datas de estadia, composição de hóspedes e filtros opcionais — como planos de refeição, políticas de cancelamento, comodidades (piscina, spa), recursos de acessibilidade, políticas para pets e mais de 500 outros critérios.
get_filters	Retorna a lista completa de opções de filtro disponíveis — comodidades, planos de refeição, tipos de cancelamento, recursos de acessibilidade, políticas para pets e mais. Use isso antes de pesquisar para descobrir valores de filtro válidos.
create_reservation	Cria uma reserva para uma oferta de quarto de hotel selecionada nos resultados da pesquisa e retorna um link de pagamento. A reserva é confirmada automaticamente assim que o pagamento é concluído.
get_reservation_status	Verifica o status atual de uma reserva usando o identificador retornado por create_reservation.
echo	Retorna a string de teste fornecida sem alterações. Útil para diagnósticos e verificações de conexão.
test_mcp_authentication	Verifica se seu token MCP é válido e se a autenticação está funcionando corretamente.

🔒 Segurança e Privacidade

• Endpoint Oficial: Você está se conectando diretamente ao gateway de API seguro da WinWin.travel.
• Uso de Dados: Suas preferências são usadas para melhorar sua experiência de reserva. Não vendemos seus dados a terceiros.

---

💳 Fluxo de Reserva

1. Pesquisa — sua IA chama search e retorna uma lista de ofertas disponíveis.
2. Seleção — você diz à IA qual opção reservar.
3. Reserva — a IA chama create_reservation e recebe um link de pagamento.
4. Pagamento — você conclui o pagamento no seu navegador. Os dados do cartão nunca passam pela IA.
5. Confirmação — a reserva é confirmada automaticamente. Use get_reservation_status para verificar a qualquer momento.

---

🤖 Modelos de IA Recomendados

Para a experiência mais confiável, recomendamos usar modelos de linguagem com um Índice de Inteligência equivalente ao Claude Sonnet 4.6 ou superior.

Modelos abaixo desse nível de capacidade podem interpretar mal as respostas das ferramentas MCP, alucinar dados de hotéis ou ignorar instruções das ferramentas ao processar solicitações de viagem complexas.

Consulte o guia completo para:

• modelos recomendados;
• índice de inteligência mínimo suportado;
• problemas conhecidos com modelos de capacidade inferior;
• melhores práticas para uso em produção.

👉 Modelos de IA Recomendados

---

❓ Perguntas Frequentes

Quais clientes de IA são suportados além do Claude Desktop?

Qualquer cliente compatível com MCP funciona. Clientes como Cursor e Windsurf suportam servidores MCP remotos nativamente — sem necessidade de npx ou Node.js. Basta apontá-los diretamente para https://mcp.winwin.travel/mcp/sse com seu cabeçalho Authorization: Bearer YOUR_TOKEN nas configurações de MCP do seu cliente.

Onde está localizado claude_desktop_config.json?

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Como sei que a conexão está funcionando?

Pergunte à sua IA: "Use a ferramenta test_mcp_authentication para verificar se a WinWin.travel está conectada." Uma resposta bem-sucedida confirma que seu token é válido. Você também deve ver WinWin.travel listada nas ferramentas MCP ativas do seu cliente.

Como funciona o Programa de Afiliados?

Pagamos comissões de afiliado com base no seu volume mensal de reservas:

Nível	Reservas/mês	Comissão
Nível 1	5+	4% do valor total da reserva
Nível 2	20+	7% do valor total da reserva
Nível 3	50+	10% do valor total da reserva
Nível 4	100+	Termos especiais

O nível é calculado por mês calendário. As reservas são contadas após um período de retenção de 14 dias — a partir da data de pagamento para reservas não reembolsáveis, ou a partir do check-out do hóspede para reservas reembolsáveis.

Um contrato de afiliado será enviado dentro de 2 semanas após sua primeira reserva de afiliado bem-sucedida. Dúvidas? mcp@winwin.travel

A ferramenta não está aparecendo no Claude — o que devo verificar?

1. Confirme se o JSON em claude_desktop_config.json é válido (sem vírgulas finais, sem comentários // dentro do JSON).
2. Verifique se o arquivo está salvo no caminho correto do sistema operacional (veja acima).
3. Saia completamente e reinicie o Claude Desktop — fechar a janela não é suficiente.

Meu token não está funcionando — o que devo verificar?

Execute test_mcp_authentication — ele retorna um erro explícito se o token for inválido ou expirado. Certifique-se de substituir YOUR_ACCESS_TOKEN_HERE pela string completa do token e que não há espaços extras.

Isso está disponível globalmente?

Sim. O servidor cobre o inventário mundial de hotéis. Disponibilidade e preços dependem do destino e das datas pesquisadas.

Há custo para usar este MCP?

Não. Conectar e pesquisar é gratuito. Você só paga ao concluir uma reserva de hotel.

---

Feito com ❤️ pela equipe WinWin.travel
mcp@winwin.travel