Ferryhopper MCP Server

Rotas de balsa, horários e transferência de reserva para assistentes de IA

O Ferryhopper MCP Server expõe rotas de balsa, horários e redirecionamentos de reserva para que um assistente de IA possa descobrir conexões pela Europa e pelo Mediterrâneo e enviar usuários ao Ferryhopper para concluir a reserva.

Principais recursos

🌍

Portos e conexões

Pesquise portos e conexões em 33 países e mais de 190 operadores de balsa

⛴️

Roteiros ao vivo

Obtenha roteiros de balsa em tempo real com preços indicativos — só ida, ida e volta ou cadeias de salto entre ilhas com até 5 trechos

🛳️

Detalhes da embarcação

Consulte detalhes da embarcação para uma travessia: comodidades, acessibilidade, capacidade, fotos e classes de assentos/cabines reserváveis com preços

⚠️

Alertas de interrupção

Receba alertas de interrupção em tempo real na Grécia e na Europa, incluindo cancelamentos, trocas de embarcação, modificações de porto e avisos meteorológicos

🔗

Transferência de reserva

Receba um link direto para o Ferryhopper.com para continuar o fluxo de reserva a partir da viagem selecionada

🧩

Apps MCP

Um app MCP (veja a visão geral oficial) é qualquer cliente que possa consumir ferramentas MCP remotas e, em alguns hosts, renderizar recursos de UI junto com os resultados das ferramentas.

Casos de uso

• Auxiliar usuários na busca por rotas de balsa e roteiros diários
• Recomendar destinos com base no porto de partida e na data
• Alimentar chatbots de viagem para planejar idas e voltas, saltos entre ilhas ou jornadas de múltiplos trechos
• Responder perguntas sobre uma embarcação específica — wifi, restaurante, pets, cabines, garagem para veículos, acessibilidade para cadeirantes
• Informar usuários sobre interrupções ativas antes ou durante a viagem, para que possam ajustar planos em tempo real

Opções de integração com clientes

📱

Hosts compatíveis com MCP consomem nosso conjunto de ferramentas e, se suportarem apps MCP no estilo iframe, renderizam resultados de viagem interativos mais ricos.

⌨️

Clientes somente texto ou de linha de comando usam o mesmo endpoint de ferramentas, simplesmente ignorando o recurso de UI e trabalhando com as respostas JSON estruturadas para portos, rotas e dados de viagem.

Ferramentas disponíveis

Todas as ferramentas são somente leitura. Parâmetros de localização aceitam nomes legíveis por humanos (nome de cidade ou porto), não códigos de porto, então não é necessário chamar get_ports primeiro.

Pesquisar viagens de balsa

A principal ferramenta de busca e o motor por trás da UI do Seletor de Viagens. Passe uma cadeia ordenada de 1–5 trechos: um trecho é uma busca de só ida, dois trechos onde o segundo reverte o primeiro é uma ida e volta, e qualquer coisa mais longa é uma cadeia de salto entre ilhas. Cada trecho após o primeiro deve partir de onde o trecho anterior chegou, em ordem cronológica. As opções de cada trecho são retornadas de forma independente, e os sinalizadores de disponibilidade (cabine, veículos, pets, e-ticket) são informados por segmento. Hosts que suportam apps MCP renderizam o seletor; hosts conversacionais consomem os mesmos dados estruturados.

• legs[] array, 1–5 itens
• legs[].departureLocation string
• legs[].arrivalLocation string
• legs[].departureDate string (AAAA-MM-DD) Esquema

{
  "name": "search_ferry_trips",
  "description": "Search ferry trips as an ordered chain of 1 to 5 legs (one-way, round trip, or island hopping)",
  "parameters": {
    "legs": [
      {
        "departureLocation": "string",
        "arrivalLocation": "string",
        "departureDate": "string (YYYY-MM-DD)"
      }
    ]
  }
}

Detalhes da viagem

Detalhes completos de uma única travessia, consultados por um id de opção retornado por search_ferry_trips (legs[].options[].id). Retorna horários de partida/chegada, portos e operador, especificações da embarcação, comodidades e fotos, e os níveis de acomodação reserváveis com preços. Se a embarcação não tiver especificações detalhadas, vessel.hasDetails é false e os campos de especificação são null: os dados estão indisponíveis, o que não significa que a comodidade esteja ausente.

