OctoTrip Flights

Servidor MCP gratuito, sem necessidade de login, para pesquisar e comparar voos com preços em tempo real de várias companhias aéreas e plataformas de reserva ao redor do mundo.

Documentação

Servidor MCP OctoTrip Flights

Glama Score Glimind reliability Uptime

Servidor MCP gratuito, sem necessidade de login, para pesquisar e comparar voos com preços em tempo real de várias companhias aéreas e plataformas de reserva em todo o mundo.

Endpoint MCP Streamable HTTP:

https://mcp.octotrip.app/flights/mcp

Demo

Relacionados

Divulgação de Afiliados

O OctoTrip é gratuito para usar. Os links de reserva contêm atribuição de afiliado — o OctoTrip pode ganhar uma comissão sem custo adicional para você. Os resultados da pesquisa são classificados por preço dentro de cada grupo de número de paradas, não por pagamento de afiliado.

Início Rápido

Adicione à configuração do seu cliente MCP:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}

Nenhuma chave de API ou login é necessário.

Use com...

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}
Cursor / Windsurf

Adicione às suas configurações MCP:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}
Cline

Adicione às configurações MCP do Cline:

{
  "mcpServers": {
    "octotrip-flights": {
      "url": "https://mcp.octotrip.app/flights/mcp"
    }
  }
}
LobeHub

MCP Badge

OpenClaw
openclaw plugins install clawhub:@xltnapps/octotrip-flights
Smithery

Instale via Smithery:

npx -y @smithery/cli install xltnapps/octotrip-flights --client claude
Hermes Agent
hermes mcp add octotrip-flights --url https://mcp.octotrip.app/flights/mcp
hermes mcp test octotrip-flights

Ou adicione ao ~/.hermes/config.yaml:

mcp_servers:
  octotrip_flights:
    url: "https://mcp.octotrip.app/flights/mcp"
Clientes somente stdio

Para clientes MCP que suportam apenas transporte stdio:

npx mcp-remote https://mcp.octotrip.app/flights/mcp
curl / Exemplo de Protocolo

Uma sessão MCP completa usando curl (inicializar, listar ferramentas, chamar pesquisa):

# 1. Initialize
curl -s -X POST https://mcp.octotrip.app/flights/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 1, "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "example", "version": "1.0"}
    }
  }'

# 2. List tools
curl -s -X POST https://mcp.octotrip.app/flights/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 2, "method": "tools/list"}'

# 3. Search
curl -s -X POST https://mcp.octotrip.app/flights/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0", "id": 3, "method": "tools/call",
    "params": {
      "name": "search",
      "arguments": {
        "origin": "FRA",
        "destination": "BCN",
        "departure_date": "2026-08-01"
      }
    }
  }'

Transporte: HTTP streamable sem estado. As respostas usam text/event-stream (SSE). Sem persistência de sessão ou retomada. Limite de taxa: 1 requisição/segundo com capacidade de rajada de 5.

Ferramenta: search

Pesquisa ofertas de voos ao vivo entre uma origem e um destino para determinadas datas de viagem. Suporta pesquisas de ida e volta com contagens flexíveis de passageiros e classe de cabine. Retorna resultados classificados por preço, agrupados por número de paradas, mostrando as opções mais baratas de várias companhias aéreas e plataformas de reserva. A ferramenta consulta APIs externas de agregadores de voos em tempo real e inclui links de reserva de afiliados. Ela não reserva voos, modifica reservas, cobra usuários ou armazena dados do usuário.

Parâmetros

ParâmetroTipoObrigatórioPadrãoDescrição
originstringsim--Cidade de partida, nome do aeroporto ou código IATA (ex.: "Frankfurt", "JFK")
destinationstringsim--Cidade de chegada, nome do aeroporto ou código IATA
departure_datestringsim--Data de partida (AAAA-MM-DD, DD.MM.AAAA ou linguagem natural)
return_datestringnão--Data de retorno para ida e volta. Omita para somente ida
adultsinteironão1Número de passageiros adultos (1-9)
childreninteironão0Número de crianças de 2 a 11 anos (0-9)
infantsinteironão0Número de bebês menores de 2 anos (0-9)
trip_classstringnão"Y"Classe de cabine: Y para econômica, C para executiva
currencystringnão"EUR"Código de moeda ISO 4217 (EUR, USD, GBP, etc.)
localestringnão"en"Código de idioma da resposta (en, de, etc.)

