← Back to directory
L

LetsFG

Official
Flight and hotel search & booking for AI agents
GitHub source repository ↗
★ 2.0k Stars Category · Other Very popular Source revision 4863ff07efba
46FMRS · D

The LetsFG MCP server gives agents free flight search and booking after a one-time zero-amount card verification, plus hotel booking that always requires a card on file and a 10% reservation fee. Key risks are the mandatory saved payment method for hotel calls, the non-refundable reservation fee, the need to poll asynchronous hotel bookings rather than retry blindly, and avoiding accidental use of the separate paid Developer API registration commands.

Reliability
8/20
Security and permissions
9/20
Maintenance
9/20
Documentation
11/20
Setup experience
9/20
Read the FMRS scoring method →

LetsFG is the upstream MCP server for the LetsFG travel product, giving AI agents search across hundreds of airlines and the major booking sites plus bookable hotel rates with free-cancellation and pay-later terms. Search and flight booking run on LetsFG's own cloud engine; access requires a one-time, zero-amount card-on-file setup (letsfg auth) that yields a 90-day Bearer token, after which flight search and booking are free with no LetsFG fee. Hotel calls — including search — require a saved payment method on every request; booking charges a 10% non-refundable reservation fee up front, with the remaining balance paid directly to the supplier via a returned pay_link. The repo also documents a separate paid Developer API (prepaid credits, direct airline booking URLs) for high-volume commercial use, but the README explicitly warns agents not to call that product's registration/payment-setup commands.

Tools

resolve_hotel_city
Resolves a city name to the city ID/name needed to search hotels.
search_hotels
Searches bookable hotel offers for a city, check-in/check-out dates, and guest count, returning only free-cancellation, pay-later rates.
book_hotel
Starts an asynchronous hotel booking for a selected offer; returns a booking_job_id rather than an immediate confirmation, since the real booking takes minutes.
get_hotel_booking
Polls a hotel booking job by ID until its status is succeeded or failed.
cancel_hotel_booking
Cancels an existing hotel booking; cost depends on whether balance_due_by has passed and the hotel's own cancellation ladder.

Setup

  1. Add to your MCP client config: {"mcpServers":{"letsfg":{"command":"npx","args":["-y","letsfg-mcp"]}}}. 2. Inside the MCP session, run letsfg auth once — a zero-amount card-on-file setup (nothing charged) that saves a 90-day Bearer token locally. 3. After that, flight search and booking work immediately with no LetsFG fee. 4. For hotel tools, ensure a valid payment method stays on file, since every hotel search and booking call requires one. 5. Only set the LETSFG_API_KEY environment variable if deliberately switching to the separate, paid Developer API — the README states most agents should not do this and should never call letsfg register or letsfg setup-payment.
claude_desktop_config.json
{"mcpServers":{"letsfg":{"command":"npx","args":["-y","letsfg-mcp"]}}}

Fit and risk

Best for

  • Individuals or developers who want to search, compare, and book flights and hotels conversationally through an agent
  • Agent workflows willing to complete a one-time, zero-amount card verification in exchange for free flight search and booking
  • Travel booking flows that specifically need free-cancellation, pay-later hotel options

Not for

  • High-volume, commercial-scale integrations wanting prepaid-credit billing (use the separate paid Developer API instead)
  • Users unwilling to keep any payment method on file, since hotel functionality mandates a saved card for every call
  • Use cases requiring guaranteed (non free-cancellation) hotel rates, since only pay-later-eligible rates are sold

Required permissions

  • Network access to letsfg.co's cloud search and booking engine
  • A saved payment method / card on file via `letsfg auth` (a zero-amount Stripe setup used to issue a 90-day Bearer token)
  • For hotel tools, a valid saved payment method required on every call, including search
  • Optional LETSFG_API_KEY secret environment variable, needed only for the paid Developer API path

Risks and side effects

  • Hotel search and booking both mandate a saved, valid card on file for every call — unusual compared to typical free search tools and worth surfacing to users before use
  • Hotel bookings charge a 10% non-refundable reservation fee that is not returned even if the booking is later cancelled
  • Hotel booking is asynchronous, returning a booking_job_id rather than a confirmation; retrying book_hotel blindly for the same rate can double-book the room and double-charge the reservation fee
  • The README explicitly warns against accidentally calling `letsfg register` / `letsfg setup-payment`, which creates a separate paid commercial billing account not intended for the normal agent flow
  • The repository's license field is listed as NOASSERTION while the README claims an MIT license, leaving the actual licensing status somewhat unclear

Troubleshooting

  1. If search or booking fails, confirm `letsfg auth` was run successfully in the MCP session and produced a valid 90-day Bearer token
  2. If hotel calls are rejected, verify a valid payment method is on file, since both hotel search and booking require a saved card
  3. After booking a hotel, poll get_hotel_booking until status is succeeded or failed rather than assuming book_hotel completes synchronously
  4. LETSFG_API_KEY is not needed for standard flight search/booking — it is only relevant to the paid Developer API
  5. If an unexpected billing account or charge appears, check whether `letsfg register` or `letsfg setup-payment` was called by mistake instead of `letsfg auth`

Use cases

Search and compare flight prices across hundreds of airlines and OTAs for an AI agent
Book a real airline PNR or get a direct booking link for a chosen flight offer
Search hotel rates in a given city with free-cancellation, pay-later terms
Book a hotel room and let the guest pay the remaining balance directly to the supplier via pay_link
Poll an asynchronous hotel booking job until it succeeds or fails

Supported clients

Claude DesktopFull support
CursorFull support
WindsurfFull support