Cruise Itinerary

Travesías de crucero, itinerarios, historial semanal de tarifas, capacidad mensual de puertos y el Índice de Precios de Cruceros para asistentes de IA.

GitHub

Servidor MCP alojado

npx add-mcp 'https://cruise-itinerary.com/mcp'

Se instala en Claude Code, Codex, Cursor y más

Documentación

Cruise Itinerary para Claude, ChatGPT y otros clientes MCP

Pregunta a un asistente de IA sobre cruceros y obtén respuestas basadas en datos reales: qué salidas hacen escala en un puerto, cómo es el itinerario de un barco día a día, cómo ha evolucionado la tarifa de una salida semana a semana, cuánta capacidad de barcos llega a un puerto cada mes y cómo tienden los precios de los cruceros en general.

Este repositorio contiene:

los datos de conexión para el servidor MCP remoto Cruise Itinerary en https://cruise-itinerary.com/mcp,
un plugin de Claude que añade ese servidor más una habilidad cruise-research, que enseña a Claude las advertencias de los datos,
server.json, la entrada del servidor en el Registro MCP oficial.

El servidor es gestionado por Cruise Itinerary (Agile Travel Group, Inc., operado como Cruiseable). Los datos son los mismos que los de su API REST: documentación de la API, documentación de MCP.

Qué puedes preguntar

"¿Qué salidas hacen escala en Juneau en julio de 2027, primero el balcón más barato?"
"Muéstrame el itinerario día a día de esa salida."
"¿Ha subido o bajado la tarifa de esta salida desde septiembre?"
"¿Cuántos camarotes de capacidad de barcos llegan a Cozumel cada mes el próximo invierno?"
"¿Qué dice el Índice de Precios de Cruceros sobre las tarifas de este mes?"

Herramientas

Todas las herramientas son de solo lectura (readOnlyHint: true). Cada una devuelve el mismo JSON que el endpoint REST correspondiente, como structuredContent con un outputSchema.

Herramienta	Qué responde	Plan mínimo
`resolve_entity`	Un puerto, barco o nombre de línea de cruceros, como se escriba, al id que usan las otras herramientas	Gratis
`cruise_price_index`	El Índice de Precios de Cruceros semanal: últimas 12 semanas (Gratis), o una serie completa por línea, cabina y segmento (Business)	Gratis / Business
`search_sailings`	Próximas salidas por barco, línea, puerto, puerto de salida, región, fechas, duración y tarifa, con las últimas tarifas semanales	Developer (Gratis: 10 llamadas de prueba al mes)
`get_itinerary`	El itinerario fechado día a día de una salida, o la lista de escalas de un crucero	Developer (Gratis: 10 llamadas de prueba al mes)
`get_price_history`	Cada instantánea semanal de tarifa de una salida	Business (Gratis: 10 llamadas de prueba al mes)
`port_month_capacity`	Días de barco, barcos distintos y camarotes en un puerto, mes a mes	Business

Una cuenta gratuita (una dirección de correo electrónico, sin tarjeta) incluye 500 llamadas al mes. Cada llamada exitosa a una herramienta cuenta como una llamada a la API. Una herramienta por encima de tu plan responde con un mensaje breve, un enlace a precios y, cuando la llamada mencionaba una salida o crucero, un enlace a su página gratuita en Cruiseable.

Configuración

Claude (claude.ai, Desktop, móvil)

Añádelo como conector: Personalizar → Conectores → Añadir conector personalizado, nómbralo Cruise Itinerary y pega https://cruise-itinerary.com/mcp. Claude detecta el inicio de sesión OAuth y te pide que inicies sesión al añadirlo: introduce tu correo electrónico, abre el enlace que te enviamos y luego aprueba la conexión.

Para obtener también la habilidad cruise-research, instala este repositorio como plugin (abajo) o desde el directorio de Claude una vez que esté listado.

Claude Code

Como plugin (servidor y habilidad):

