AirTreks MCP

Servidor MCP AirTreks

A ferramenta de itinerários complexos para agentes de IA. Múltiplas paradas, volta ao mundo, open-jaw, trechos terrestres - as viagens que a busca de voos padrão não consegue processar. Quando seu usuário pede 3 ou mais paradas entre continentes, este servidor responde com análise de roteamento baseada em dados reais de construção tarifária da AirTreks: mais de 60 companhias aéreas, 53 trechos mortos conhecidos, taxas de reservabilidade medidas a partir de mais de 1.400 tentativas reais de tarifação e 20 modelos de roteamento comprovados de reservas reais.

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

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 ao .cursor/mcp.json (ou Configurações do Cursor → MCP → Adicionar novo servidor):

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

ChatGPT

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

Qualquer outro cliente MCP

Mesmo formato JSON do Cursor acima (HTTP Transmissível). Prefere stdio? Execute localmente:

npx airtreks-mcp

Depois peça ao seu agente:

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

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

Seu usuário quer seis paradas ao redor do mundo. O Google Flights desiste. Sites de reserva de volta ao mundo de alianças permitirão que ele monte, mas depois falharão na emissão. Uma chamada ao plan_route informa ao seu agente o que realmente funciona:

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

Resposta real, resumida por tamanho (a versão completa inclui alternativas de companhias e notas de consultor para todas as 7 pernas):

{
  "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 informar ao seu agente quatro coisas que ele não consegue em nenhum outro lugar:

• Tarifas de volta ao mundo de alianças falham nesta viagem. 7 pernas com preço de 6% de reservabilidade - seu usuário montaria, esbarraria em um obstáculo na emissão e culparia você.
• A construção que funciona: um plano de companhia aérea por perna - ANA transpacífico, Turkish Airlines como ponte Ásia-Europa, cada uma com alternativas e compensações.
• Onde simplesmente não voar: Bangkok para Singapura é mais barato por terra via Malásia, economizando $100-250 e adicionando um país.
• Quanto normalmente custa: fare_product_match coloca esta viagem entre $2.500-$8.000 na econômica com tarifa de volta ao mundo de aliança, tipicamente $3.000-$12.000 como uma construção personalizada.

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

Ferramentas

Gratuito (sem chave de API, 100 req/dia)

Ferramenta	Descrição
plan_route	Ponto de entrada principal - forneça cidades, ele avalia volta ao mundo Star Alliance, volta ao mundo oneworld e construções personalizadas com múltiplas companhias, então recomenda a melhor abordagem
route_validate	Valide um roteamento multi-cidades - regras de aliança, trechos mortos, companhias problemáticas, reservabilidade
route_suggest	Obtenha 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	Combine o produto tarifário certo (Volta ao Mundo, Círculo Pacífico/Atlântico, Open Jaw, Personalizado) com faixas de preço típicas
custom_route_build	Divida itinerários complexos em segmentos individualmente tarifáveis com recomendações de companhias

Chave de API necessária

Ferramenta	Descrição
trip_idea_create	Encaminhe para um consultor humano da AirTreks - cria uma ideia de viagem no APEX com a análise completa de roteamento anexada

Obtenha uma chave: POST https://mcp.airtreks.com/register com {"email": "you@example.com"}

Por que esses dados são diferentes

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

• 53 trechos mortos - pares de cidades que parecem reserváveis, mas falham em tarifas de aliança, aprendidos com mais de 1.400 falhas reais de construção tarifária
• Taxas de reservabilidade por número de pernas - medidas, não estimadas (91% com 3-4 pernas, 61% com 5-6, 6% com 7+)
• Companhias problemáticas e correções de hub - quais combinações de companhias aéreas quebram a emissão e por onde rotear em vez disso
• 20 modelos de roteamento comprovados das principais reservas da AirTreks

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

API REST (nenhum cliente MCP necessário)

Cada ferramenta também é um endpoint REST simples - mesmas ferramentas, mesmos limites de taxa, JSON na entrada/saída. Para frameworks de agente 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 OpenAPI 3.1 completa: https://mcp.airtreks.com/openapi.json

Limites de taxa

• Gratuito: 100 solicitações/dia por IP, sem necessidade de chave
• Registrado: limites mais altos com uma chave de API (cabeçalho X-API-Key)
• trip_idea_create requer uma chave

Endpoints

Caminho	Descrição
/mcp	Endpoint do protocolo MCP (HTTP Transmissível)
/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 (POST)
/privacy	Política de privacidade
/	Informações do servidor

Licença

AGPL-3.0-only