AirTreks MCP

官方

AirTreks 环球旅行及复杂多程机票搜索与预订

你可以用 AirTreks MCP 做什么?

  • 规划复杂多段路线 — 提出包含3个以上中途停留的行程,plan_route 会评估联盟环球票价、自定义混合承运商组合,并推荐最佳方案及每段航段的承运商选择。
  • 验证路线可行性 — 使用 route_validate 在确认前,对照联盟规则、空驶航段、禁用承运商及可预订率,检查多城市计划。
  • 获取即时价格区间 — route_estimate 可在不到一秒内返回任意路线的历史票价区间,无需日期,非常适合早期“这大概要花多少钱?”的询问。
  • 比较出票策略 — itinerary_quote 以多种方式(最便宜、最快、经停最少)为完整多段行程报价,并显示每种方案所使用的机票。
  • 转交给人工专家 — trip_idea_create 将完整的路线分析提交给 AirTreks 顾问进行实际定价和预订,并在24小时内进行重复检测。

文档

AirTreks MCP 服务器

smithery badge

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

所有工具均无需 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 站环球行程

你的用户想要环游世界六个站点。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%——你的用户会构建行程,然后在出票时碰壁,最后怪罪于你。
  • 可行的方案: 逐段选择航空公司的计划——全日空跨太平洋,土耳其航空作为亚欧桥梁,每段都有备选方案和权衡。
  • 完全不必飞行的路段: 曼谷到新加坡经马来西亚陆路更便宜,可节省 100-250 美元,还能多游一个国家。
  • 通常的费用: fare_product_match 显示此行程乘坐联盟环球机票经济舱约为 2,500-8,000 美元,定制构建通常为 3,000-12,000 美元。

这些是诚实的区间,而非报价——7 段混合航空公司的具体价格取决于预订当天的舱位 availability。如需确切数字,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 运价历史获取航线的价格区间。无需日期,约四分之一秒即可返回结果——当有人在做任何决定前问"这要花多少钱?"时,这是最合适的工具
fare_quote查询特定日期特定行程的实时票价,按单张机票计价
itinerary_quote为整个多程停留行程定价,返回多种出票方式——最便宜、最快、停留最少——以及每种方式所基于的机票组合。约需一分钟,因此会立即返回一个参考号
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 输入/输出。适用于使用 REST 而非 MCP 的代理框架:

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= 用于无法设置请求头的客户端)

端点

路径描述
/mcpMCP 协议端点(Streamable HTTP)
/api/{tool}每个工具的 REST 对应端点(POST,JSON 请求体)
/openapi.jsonREST 接口的 OpenAPI 3.1 规范
/health健康检查
/register获取 API 密钥以提高速率限制(POST)
/privacy隐私政策
/favicon.ico、/favicon.svgAirTreks 标志——AI 目录为此服务器显示的图标
/服务器信息

许可证

AGPL-3.0-only