← Back to directory
I

io.github.LetsFG/letsfg

Official
Flight and hotel search & booking for AI agents
GitHub source repository ↗
★ 1.6k Stars Category · Other Very popular
46FMRS · D
Reliability
8/20
Security and permissions
9/20
Maintenance
9/20
Documentation
11/20
Setup experience
9/20

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.

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