Cruise Itinerary

Cruzeiros, itinerários, histórico semanal de tarifas, capacidade mensal dos portos e o Índice de Preços de Cruzeiros para assistentes de IA.

GitHub

Servidor MCP hospedado

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

Instala no Claude Code, Codex, Cursor e outros

Documentação

Cruise Itinerary para Claude, ChatGPT e outros clientes MCP

Pergunte a um assistente de IA sobre cruzeiros e obtenha respostas com dados reais: quais viagens param em um porto, como é o itinerário de um navio dia a dia, como a tarifa de uma viagem mudou semana a semana, quanta capacidade de navios chega a um porto a cada mês e como os preços de cruzeiros estão tendendo no geral.

Este repositório contém:

os detalhes de conexão para o servidor MCP remoto Cruise Itinerary em https://cruise-itinerary.com/mcp,
um plugin Claude que adiciona esse servidor além de uma habilidade cruise-research, que ensina ao Claude as ressalvas dos dados,
server.json, a entrada do servidor no Registro MCP oficial.

O servidor é operado pela Cruise Itinerary (Agile Travel Group, Inc., operado como Cruiseable). Os dados são os mesmos da sua API REST: documentação da API, documentação MCP.

O que você pode perguntar

"Quais viagens param em Juneau em julho de 2027, primeiro a varanda mais barata?"
"Mostre-me o itinerário dia a dia dessa viagem."
"A tarifa desta viagem subiu ou desceu desde setembro?"
"Quantos leitos de capacidade de navios chegam a Cozumel a cada mês no próximo inverno?"
"O que o Índice de Preços de Cruzeiros diz sobre as tarifas deste mês?"

Ferramentas

Todas as ferramentas são somente leitura (readOnlyHint: true). Cada uma retorna o mesmo JSON do endpoint REST correspondente, como structuredContent com um outputSchema.

Ferramenta	O que responde	Plano mínimo
`resolve_entity`	Um porto, navio ou nome de linha de cruzeiro, por mais que esteja escrito, para o id que as outras ferramentas usam	Gratuito
`cruise_price_index`	O Índice de Preços de Cruzeiros semanal: últimas 12 semanas (Gratuito), ou uma série completa por linha, cabine e segmento (Business)	Gratuito / Business
`search_sailings`	Próximas viagens por navio, linha, porto, porto de partida, região, datas, duração e tarifa, com as tarifas semanais mais recentes	Desenvolvedor (Gratuito: 10 chamadas de teste por mês)
`get_itinerary`	O itinerário datado dia a dia de uma viagem, ou a lista de paradas de um cruzeiro	Desenvolvedor (Gratuito: 10 chamadas de teste por mês)
`get_price_history`	Cada captura semanal de tarifa de uma viagem	Business (Gratuito: 10 chamadas de teste por mês)
`port_month_capacity`	Dias-navio, navios distintos e leitos em um porto, mês a mês	Business

Uma conta gratuita (um endereço de e-mail, sem cartão) inclui 500 chamadas por mês. Cada chamada de ferramenta bem-sucedida conta como uma chamada de API. Uma ferramenta acima do seu plano responde com uma mensagem curta, um link para preços e, quando a chamada menciona uma viagem ou cruzeiro, um link para sua página gratuita no Cruiseable.

Configuração

Claude (claude.ai, Desktop, mobile)

Adicione como conector: Personalizar → Conectores → Adicionar conector personalizado, nomeie como Cruise Itinerary e cole https://cruise-itinerary.com/mcp. O Claude detecta o login OAuth e pede que você entre ao adicionar: insira seu e-mail, abra o link que enviamos e aprove a conexão.

Para obter também a habilidade cruise-research, instale este repositório como plugin (abaixo) ou pelo diretório do Claude quando estiver listado.

Claude Code

Como plugin (servidor e habilidade):

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

Ou apenas o servidor:

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

Depois execute /mcp e escolha cruise-itinerary para entrar.

ChatGPT

Adicione um aplicativo personalizado (conector) com a URL https://cruise-itinerary.com/mcp e autenticação OAuth. Até a listagem aparecer no diretório do ChatGPT, isso requer o modo desenvolvedor.

Cursor, VS Code, Windsurf e outros clientes

Aponte o cliente para a URL. Clientes que suportam OAuth MCP entram no navegador:

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

Clientes sem OAuth podem enviar uma chave de API do seu painel como cabeçalho. Mantenha a chave fora de arquivos compartilhados.

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

Como funciona o login

O servidor segue a especificação de autorização MCP: OAuth 2.1 com PKCE (S256), metadados de recurso protegido em https://cruise-itinerary.com/.well-known/oauth-protected-resource/mcp e um servidor de autorização em https://cruise-itinerary.com que suporta Documentos de Metadados de ID de Cliente e registro dinâmico de clientes. O login é por link de e-mail; um novo endereço recebe uma conta gratuita. Você aprova cada aplicativo em uma página de consentimento que mostra qual aplicativo está pedindo e para onde ele retorna você. Os tokens de acesso duram uma hora e os tokens de atualização giram a cada uso. A conexão nunca compartilha suas chaves de API, endereço de e-mail ou cobrança com o aplicativo, e o aplicativo só pode ler.

Cada solicitação precisa de uma conta, initialize incluído: sem um token, o servidor responde 401 com um cabeçalho WWW-Authenticate apontando para os metadados do recurso protegido, que é como os clientes sabem iniciar o login.

Leia os dados da maneira certa

As tarifas são capturas semanais feitas toda segunda-feira desde 6 de setembro de 2026, não preços ao vivo ou reserváveis. meta.as_of fornece a data de carregamento.
Uma tarifa ausente (nula) significa que a cabine não foi oferecida ou estava esgotada; os dados não dizem qual.
Dias de itinerário marcados como estimated foram colocados com base na distância entre portos e podem estar errados por um dia. Dias exact vêm do itinerário publicado pela linha de cruzeiro.
A capacidade do porto é apenas mensal, e leitos são capacidade do navio, não passageiros.
A cobertura é mais forte para linhas de cruzeiro norte-americanas. TUI Cruises/Marella, AIDA, Saga, Fred. Olsen e Hapag-Lloyd não são cobertas.

Dados e privacidade

O plugin não contém código que roda na sua máquina. Ele declara um servidor MCP remoto, https://cruise-itinerary.com/mcp, e uma habilidade feita de instruções. Quando seu assistente chama uma ferramenta, o nome da ferramenta e seus argumentos (nomes de portos, navios ou linhas, datas, ids) vão para cruise-itinerary.com com seu token de acesso. Eles são usados para responder à chamada, contá-la no seu plano e aplicar limites de taxa. Nada mais é enviado, e nada é enviado para qualquer outro lugar.

Política de privacidade: https://cruise-itinerary.com/privacy
Termos: https://cruise-itinerary.com/terms
Suporte: hello@cruise-itinerary.com

Licença

MIT, veja LICENÇA. Os dados servidos pela API são cobertos pelos termos do Cruise Itinerary, não por esta licença.