适合谁
- 希望在对话中直接搜索、比较并预订机票和酒店的个人或开发者
- 愿意接受一次性、零金额信用卡验证以换取免费机票搜索与预订的代理场景
- 需要免费取消、延后付款酒店选项的旅行预订流程
I
46FMRS · D
LetsFG MCP 服务器为 AI 代理提供了机票与酒店的搜索、预订能力，机票通过一次性零金额验证即可免费使用，酒店预订则始终需要在档付款方式并收取 10% 预订费。主要风险集中在酒店流程对已保存信用卡的强制要求、预订费不可退、异步预订状态需要轮询，以及需要避免误用面向商业客户的付费 Developer API 注册流程。
LetsFG 是官方 MCP 服务器，让 AI 代理能够搜索数百家航空公司和主要订票网站的机票，并预订带有免费取消和延后付款条款的酒店房源。搜索在 LetsFG 的云端服务器上运行；机票预订通过一次性、零金额的信用卡设置（letsfg auth）完成，之后 90 天内搜索和预订均免费，不收取 LetsFG 手续费。酒店预订需在每次调用（包括搜索）时都提供已保存的付款方式，预订时收取房价 10% 的不可退还预订费，剩余余额通过返回的 pay_link 直接付给酒店。该仓库还包含一个独立的付费 Developer API（预付额度、直接航司预订链接），但 README 明确提示代理不要调用该产品的注册/设置付款命令，因为那属于另一套面向高交易量商业集成的计费账户。
工具能力
resolve_hotel_city
将城市名称解析为搜索酒店所需的城市 ID 和名称。
search_hotels
按城市、入住/离店日期和入住人数搜索可预订的酒店房价（仅限免费取消、延后付款的费率）。
book_hotel
为指定的酒店房价发起异步预订；返回 booking_job_id，需轮询查询最终结果，而非直接返回预订确认。
get_hotel_booking
根据 booking_job_id 轮询酒店预订任务状态，直至返回 succeeded 或 failed。
cancel_hotel_booking
取消已创建的酒店预订；取消费用取决于是否已过 balance_due_by 日期及酒店自身的取消阶梯政策。
安装接入
- 在 MCP 客户端配置中添加：{"mcpServers":{"letsfg":{"command":"npx","args":["-y","letsfg-mcp"]}}}。2. 首次在 MCP 会话中运行 letsfg auth 完成一次性、零金额的信用卡设置（不产生实际扣款），获取 90 天有效的 Bearer 令牌，令牌保存在本地配置中。3. 之后即可直接调用搜索与预订工具，机票搜索和预订免费（不收 LetsFG 手续费）；如需使用酒店功能，请确保账户已保存有效付款方式，因为每次酒店搜索和预订调用都要求有卡在档。4. 如需改用付费的 Developer API（面向高交易量商业场景），可设置 LETSFG_API_KEY 环境变量，但 README 明确说明大多数代理不需要该产品，且不要调用 letsfg register 或 letsfg setup-payment。
claude_desktop_config.json
{"mcpServers":{"letsfg":{"command":"npx","args":["-y","letsfg-mcp"]}}}
选型与风险
不适合谁
- 需要大批量、高频次调用并希望采用预付额度计费的商业级集成（应使用单独的付费 Developer API）
- 不愿意在账户中保存任何付款方式的用户（酒店功能强制要求已保存的卡）
- 需要保证型价格（非免费取消/延后付款）酒店房源的场景，因为该服务器只出售可安全延后结算的费率
所需权限
- 网络访问 letsfg.co 云端搜索与预订服务
- 通过 letsfg auth 在账户上保存一份信用卡/付款方式（零金额 Stripe 设置，用于生成 90 天 Bearer 令牌）
- 酒店功能要求每次调用（含搜索）都有已保存的有效付款方式
- 可选的 LETSFG_API_KEY 环境变量（密钥类型），仅在使用付费 Developer API 时需要
风险与副作用
- 酒店搜索和预订都强制要求已保存有效信用卡，这一点与常规免费搜索工具不同，需要用户或代理提前理解并同意
- 酒店预订收取房价 10% 的不可退还预订费，即使后续取消该费用也不会退还
- 酒店预订是异步的，返回的是 booking_job_id 而非确认结果；重复调用 book_hotel 可能导致重复预订并重复扣除预订费
- README 特别警告不要误调用 letsfg register / letsfg setup-payment，这会创建另一套付费商业账户，代理应严格区分免费的 letsfg auth 流程与付费 Developer API 流程
- 仓库许可证字段为 NOASSERTION，与 README 中声称的 MIT 开源许可存在不一致，实际授权状态不完全明确
常见排障
- 若搜索或预订失败，确认已在 MCP 会话中成功运行过 letsfg auth 并生成了有效的 90 天 Bearer 令牌
- 若酒店调用被拒绝，检查账户是否已保存有效付款方式，因为搜索和预订均需要在档信用卡
- 预订酒店后应轮询 get_hotel_booking 直至状态变为 succeeded 或 failed，不要假设 book_hotel 调用后立即完成
- 如果只做机票搜索与预订，不需要设置 LETSFG_API_KEY；该变量仅用于付费 Developer API
- 如遇到意外产生的商业账户或计费信息，检查是否误调用了 letsfg register 或 letsfg setup-payment 命令
使用场景
让 AI 代理跨数百家航空公司和 OTA 比价并搜索机票
为代理生成的行程预订真实航空公司 PNR 或获取直接预订链接
搜索指定城市中提供免费取消、延后付款条款的酒店房源
预订酒店房间并通过 pay_link 让客人直接向酒店支付余款
轮询查询酒店预订任务的最终状态
支持客户端
Claude Desktop完整支持
Cursor完整支持
Windsurf完整支持