Search and Book 3M hotels worldwide

Oficial. Alojado. Gratuito. MCP para conectar tu agente de IA a más de 3 millones de hoteles en todo el mundo. ¡Busca y reserva!

GitHub

Documentación

🌍 Servidor MCP de WinWin.travel

El servidor oficial del Protocolo de Contexto de Modelos (MCP) de WinWin.travel. Conecta tus agentes de IA directamente a un inventario masivo de más de 3 millones de hoteles con capacidades de reserva en tiempo real.

🚀 ¿Por qué usar este MCP?

La mayoría de los MCP de viajes son solo raspadores de datos. WinWin.travel es una pasarela empresarial oficial.

🏢 Inventario de 3M+: Accede a una de las bases de datos hoteleras más grandes del mundo directamente.
⚡ Cero configuración: Sin Docker, sin npm install, sin túneles de localhost. Está completamente alojado.
💰 Gana mientras construyes: Te pagamos a ti por el uso. Obtén hasta un 10% de reembolso en cada reserva realizada a través de tu agente.
🧠 Búsqueda más inteligente: Filtra por más de 500 atributos (servicios, ambiente, políticas), no solo por precio o ubicación.

🗣️ Ejemplos de indicaciones

Una vez conectado, tu IA (Claude, etc.) puede gestionar solicitudes de viaje complejas:

"Encuéntrame un hotel boutique en Tokio, distrito de Shibuya, por menos de $200/noche que admita perros (verifica las tarifas por mascota) y tenga cortinas opacas para el desfase horario."
"Verifica la disponibilidad del Marriott Marquis en Nueva York. Necesito una habitación con ducha tipo lluvia y vista a la ciudad."
"¿Cuáles son los hoteles de moda en Bali ahora mismo? Filtra los que tengan menú de almohadas y altura de cama accesible."
"Reserva la segunda opción para 2 adultos. Asegúrate de adjuntar una solicitud de estación para mascotas dedicada y envía el enlace de pago a mi correo electrónico."

🤖 Bots de demostración listos para usar

Aviso importante: los bots de esta sección son demostraciones — su función es mostrar lo que es posible con el MCP de WinWin de una manera concreta y ejecutable. No son una arquitectura de producción recomendada, no están endurecidos en seguridad y no son la única forma de usar el servidor. Trata el flujo de trabajo como un punto de partida que adaptas a tus propias necesidades, no como un producto llave en mano.

¿Quieres ver el MCP de WinWin en acción sin escribir código de conexión tú mismo? Incluimos un agente de viajes de IA para Telegram funcional como un flujo de trabajo de n8n que puedes importar y ejecutar en minutos.

🏨 Bot de demostración de hoteles WinWin — Bot de Telegram que busca hoteles mediante solicitudes de texto libre, muestra tarjetas de ofertas enriquecidas con fotos y admite paginación y galerías de fotos.
🧩 Plantilla de n8n completamente conectada — ya conectada al MCP de WinWin, con análisis de salida estructurada, validación de fotos y almacenamiento en tablas de datos para galerías.
🧠 Memoria de chat persistente — mantiene el contexto de múltiples turnos (paginación, preguntas de seguimiento, cambio de idioma) entre mensajes. La plantilla incluye Postgres, pero el nodo de memoria es intercambiable por cualquier otro backend de memoria de chat que admita n8n.

📦 Archivo de plantilla: winwin-hotel-demo-bot.json 📖 Guía de configuración: → Guía de configuración de n8n

🔌 Guías de conexión

Elige el método de configuración que se adapte a tu flujo de trabajo:

Método	Descripción	Guía
Conexión rápida	La forma más rápida: conéctate mediante la configuración de Claude Desktop en minutos	→ Guía de conexión rápida
Conectar con habilidades (recomendado)	Enfoque mejorado: instala una habilidad para una búsqueda de hoteles más inteligente y consciente del contexto	→ Guía de configuración de habilidades
Bot de demostración n8n	Plantilla de flujo de trabajo n8n lista para usar: agente de viajes de IA para Telegram sobre el MCP de WinWin	→ Guía de configuración de n8n

🧰 Capacidades

Herramienta	Descripción
`search`	Busca ofertas de habitaciones de hotel disponibles por destino, fechas de estancia, composición de huéspedes y filtros opcionales — como planes de comidas, políticas de cancelación, servicios (piscina, spa), características de accesibilidad, políticas de mascotas y más de 500 criterios adicionales.
`get_filters`	Devuelve la lista completa de opciones de filtro disponibles: servicios, planes de comidas, tipos de cancelación, características de accesibilidad, políticas de mascotas y más. Úsalo antes de buscar para descubrir valores de filtro válidos.
`create_reservation`	Crea una reserva para una oferta de habitación de hotel seleccionada de los resultados de búsqueda y devuelve un enlace de pago. La reserva se confirma automáticamente una vez que se completa el pago.
`get_reservation_status`	Verifica el estado actual de una reserva utilizando el identificador devuelto por `create_reservation`.
`echo`	Devuelve la cadena de prueba proporcionada sin cambios. Útil para diagnósticos y verificaciones de conexión.
`test_mcp_authentication`	Verifica que tu token MCP sea válido y que la autenticación esté funcionando correctamente.

