Search and Book 3M hotels worldwide

🌍 Servidor MCP WinWin.travel

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

---

🚀 Por que usar este MCP?

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

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

🗣️ Exemplos de prompts

Depois de 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 efeito 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."
• "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 o meu e-mail."

🤖 Bots de demonstração prontos

Atenção: os bots nesta seção são demonstrações — o objetivo deles é mostrar o que é possível com o MCP WinWin de forma concreta e executável. Eles não são uma arquitetura de produção recomendada, não são endurecidos com segurança e não são a única maneira de usar o servidor. Trate o fluxo de trabalho como um ponto de partida que você adapta às suas próprias necessidades, não como um produto pronto para uso.

Quer ver o WinWin MCP em ação sem escrever código de integração? Oferecemos um agente de viagens de IA para Telegram funcional como um fluxo de trabalho n8n que você pode importar e executar em minutos.

• 🏨 Bot de demonstração WinWin Hotel — Bot de Telegram que pesquisa hotéis por solicitação em texto livre, exibe cartões de ofertas ricos com fotos e suporta paginação e galerias de fotos.
• 🧩 Modelo n8n totalmente conectado — já conectado ao MCP WinWin, com análise de saída estruturada, validação de fotos e armazenamento em Data Table para galerias.
• 🧠 Memória de chat persistente — mantém o contexto de múltiplas mensagens (paginação, perguntas de acompanhamento, troca de idioma) entre mensagens. O modelo inclui Postgres, mas o nó de memória pode ser trocado por qualquer outro backend de memória de chat suportado pelo n8n.

📦 Arquivo do modelo: winwin-hotel-demo-bot.json 📖 Guia de configuração: → Guia de configuração n8n

🔌 Guias de conexão

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

Método	Descrição	Guia
Conexão rápida	Maneira mais rápida — conecte via configuração do Claude Desktop em minutos	→ Guia de conexão rápida
Conectar com 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
Bot de demonstração n8n	Modelo de fluxo de trabalho n8n pronto para uso — agente de viagens de IA para Telegram sobre o WinWin MCP	→ Guia de configuração n8n

---

🧰 Capacidades

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 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 o 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. Pesquisar — sua IA chama search e retorna uma lista de ofertas disponíveis.
2. Selecionar — você informa à IA qual opção reservar.
3. Reservar — a IA chama create_reservation e recebe um link de pagamento.
4. Pagar — você conclui o pagamento no seu navegador. Os dados do cartão nunca passam pela IA.
5. Confirmar — 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 menor capacidade;
• melhores práticas para uso em produção.

👉 Modelos de IA recomendados

---

❓ FAQ

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 npx ou Node.js necessários. Basta apontá-los diretamente para https://mcp.winwin.travel/mcp/sse com o cabeçalho Authorization: Bearer YOUR_TOKEN nas configurações de MCP do seu cliente.

Onde está localizado o 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 listado 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 das reservas
Nível 2	20+	7% do valor total das reservas
Nível 3	50+	10% do valor total das reservas
Nível 4	100+	Condições 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. Feche e reabra completamente 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 global 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.

Existe um modelo n8n oficial que posso instalar com um clique?

Sim. O Bot de demonstração WinWin Hotel é publicado como um modelo oficial do n8n, então você pode instalá-lo diretamente da galeria de modelos do n8n sem copiar arquivos. Após a instalação, conecte seu token do bot do Telegram, sua credencial de modelo de chat (consulte Modelos de IA recomendados para o provedor/modelo a usar — o modelo vem conectado a um nó OpenAI, mas você pode trocá-lo por qualquer provedor recomendado lá), o bearer do MCP WinWin e seu backend de memória de chat preferido (o modelo inclui Postgres), crie a Data Table OfferPhotos e ative. Uma cópia do mesmo fluxo de trabalho também está disponível como winwin-hotel-demo-bot.json para importação manual. Tutorial completo: → Guia de configuração n8n.

---

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