/plugin marketplace add BigBalli/cruise-itinerary-mcp
/plugin install cruise-itinerary@cruise-itinerary

O solo el servidor:

claude mcp add --transport http cruise-itinerary https://cruise-itinerary.com/mcp

Luego ejecuta /mcp y elige cruise-itinerary para iniciar sesión.

ChatGPT

Añade una aplicación personalizada (conector) con la URL https://cruise-itinerary.com/mcp y autenticación OAuth. Hasta que aparezca en el directorio de ChatGPT, esto requiere modo desarrollador.

Cursor, VS Code, Windsurf y otros clientes

Apunta el cliente a la URL. Los clientes que admiten OAuth MCP inician sesión en el navegador:

{
  "mcpServers": {
    "cruise-itinerary": {
      "url": "https://cruise-itinerary.com/mcp"
    }
  }
}

Los clientes sin OAuth pueden enviar una clave de API desde tu panel de control como encabezado en su lugar. Mantén la clave fuera de archivos compartidos.

{
  "mcpServers": {
    "cruise-itinerary": {
      "url": "https://cruise-itinerary.com/mcp",
      "headers": { "Authorization": "Bearer <your API key>" }
    }
  }
}

Cómo funciona el inicio de sesión

El servidor sigue la especificación de autorización MCP: OAuth 2.1 con PKCE (S256), metadatos de recursos protegidos en https://cruise-itinerary.com/.well-known/oauth-protected-resource/mcp, y un servidor de autorización en https://cruise-itinerary.com que admite Documentos de Metadatos de ID de Cliente y registro dinámico de clientes. El inicio de sesión es mediante enlace de correo electrónico; una dirección nueva obtiene una cuenta gratuita. Apruebas cada aplicación en una página de consentimiento que muestra qué aplicación solicita el acceso y a dónde te devuelve. Los tokens de acceso duran una hora y los tokens de actualización se rotan al usarse. La conexión nunca comparte tus claves de API, dirección de correo electrónico o facturación con la aplicación, y la aplicación solo puede leer.

Cada solicitud necesita una cuenta, initialize incluido: sin un token, el servidor responde 401 con un encabezado WWW-Authenticate que apunta a los metadatos de recursos protegidos, que es como los clientes saben que deben iniciar el inicio de sesión.

Lee los datos de la manera correcta

Las tarifas son instantáneas semanales capturadas cada lunes desde el 6 de septiembre de 2026, no precios en vivo ni reservables. meta.as_of da la fecha de carga.
Una tarifa faltante (nula) significa que la cabina no se ofreció o estaba agotada; los datos no indican cuál de las dos.
Los días de itinerario marcados como estimated se colocaron según la distancia entre puertos y pueden desviarse por un día. Los días exact provienen del itinerario publicado por la línea de cruceros.
La capacidad portuaria es solo mensual, y los camarotes son capacidad de barcos, no pasajeros.
La cobertura es más sólida para líneas de cruceros de América del Norte. TUI Cruises/Marella, AIDA, Saga, Fred. Olsen y Hapag-Lloyd no están cubiertas.

Datos y privacidad

El plugin no contiene código que se ejecute en tu máquina. Declara un servidor MCP remoto, https://cruise-itinerary.com/mcp, y una habilidad hecha de instrucciones. Cuando tu asistente llama a una herramienta, el nombre de la herramienta y sus argumentos (nombres de puertos, barcos o líneas, fechas, ids) van a cruise-itinerary.com con tu token de acceso. Se usan para responder a la llamada, contarla para tu plan y aplicar límites de velocidad. No se envía nada más, y no se envía nada a ningún otro lugar.

Política de privacidad: https://cruise-itinerary.com/privacy
Términos: https://cruise-itinerary.com/terms
Soporte: hello@cruise-itinerary.com

Licencia

MIT, ver LICENCIA. Los datos servidos por la API están cubiertos por los términos de Cruise Itinerary, no por esta licencia.