AirTreks MCP
官方AirTreks 环球旅行及复杂多程机票搜索与预订
你可以用 AirTreks MCP 做什么?
- 规划复杂多段路线 — 提出包含3个以上中途停留的行程,
plan_route会评估联盟环球票价、自定义混合承运商组合,并推荐最佳方案及每段航段的承运商选择。 - 验证路线可行性 — 使用
route_validate在确认前,对照联盟规则、空驶航段、禁用承运商及可预订率,检查多城市计划。 - 获取即时价格区间 —
route_estimate可在不到一秒内返回任意路线的历史票价区间,无需日期,非常适合早期“这大概要花多少钱?”的询问。 - 比较出票策略 —
itinerary_quote以多种方式(最便宜、最快、经停最少)为完整多段行程报价,并显示每种方案所使用的机票。 - 转交给人工专家 —
trip_idea_create将完整的路线分析提交给 AirTreks 顾问进行实际定价和预订,并在24小时内进行重复检测。
文档
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"
}
}
}
所有工具均无需 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=用于无法设置请求头的客户端)
端点
| 路径 | 描述 |
|---|---|
/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