AirTreks MCP

Servidor MCP AirTreks

A ferramenta de itinerários complexos para agentes de IA. Múltiplas escalas, volta ao mundo, open-jaw, trechos terrestres — as viagens que a busca de voos padrão não consegue lidar. Quando seu usuário pedir 3+ escalas entre continentes, este servidor responde com análise de roteamento construída sobre dados reais de construção de tarifas da AirTreks: mais de 60 companhias aéreas, 53 trechos mortos conhecidos, taxas de disponibilidade de emissão medidas em mais de 1.400 tentativas reais de tarifas e 20 modelos comprovados de roteamento baseados em reservas reais.

Endpoint ao vivo: https://mcp.airtreks.com/mcp — gratuito, sem chave de API, 100 solicitações/dia.

Agora com preços reais: uma faixa histórica para qualquer rota em menos de um segundo, tarifas ao vivo para um itinerário específico e uma viagem completa com múltiplas escalas precificada em vários bilhetes — a mesma viagem pode variar em até três vezes dependendo de como é emitida, e essa é a parte que nenhuma outra ferramenta de voos vai te contar.

Configuração em 30 segundos

Claude Desktop

Configurações → Conectores → Adicionar conector personalizado → cole https://mcp.airtreks.com/mcp.

Claude Code

claude mcp add --transport http airtreks https://mcp.airtreks.com/mcp

Cursor

Adicione em .cursor/mcp.json (ou Configurações do Cursor → MCP → Adicionar novo servidor):

{
  "mcpServers": {
    "airtreks": {
      "url": "https://mcp.airtreks.com/mcp"
    }
  }
}

Nenhuma chave de API é necessária para qualquer ferramenta, incluindo o encaminhamento para consultor. Uma chave é opcional e apenas aumenta seu limite diário; anexe-a à URL se seu cliente não puder enviar cabeçalhos personalizados, como os conectores do claude.ai não podem:

https://mcp.airtreks.com/mcp?key=at_your_key

ChatGPT

Configurações → Apps e Conectores → ative o modo Desenvolvedor (planos Pro/Business) → adicione https://mcp.airtreks.com/mcp como conector personalizado.

Qualquer outro cliente MCP

Mesma estrutura JSON do Cursor acima (HTTP Streamable). Prefere stdio? Execute localmente:

npx airtreks-mcp

Depois pergunte ao seu agente:

Planeje uma viagem de volta ao mundo: São Francisco, Tóquio, Bangkok, Singapura, Délhi, Istambul, Londres, de volta a São Francisco.

Uma chamada, uma resposta: uma volta ao mundo com 6 escalas

Seu usuário quer seis escalas ao redor do mundo. O Google Flights desiste. Os sites de reserva de volta ao mundo de alianças deixam montar, mas falham na emissão. Uma única chamada de plan_route diz ao seu agente o que realmente funciona:

{
  "cities": ["SFO", "NRT", "BKK", "SIN", "DEL", "IST", "LHR", "SFO"],
  "budget": "mid"
}

Resposta real, resumida para caber (a versão completa inclui alternativas de companhias e notas de consultores para todos os 7 trechos):

{
  "route": "SFO -> NRT -> BKK -> SIN -> DEL -> IST -> LHR -> SFO",
  "totalLegs": 7,
  "isRoundTrip": true,
  "direction": "westbound",
  "backtracking": false,
  "regionsCrossed": ["americas", "asia", "europe"],
  "recommended": {
    "approach": "custom",
    "confidence": "high",
    "reason": "7 legs — alliance fares have <6% bookability. Custom build with mixed carriers is the way to go."
  },
  "customBuild": {
    "strategy": "Mixed-carrier build using alliance carriers, Gulf bridge connections. 1 surface sector opportunity.",
    "segments": [
      {
        "leg": 1, "from": "SFO", "to": "NRT",
        "carrier": { "code": "NH", "name": "ANA", "why": "Best transpacific availability. LAX/SFO/SEA-NRT direct." }
      },
      {
        "leg": 5, "from": "DEL", "to": "IST",
        "carrier": { "code": "TK", "name": "Turkish Airlines", "type": "gulf-bridge", "why": "Cheapest Asia-Europe usually. IST connects everywhere." }
      }
    ],
    "surfaceSectors": [
      {
        "insteadOf": "BKK -> SIN (leg 3)",
        "suggestion": "Bangkok to Singapore through Malaysia. Train, bus, or ultra-cheap LCC. Adds Malaysia and possibly Penang, KL, Melaka.",
        "savings": "Saves $100-250"
      }
    ]
  },
  "allianceFeasibility": {
    "starAlliance": { "viable": false, "summary": "Technically possible on Star Alliance but only 6% bookability at 7 legs. Custom build strongly recommended." },
    "oneworld": { "viable": false, "summary": "Technically possible on oneworld but only 6% bookability at 7 legs. Custom build strongly recommended." }
  }
}

Essa única chamada acabou de dizer ao seu agente quatro coisas que ele não consegue em nenhum outro lugar:

