AirTreks MCP
官方AirTreks 环球旅行及复杂多程机票搜索与预订
你可以用 Air Treks MCP 做什么?
- 分析多航段路线的可行性 — 调用
plan_route并传入城市列表,获取航线分析,比较联盟环球票价与自定义混合航司方案。 - 验证现有行程 — 使用
route_validate检查多城市航线是否存在联盟规则违规、无效航段及可预订性问题。 - 按区域获取航线建议 — 请求
route_suggest提供三个预构建的航线选项,并按区域、方向和联盟偏好进行筛选。 - 检查两个机场之间的最佳连接 — 运行
hub_check检测无效航段,并获取针对特定城市对的替代枢纽连接方案。 - 将行程匹配到票价产品 — 使用
fare_product_match识别合适的票价类型(环球票、环太平洋票、缺口程票)及其典型价格范围。 - 将行程转交给人工顾问 — 调用
trip_idea_create将完整的航线分析发送给 AirTreks 专家进行定价和预订。
文档
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 格式(流式 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 密钥,每天 100 次请求)
| 工具 | 描述 |
|---|---|
plan_route | 主要入口点——提供城市信息,它会评估星空联盟环球票价、寰宇一家环球票价以及自定义混合承运人构建方案,然后推荐最佳方法 |
route_validate | 验证多城市航线——联盟规则、无效航段、问题承运人、可预订性 |
route_suggest | 按区域、方向和联盟获取 3 条建议航线 |
hub_check | 两个机场之间的最佳衔接——无效航段检测及枢纽修正 |
fare_product_match | 将合适的运价产品(环球票价、环太平洋/大西洋票价、缺口程、自定义)与典型价格范围相匹配 |
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 输入/输出。适用于使用 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 次请求,无需密钥
- 已注册: 使用 API 密钥可获得更高限制(
X-API-Key标头) trip_idea_create需要密钥
端点
| 路径 | 描述 |
|---|---|
/mcp | MCP 协议端点(流式 HTTP) |
/api/{tool} | 每个工具的 REST 对应端点(POST,JSON 正文) |
/openapi.json | REST 接口的 OpenAPI 3.1 规范 |
/health | 健康检查 |
/register | 获取 API 密钥(POST) |
/privacy | 隐私政策 |
/ | 服务器信息 |
许可证
AGPL-3.0-only