AirTreks MCP

AirTreks MCP 서버

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

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

이제 실제 가격 제공: 모든 경로의 과거 가격 범위를 1초 안에 확인하고, 특정 일정의 실시간 운임과 여러 티켓으로 나뉘어 가격이 책정된 전체 다중 경유 여정을 확인할 수 있습니다 — 동일한 여정도 발권 방식에 따라 최대 3배까지 가격이 달라질 수 있으며, 이는 다른 항공편 도구가 알려주지 않는 부분입니다.

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

컨설턴트 인계를 포함한 모든 도구에 API 키가 필요하지 않습니다. 키는 선택 사항이며 일일 한도만 높여줍니다. claude.ai 커넥터처럼 사용자 지정 헤더를 보낼 수 없는 클라이언트의 경우 URL에 추가하세요:

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

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 키가 필요하지 않습니다 — IP당 하루 100회 요청.

경로

도구	설명
plan_route	기본 진입점 - 도시를 입력하면 스타얼라이언스 세계 일주, 원월드 세계 일주, 맞춤 혼합 항공사 구성을 평가한 후 최적의 접근 방식을 추천합니다
route_validate	다중 도시 경로 검증 - 얼라이언스 규정, 데드 레그, 문제 항공사, 예약 가능률
route_suggest	지역, 방향, 얼라이언스별 추천 경로 3개 제공
hub_check	두 공항 간 최적 연결 - 데드 레그 감지 + 허브 수정
fare_product_match	일반적인 가격 범위와 함께 적합한 운임 상품(세계 일주, 서클 퍼시픽/대서양, 오픈조, 맞춤) 매칭
custom_route_build	복잡한 일정을 항공사 추천과 함께 개별 발권 가능한 구간으로 분할

가격

도구	설명
route_estimate	AirTreks 운임 이력에서 경로의 가격 범위. 날짜 불필요, 약 0.25초 내 응답 — 아무것도 결정되기 전에 "비용이 얼마일까?"라고 물을 때 적합한 도구
fare_quote	특정 날짜의 특정 일정에 대한 실시간 운임, 단일 티켓으로 가격 책정
itinerary_quote	전체 다중 경유 여정의 가격을 책정하고 여러 발권 방식을 반환 — 최저가, 최속, 최소 경유 — 각각을 구성하는 티켓 포함. 약 1분 소요되므로 참조 번호를 즉시 반환
itinerary_quote_status	참조 번호로 itinerary_quote 결과를 가져옵니다. 무료로 폴링 가능

컨설턴트 인계

도구	설명
trip_idea_create	AirTreks 인간 여행 컨설턴트에게 인계 - 전체 경로 분석이 첨부된 여행 요청 제출

실제 고객 연락처 정보를 제출하므로 고객의 인지와 동의가 있을 때만 호출하세요. 24시간 내 동일한 이메일 + 경로의 반복 제출은 중복 생성 대신 기존 여행 요청을 반환합니다.

이 데이터가 다른 이유

AirTreks는 1987년부터 복잡한 다중 경유 일정을 구축해 왔습니다. 이 서버는 그 역사에서 배운 것을 제공합니다:

• 데드 레그 - 예약 가능해 보이지만 얼라이언스 운임에서 실패하는 도시 쌍, 1,400회 이상의 실제 운임 구성 실패에서 학습
• 구간 수별 예약 가능률 - 추정이 아닌 측정값(3-4구간 91%, 5-6구간 61%, 7구간 이상 6%)
• 문제 항공사와 허브 수정 - 어떤 항공사 조합이 발권을 깨뜨리고 대신 어떤 경로로 우회해야 하는지 알고 있습니다
• 개인, 가족, 대규모 그룹을 위한 다중 경유 및 세계 일주 일정 작업에서 검증된 경로 템플릿

다른 항공편 도구는 이러한 실패에 대한 가격을 책정한 적이 없기 때문에 이 정보를 반환하지 않습니다.

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회 요청, 키 불필요 — trip_idea_create을 포함한 모든 도구
• 등록: API 키로 더 높은 한도 (X-API-Key 헤더, 또는 헤더를 설정할 수 없는 클라이언트용 ?key=)

엔드포인트

경로	설명
/mcp	MCP 프로토콜 엔드포인트 (Streamable HTTP)
/api/{tool}	각 도구의 REST 대응 (POST, JSON 본문)
/openapi.json	REST 표면용 OpenAPI 3.1 스펙
/health	상태 확인
/register	더 높은 속도 제한용 API 키 발급 (POST)
/privacy	개인정보 처리방침
/favicon.ico, /favicon.svg	AirTreks 마크 — AI 디렉토리가 이 서버에 표시하는 아이콘
/	서버 정보

라이선스

AGPL-3.0-only