Formato da Resposta

Os resultados são agrupados por número de paradas com as opções mais baratas por grupo:

{
  "results": [
    {
      "airline": "Lufthansa",
      "airline_code": "LH",
      "alliance": "Star Alliance",
      "flight_numbers": ["LH120", "LH121"],
      "is_direct": true,
      "stops": 0,
      "total_duration_minutes": 110,
      "outbound": {
        "departure": "FRA",
        "arrival": "MUC",
        "departure_time": "18:15",
        "arrival_time": "19:10",
        "departure_date": "2026-07-15",
        "arrival_date": "2026-07-15",
        "duration_minutes": 55,
        "stops": 0,
        "legs": [
          {
            "flight_number": "LH120",
            "carrier": "Lufthansa",
            "aircraft": "Airbus A319",
            "departure": "FRA",
            "arrival": "MUC",
            "departure_time": "18:15",
            "arrival_time": "19:10",
            "departure_date": "2026-07-15",
            "arrival_date": "2026-07-15",
            "duration_minutes": 55
          }
        ]
      },
      "return": { ... },
      "price": 292.39,
      "currency": "EUR",
      "baggage": "No checked bag, Cabin bag: 1 piece(s)",
      "gate": "City.Travel",
      "booking_url": "https://...",
      "link_type": "affiliate",
      "affiliate_disclosure": "This link contains affiliate attribution. OctoTrip may earn a commission at no extra cost to you.",
      "tags": ["convenient_ticket", "direct"]
    }
  ],
  "total": 6,
  "total_available": 876,
  "origin_resolved": { "iata": "FRA", "name": "Frankfurt Airport", "city": "Frankfurt am Main", "country_code": "DE" },
  "destination_resolved": { "iata": "MUC", "name": "Munich Airport", "city": "Munich", "country_code": "DE" },
  "validity": "Results and booking links are valid for approximately 15 minutes.",
  "query": { ... }
}

Validade dos Resultados

Os resultados da pesquisa e os links de reserva são válidos por aproximadamente 15 minutos. Os preços dos voos são determinados por um processo de licitação em tempo real e não são garantidos além dessa janela. Se um usuário quiser reservar, deve fazê-lo prontamente. Para resultados desatualizados, execute uma nova pesquisa.

Respostas de Erro

O servidor retorna erros estruturados com sugestões:

  • airport_not_found -- o aeroporto não pôde ser resolvido. Tente um código IATA, nome de cidade ou nome de aeroporto.
  • disambiguation_needed -- múltiplos aeroportos encontrados (ex.: "Nova York" retorna JFK, LGA). Escolha um e tente novamente.
  • invalid_date -- formato de data não reconhecido. Use AAAA-MM-DD, DD.MM.AAAA ou similar.
  • no_results -- nenhum voo disponível para os critérios fornecidos. Tente datas diferentes ou um aeroporto próximo.

Exemplos de Prompts

  • Encontre o voo direto mais barato de Nova York para Londres em agosto
  • Compare voos de Frankfurt para Munique em 15 de julho, ida e volta retornando em 22 de julho
  • Preciso de um voo somente ida de LAX para Tóquio na próxima sexta-feira, classe econômica
  • Pesquise 2 adultos e 1 criança voando de Barcelona para Paris em 1º de setembro
  • Qual é o voo de classe executiva mais barato de Dubai para Singapura neste mês?

Privacidade

Este servidor não registra endereços IP, consultas de pesquisa ou quaisquer dados identificáveis do usuário. Consulte PRIVACY.md para detalhes completos, incluindo exemplos de entradas de log.

Segurança

Para relatar uma vulnerabilidade, consulte SECURITY.md.

Licença

MIT