• tripId string (de search_ferry_trips legs[].options[].id) Esquema

{
  "name": "trip_details",
  "description": "Get vessel specs, amenities, photos and accommodation options for a single sailing",
  "parameters": {
    "tripId": "string (from search_ferry_trips legs[].options[].id)"
  }
}

Obter portos

Encontre portos de balsa, marinas, terminais marítimos, IDs de porto, códigos e localizações geográficas

• — sem parâmetros Esquema

{
  "name": "get_ports",
  "description": "Find ferry ports, harbors, maritime terminals, port IDs, codes, and geographic locations"
}

Obter conexões diretas

Encontre todas as rotas diretas de balsa e portos de destino alcançáveis a partir de um porto de origem sem escalas ou transferências

• portLocation string Esquema

{
  "name": "get_direct_connections_for_ports",
  "description": "Find all direct ferry routes and reachable destination ports from a given origin port without layovers or transfers",
  "parameters": {
    "portLocation": "string"
  }
}

Obter interrupções

Encontre todas as interrupções de viagem de balsa, incluindo atrasos, alertas meteorológicos e greves para uma data e país específicos

• country string (ISO 3166-1 alpha-2, ex.: "GR")
• tripDate string (AAAA-MM-DD) Esquema

{
  "name": "get_disruptions",
  "description": "Find all ferry travel disruptions, including delays, weather alerts, and strikes for a given date and country",
  "parameters": {
    "country": "string (ISO 3166-1 alpha-2, e.g. \"GR\")",
    "tripDate": "string (YYYY-MM-DD)"
  }
}

Pesquisar viagens (obsoleto)

Mantido para integrações existentes. Prefira search_ferry_trips, que cobre esta ferramenta além da busca de ida e volta e múltiplos trechos.

• departureLocation string
• arrivalLocation string
• date string (AAAA-MM-DD) Esquema

{
  "name": "search_trips",
  "description": "Deprecated: get a list of available one-way ferry trips between two ports on a specific date",
  "parameters": {
    "departureLocation": "string",
    "arrivalLocation": "string",
    "date": "string (YYYY-MM-DD)"
  }
}

Recursos de UI

Além das ferramentas, expomos widgets de apps MCP. Hosts que suportam apps MCP os buscam para renderizar uma UI mais rica junto com a resposta da ferramenta:

search-ferry-trips-picker ui://widgets/ferry-trips-picker.html

Usado por search_ferry_trips; uma linha por trecho, o usuário escolhe uma opção para cada trecho

Exemplos de prompts

Experimente estes em qualquer assistente conectado.

Só ida“Quais balsas partem de Pireu para Egina na manhã de sábado?”

Só ida“Ajude-me a encontrar uma balsa de Ibiza para Barcelona em 11 de julho.”

Descoberta“Quero visitar uma ilha a até 3 horas de Atenas amanhã e voltar no dia seguinte, quais são minhas opções?”

Ida e volta“Planeje uma ida e volta de Pireu para Míconos, saindo em 3 de agosto e voltando em 10 de agosto.”

Salto entre ilhas“Quero fazer um salto entre ilhas Pireu → Paros → Naxos → Santorini durante a primeira semana de setembro.”

Detalhes da embarcação“A balsa que escolhi tem wifi, e pets são permitidos a bordo?”

Interrupções“Há alguma interrupção ou cancelamento de balsa na Grécia hoje?”

Instalação e configuração

O diretório de clientes MCP lista o conjunto atual de apps e agentes suportados que podem se conectar a servidores MCP, para que equipes com clientes habilitados para MCP possam integrar o Ferryhopper com configuração mínima.

Usando ChatGPT? Adicione o app Ferryhopper

O Ferryhopper está disponível como um app ChatGPT. Adicione-o com um clique, sem necessidade de URL de servidor.

Ou conecte qualquer cliente MCP manualmente:

Escolha um cliente habilitado para MCP

Exemplos de aplicativos:

Gemini CLI ChatGPT ↗ Claude.ai / Claude Desktop

Adicione o servidor Ferryhopper

Consulte a documentação deles e use a seguinte URL para conectar:

https://mcp.ferryhopper.com/mcp

Comece a planejar

Pergunte sobre rotas de balsa, horários, embarcações ou interrupções — veja os exemplos de prompts acima.