AirTreks MCP

AirTreks MCP 서버

AI 에이전트를 위한 복잡한 여정 도구. 다구간, 세계 일주, 오픈조, 지상 구간 - 일반 항공편 검색으로는 처리할 수 없는 여행. 사용자가 대륙을 가로지르는 3개 이상의 경유지를 요청하면, 이 서버는 실제 AirTreks 운임 구성 데이터를 기반으로 구축된 경로 분석으로 답변합니다: 60개 이상의 항공사, 53개의 알려진 데드 레그, 1,400건 이상의 실제 운임 시도에서 측정된 예약 가능률, 실제 예약에서 나온 20개의 검증된 경로 템플릿.

실제 엔드포인트: https://mcp.airtreks.com/mcp - 무료, API 키 불필요, 하루 100회 요청.

30초 설정

Claude Desktop

설정 → 커넥터 → 사용자 정의 커넥터 추가 → https://mcp.airtreks.com/mcp 붙여넣기.

Claude Code

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

Cursor

.cursor/mcp.json에 추가 (또는 Cursor 설정 → MCP → 새 서버 추가):

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

ChatGPT

설정 → 앱 및 커넥터 → 개발자 모드 활성화 (Pro/Business 요금제) → https://mcp.airtreks.com/mcp를 사용자 정의 커넥터로 추가.

기타 MCP 클라이언트

위 Cursor와 동일한 JSON 형태 (Streamable HTTP). stdio를 선호하시나요? 로컬에서 실행하세요:

npx airtreks-mcp

그런 다음 에이전트에게 요청하세요:

세계 일주 여행 계획: 샌프란시스코, 도쿄, 방콕, 싱가포르, 델리, 이스탄불, 런던, 다시 샌프란시스코.

한 번의 호출, 하나의 답변: 6개 경유지 세계 일주

사용자가 전 세계 6개 경유지를 원합니다. Google Flights는 포기합니다. 얼라이언스 세계 일주 예약 사이트에서는 여정을 구성할 수 있지만, 발권 단계에서 실패합니다. plan_route 호출 한 번으로 에이전트는 실제로 작동하는 방법을 알 수 있습니다:

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

길이를 줄인 실제 응답 (전체 버전에는 7개 구간 모두에 대한 항공사 대안 및 컨설턴트 노트 포함):

{
  "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." }
  }
}

이 단일 호출로 에이전트는 다른 곳에서는 얻을 수 없는 네 가지 정보를 얻었습니다:

• 얼라이언스 세계 일주 운임은 이 여행에서 실패합니다. 7개 구간의 예약 가능률은 6%에 불과합니다. 사용자가 여정을 구성한 후 발권 단계에서 막혀 당신을 비난할 것입니다.
• 작동하는 구성: 구간별 항공사 계획 - 태평양 횡단은 ANA, 아시아-유럽 구간은 터키항공, 각각 대안과 장단점 포함.
• 비행을 피해야 할 구간: 방콕에서 싱가포르는 말레이시아를 경유하는 육로가 더 저렴하며, $100-250을 절약하고 한 국가를 추가로 방문할 수 있습니다.
• 일반적인 비용: fare_product_match에 따르면 이 여행은 얼라이언스 세계 일주 운임으로 이코노미 $2,500-$8,000, 맞춤 구성 시 일반적으로 $3,000-$12,000입니다.

이는 견적이 아닌 솔직한 범위입니다. 7개 구간 혼합 항공사 여정의 정확한 가격은 예약 당일 운임 등급 가용성에 따라 달라집니다. 실제 가격을 원한다면, trip_idea_create가 전체 경로 분석을 AirTreks 컨설턴트에게 전달하여 실제 티켓 가격을 책정하고 예약합니다. 사용자는 작성할 양식이 아닌, 정보를 갖춘 전문가를 만나게 됩니다.

도구

무료 (API 키 불필요, 하루 100회 요청)

도구	설명
plan_route	기본 진입점 - 도시를 제공하면 Star Alliance 세계 일주, oneworld 세계 일주, 맞춤형 혼합 항공사 구성을 평가하고 최적의 접근 방식을 추천합니다
route_validate	다구간 경로 검증 - 얼라이언스 규칙, 데드 레그, 문제 항공사, 예약 가능성
route_suggest	지역, 방향, 얼라이언스별로 3개의 제안 경로 제공
hub_check	두 공항 간 최적 연결 - 데드 레그 감지 및 허브 수정
fare_product_match	올바른 운임 상품 (세계 일주, Circle Pacific/Atlantic, 오픈조, 맞춤형)과 일반적인 가격대 매칭
custom_route_build	복잡한 여정을 개별 발권 가능한 구간으로 분할하고 항공사 추천 제공

API 키 필요

도구	설명
trip_idea_create	AirTreks 인간 컨설턴트에게 전달 - 전체 경로 분석이 첨부된 여행 아이디어를 APEX에 생성합니다

키 받기: POST https://mcp.airtreks.com/register ({"email": "you@example.com"} 사용)

이 데이터가 다른 이유

AirTreks는 1987년부터 복잡한 다구간 여정을 구축해 왔습니다. 이 서버는 그 역사가 가르쳐준 것을 드러냅니다:

• 53개의 데드 레그 - 예약 가능해 보이지만 얼라이언스 운임에서 실패하는 도시 쌍, 1,400건 이상의 실제 운임 구성 실패에서 학습
• 구간 수별 예약 가능률 - 추정치가 아닌 측정치 (3-4개 구간 91%, 5-6개 구간 61%, 7개 이상 6%)
• 문제 항공사 및 허브 수정 - 어떤 항공사 조합이 발권을 망가뜨리는지, 대신 어떤 경로를 이용해야 하는지
• 20개의 검증된 경로 템플릿 - 최고 AirTreks 예약에서 추출

다른 항공편 도구는 이러한 실패 사례의 가격을 책정해 본 적이 없기 때문에 이 데이터를 반환하지 않습니다.

REST API (MCP 클라이언트 불필요)

모든 도구는 일반 REST 엔드포인트로도 제공됩니다 - 동일한 도구, 동일한 속도 제한, JSON 입출력. MCP 대신 REST를 사용하는 에이전트 프레임워크용:

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

전체 OpenAPI 3.1 사양: https://mcp.airtreks.com/openapi.json

속도 제한

• 무료: IP당 하루 100회 요청, 키 불필요
• 등록: API 키 사용 시 더 높은 제한 (X-API-Key 헤더)
• trip_idea_create에는 키가 필요합니다

엔드포인트

경로	설명
/mcp	MCP 프로토콜 엔드포인트 (Streamable HTTP)
/api/{tool}	각 도구의 REST 트윈 (POST, JSON 본문)
/openapi.json	REST 표면에 대한 OpenAPI 3.1 사양
/health	상태 확인
/register	API 키 받기 (POST)
/privacy	개인정보 처리방침
/	서버 정보

라이선스

AGPL-3.0-only