🔒 Seguridad y privacidad

Punto final oficial: Te estás conectando directamente a la pasarela API segura de WinWin.travel.
Uso de datos: Tus preferencias se utilizan para mejorar tu experiencia de reserva. No vendemos tus datos a terceros.

💳 Flujo de reserva

Buscar — tu IA llama a search y devuelve una lista de ofertas disponibles.
Seleccionar — le dices a la IA qué opción reservar.
Reservar — la IA llama a create_reservation y recibe un enlace de pago.
Pagar — completas el pago en tu navegador. Los datos de la tarjeta nunca pasan por la IA.
Confirmar — la reserva se confirma automáticamente. Usa get_reservation_status para verificar en cualquier momento.

🤖 Modelos de IA recomendados

Para la experiencia más confiable, recomendamos usar modelos de lenguaje con un Índice de Inteligencia equivalente a Claude Sonnet 4.6 o superior.

Los modelos por debajo de este nivel de capacidad pueden malinterpretar las respuestas de las herramientas MCP, alucinar datos de hoteles o ignorar las instrucciones de las herramientas al procesar solicitudes de viaje complejas.

Consulta la guía completa para:

modelos recomendados;
Índice de Inteligencia mínimo admitido;
problemas conocidos con modelos de menor capacidad;
mejores prácticas para uso en producción.

👉 Modelos de IA recomendados

❓ Preguntas frecuentes

¿Qué clientes de IA son compatibles además de Claude Desktop?

Cualquier cliente compatible con MCP funciona. Clientes como Cursor y Windsurf admiten servidores MCP remotos de forma nativa — sin npx ni Node.js. Solo apúntalos directamente a https://mcp.winwin.travel/mcp/sse con tu encabezado Authorization: Bearer YOUR_TOKEN en la configuración MCP de tu cliente.

¿Dónde se encuentra `claude_desktop_config.json`?

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

¿Cómo sé que la conexión está funcionando?

Pregunta a tu IA: "Usa la herramienta test_mcp_authentication para verificar si WinWin.travel está conectado." Una respuesta exitosa confirma que tu token es válido. También deberías ver WinWin.travel listado en las herramientas MCP activas de tu cliente.

¿Cómo funciona el Programa de Afiliados?

Pagamos comisiones de afiliado según tu volumen mensual de reservas:

Nivel	Reservas/mes	Comisión
Nivel 1	5+	4% del valor total de la reserva
Nivel 2	20+	7% del valor total de la reserva
Nivel 3	50+	10% del valor total de la reserva
Nivel 4	100+	Condiciones especiales

El nivel se calcula por mes calendario. Las reservas se cuentan después de un período de retención de 14 días — desde la fecha de pago para reservas no reembolsables, o desde la salida del huésped para reservas reembolsables.

Se enviará un contrato de afiliado dentro de las 2 semanas posteriores a tu primera reserva de afiliado exitosa. ¿Preguntas? mcp@winwin.travel

La herramienta no aparece en Claude — ¿qué debo verificar?

Confirma que el JSON en claude_desktop_config.json sea válido (sin comas finales, sin comentarios de // dentro del JSON).
Verifica que el archivo esté guardado en la ruta correcta del sistema operativo (ver arriba).
Cierra y reinicia Claude Desktop por completo — cerrar la ventana no es suficiente.

Mi token no funciona — ¿qué debo verificar?

Ejecuta test_mcp_authentication — devuelve un error explícito si el token es inválido o ha expirado. Asegúrate de haber reemplazado YOUR_ACCESS_TOKEN_HERE con la cadena completa del token y de que no haya espacios adicionales.

¿Está disponible a nivel mundial?

Sí. El servidor cubre el inventario hotelero mundial. La disponibilidad y los precios dependen del destino y las fechas buscadas.

¿Tiene algún costo usar este MCP?

No. Conectarse y buscar es gratuito. Solo pagas al completar una reserva de hotel.

¿Hay una plantilla oficial de n8n que pueda instalar con un clic?

Sí. El Bot de demostración de hoteles WinWin está publicado como una plantilla oficial de n8n, por lo que puedes instalarlo directamente desde la galería de plantillas de n8n sin copiar archivos. Después de instalar, conecta tu token de bot de Telegram, tu credencial de modelo de chat (consulta Modelos de IA recomendados para el proveedor/modelo a usar — la plantilla viene conectada a un nodo de OpenAI, pero puedes cambiarlo por cualquier proveedor recomendado allí), el bearer MCP de WinWin y tu backend de memoria de chat preferido (la plantilla incluye Postgres), crea la tabla de datos OfferPhotos y actívala. También hay una copia del mismo flujo de trabajo disponible como winwin-hotel-demo-bot.json para importación manual. Tutorial completo: → Guía de configuración de n8n.

Hecho con ❤️ por el equipo de WinWin.travel
mcp@winwin.travel