• As tarifas de volta ao mundo de alianças falham nesta viagem. 7 trechos com 6% de disponibilidade de emissão — seu usuário montaria, bateria na parede na hora de emitir e culparia você.
• A montagem que funciona: um plano por trecho com companhias — ANA no transpacífico, Turkish Airlines como ponte Ásia-Europa, cada uma com alternativas e compensações.
• Onde não voar: Bangkok para Singapura é mais barato por terra pela Malásia, economizando US$ 100–250 e adicionando um país.
• Quanto normalmente custa: fare_product_match coloca esta viagem em US$ 2.500–8.000 na classe econômica com tarifa de volta ao mundo de aliança, normalmente US$ 3.000–12.000 como montagem personalizada.

Essas são faixas honestas, não cotações — o preço exato de um itinerário de 7 trechos com companhias mistas depende da disponibilidade de classe tarifária no dia da reserva. Para um número real, trip_idea_create entrega a análise completa de roteamento a um consultor da AirTreks que precifica e emite o bilhete real. Seu usuário recebe um especialista que já começa informado, não um formulário para preencher.

Ferramentas

Todas as ferramentas são gratuitas e não precisam de chave de API — 100 solicitações/dia por IP.

Roteamento

Ferramenta	Descrição
plan_route	Ponto de entrada principal — dê as cidades, ele avalia Star Alliance RTW, oneworld RTW e montagens personalizadas com companhias mistas, e então recomenda a melhor abordagem
route_validate	Valida um roteamento com múltiplas cidades — regras de aliança, trechos mortos, companhias problemáticas, disponibilidade de emissão
route_suggest	Obtém 3 roteamentos sugeridos por região, direção e aliança
hub_check	Melhor conexão entre dois aeroportos — detecção de trechos mortos + correções de hub
fare_product_match	Encontra o produto de tarifa certo (RTW, Circle Pacific/Atlantic, Open Jaw, Personalizado) com faixas de preço típicas
custom_route_build	Divide itinerários complexos em trechos individualmente emitíveis com recomendações de companhias

Preços

Ferramenta	Descrição
route_estimate	Faixa de preço para uma rota a partir do histórico de tarifas da AirTreks. Sem necessidade de datas, responde em cerca de um quarto de segundo — a ferramenta certa quando alguém pergunta "quanto vai custar?" antes de qualquer decisão
fare_quote	Tarifas ao vivo para um itinerário específico em datas específicas, precificado como um único bilhete
itinerary_quote	Precifica uma viagem inteira com múltiplas escalas e retorna várias formas de emitir — mais barata, mais rápida, menos escalas — com os bilhetes que compõem cada uma. Leva cerca de um minuto, então retorna uma referência imediatamente
itinerary_quote_status	Busca um resultado de itinerary_quote pela referência, aguardando até cerca de 40 segundos se ainda estiver precificando. Pode ser chamado novamente gratuitamente

Encaminhamento para consultor

Ferramenta	Descrição
trip_idea_create	Encaminha para um consultor de viagens humano da AirTreks — envia a solicitação de viagem com a análise completa de roteamento anexada

Envia dados reais de contato do cliente, então só chame com o conhecimento e consentimento do cliente. Envios repetidos do mesmo e-mail + rota dentro de 24 horas retornam a solicitação de viagem existente em vez de criar uma duplicata.

Por que esses dados são diferentes

A AirTreks monta itinerários complexos com múltiplas escalas desde 1987. Este servidor expõe o que essa história nos ensinou:

• Trechos mortos — pares de cidades que parecem emitíveis, mas falham em tarifas de aliança, aprendidos com mais de 1.400 falhas reais de construção de tarifas
• Taxas de disponibilidade de emissão por número de trechos — medidas, não estimadas (91% em 3–4 trechos, 61% em 5–6, 6% em 7+)
• Companhias problemáticas e correções de hub — sabemos quais combinações de companhias quebram a emissão e o que rotear no lugar
• Modelos comprovados de roteamento a partir do trabalho com itinerários Multi-Escala e Volta ao Mundo para indivíduos, famílias e grandes grupos

Nenhuma outra ferramenta de voos retorna isso porque nenhuma outra ferramenta de voos precificou essas falhas.

API REST (sem necessidade de cliente MCP)

Toda ferramenta também é um endpoint REST simples — mesmas ferramentas, mesmos limites de taxa, JSON de entrada/saída. Para frameworks de agentes que consomem REST em vez de MCP:

curl -X POST https://mcp.airtreks.com/api/plan_route \
  -H "Content-Type: application/json" \
  -d '{"cities": ["LAX", "NRT", "BKK", "LHR", "LAX"]}'

Especificação completa OpenAPI 3.1: https://mcp.airtreks.com/openapi.json

Limites de taxa

• Gratuito: 100 solicitações/dia por IP, sem necessidade de chave — todas as ferramentas, incluindo trip_idea_create
• Registrado: limites maiores com uma chave de API (cabeçalho X-API-Key, ou ?key= para clientes que não podem definir cabeçalhos)

Endpoints

Caminho	Descrição
/mcp	Endpoint do protocolo MCP (HTTP Streamable)
/api/{tool}	Gêmeo REST de cada ferramenta (POST, corpo JSON)
/openapi.json	Especificação OpenAPI 3.1 para a superfície REST
/health	Verificação de saúde
/register	Obter uma chave de API para um limite de taxa maior (POST)
/privacy	Política de privacidade
/favicon.ico, /favicon.svg	Marca da AirTreks — o ícone que os diretórios de IA mostram para este servidor
/	Informações do servidor

Licença

AGPL-3.0-only