Developer-tools MCP server
LetsFG — Flights & Hotels
Version history of discovered tools, schemas, and declared agent authority.
OBSERVED INTERFACE
Capability surface
Modelara’s observed declarations are shown separately from its derived effect classifications.
- 4
- 0
- 0
- 10
Unknown means Valyd could not determine the capability's effect confidently from the declared interface and static evidence. It is not treated as safe.
- Package
- letsfg-mcp@2026.5.79
- Registry
- npm
- Published
- Oct 17, 2026
- Integrity
sha512-+1PEL33HTWW/ZvxVzNi7q+zzgnGmcqzCM3lZBZIKSYf63dlsYqTCyTM7BW3Ovss+P1rZNgJc5HwtpBijIjb9QA==- Analyzer
- modelara v0.1.8 · policy not recorded
- Repository
- https://github.com/LetsFG/LetsFG
14 capabilities
| Capability | Type | Derived effect | First observed in Valyd coverage | Last changed |
|---|---|---|---|---|
answer_booking_questionletsfg:tool:answer_booking_questionObserved interface and hashesAnswer the question a paused booking is waiting on. get_flight_booking returns `awaiting_choice` when the booking agent has stopped mid-checkout holding a cart: at the airline's own seat map, at a paid extra it has just priced, or at a fare that moved. NOTHING PROGRESSES UNTIL YOU ANSWER, and the cart expires. Put the question to the traveller with the options and the time left, then send their answer here. kind "seat" -> seats: [{ d: "12A" }, ...] from the map you were shown, or skip: true kind "extra" -> confirm: true to take it (a bag, or a moved fare), or confirm: false / skip: true to decline Always pass the `round` from `awaiting_choice` - it says WHICH question you are answering. A return trip pauses twice, and an answer without it could seat the wrong leg. Input schemasha256:ac55efcce9fe02d214f3316199eb3a205606a801d8306cb79087ba9d0fbfb6ccOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
authenticateletsfg:tool:authenticateObserved interface and hashesExplain how to connect LetsFG so this server can search and book. Connecting is one tap at https://letsfg.co/connect and needs no card. Search works straight away. The card is asked for only at the first booking: book_flight returns an add_card_url for a 0.00 Revolut setup, nothing charged. Call with no arguments. It returns the current instructions and add_card_url. A PERSON must approve once in a browser — there is no endpoint that mints a token from card details, so do not ask the user for card numbers and do not try to automate this step. Two ways in: (a) add LetsFG as a connector (https://letsfg.co/mcp) in an assistant that supports remote MCP servers and approve it, or (b) any OAuth-capable client can register itself — see https://letsfg.co/for-agents, section "Option B". Both land on the same one-tap approval at letsfg.co/connect. RETIRED 2026-09-02: the Stripe lanes (setup_url, setup_session_id, payment_method_id, card_token) and every token they issued. Passing them now fails. This does NOT create a Developer API billing account. Do not use connect_payment for this. Input schemasha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | 2026.5.79 | |
book_flightletsfg:tool:book_flightObserved interface and hashesBook a flight from a search result. FLOW: authenticate (once) -> search_flights -> book_flight CHARGES: nothing from LetsFG. A completed booking pays the airline prices from airlines and the major booking sites. RESULT: either {"booked": true, "order_id": "..."} or {"booked": false, "booking_url": "..."} — the second means the booking genuinely did not complete and nothing was charged. That is a normal outcome, NOT a transient error: do not retry, give the user the booking_url. SAFETY: use REAL passenger details — names must match passport, email receives the e-ticket. Input schemasha256:51ab6c6d42640c7160d6c06fff223b414e27f5b7126a96334ab977018b9364d5Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
book_hotelletsfg:tool:book_hotelObserved interface and hashesBook one hotel rate. The offer's full price is HELD on the connected Revolut payment method (authorised, not taken); LetsFG books and pays the supplier; the hold is captured only once the supplier has confirmed. If the booking fails for any reason the hold is released and nothing is charged. There is no reservation fee, no deposit and no pay link. Returns a booking_job_id, NOT the booking — a booking takes minutes. Poll get_hotel_booking every ~20s until status is succeeded, failed or attention; all three are final. Copy expected_price (the offer's price), expected_cost, currency and fx_rate from the chosen offer exactly. A USD offer sent without its currency is refused (400 price_mismatch). Guest names, phone and e-mail are checked before anything is held (400 invalid_details). guests needs ONE name per guest in the room, children included — adults first, then children in child_ages order. Do NOT call book_hotel again for a booking whose job is running — poll it; a retry returns the same job (duplicate: true). Input schemasha256:ff7577fd117c6f3dfdf17042db754f4ac3bceae93f3182c91ea9f042a86d1174Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
cancel_hotel_bookingletsfg:tool:cancel_hotel_bookingObserved interface and hashesCancel a hotel booking made by this account and refund the guest. A zero-charge cancellation (a refundable rate before free_cancellation_until) refunds the charge in full; a cancellation that would cost money is refused (409) — the hotel's own ladder is in the booking terms. Takes over a minute; if it times out do NOT assume it failed — re-check before retrying. Input schemasha256:01057ae340da279e7088f3fcd89db675296b24ab3557620e38bc6dc6421bb5a1Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
connect_paymentletsfg:tool:connect_paymentObserved interface and hashes[Developer API only — you almost certainly want `authenticate` instead] Mints a one-time link for connecting a payment method to a PAID prepaid Developer API account. Nothing is charged to connect and card details never touch LetsFG: a PERSON opens the returned connect_url in a browser and saves a card, Revolut Pay or Google Pay there. Do not ask a user for card numbers and do not try to automate that step. Refuses to run unless LETSFG_API_KEY is set, because agents kept calling this and creating billing accounts they did not need. Replaced setup_payment on 2026-09-08, when the Stripe lane was retired. Input schemasha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
get_agent_profileletsfg:tool:get_agent_profileObserved interface and hashes[Developer API only] Get agent profile, balance and usage stats. Read-only. Requires LETSFG_API_KEY. A PFS Bearer token has no profile — it is bound to your payment method, carries no balance, and search and booking are free. Input schemasha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
get_flight_bookingletsfg:tool:get_flight_bookingObserved interface and hashesPoll a flight booking started by book_flight. REQUIRED to learn the outcome: on a PFS Bearer token book_flight returns a booking_ref and state "booking_in_progress", not a PNR - the booking itself takes 4-11 minutes. Call it every 20-30 s with that booking_ref until state is terminal: completed -> PNR issued, card charged failed -> the hold was released, nothing was charged needs_attention -> a human is looking at it; do NOT rebook Do not rebook while the state is still moving, and do not treat a slow poll as a failure - the money is HELD, not taken, until the airline confirms. Refs last one hour past the booking start. Input schemasha256:48f67c0bbae33bfbfc9b0686f124d910b349c255ae607452bbac579cdc652f12Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
get_hotel_bookingletsfg:tool:get_hotel_bookingObserved interface and hashesCollect the result of a booking started with book_hotel. Poll every ~20s. status is in_progress, succeeded, failed or attention; the last three are final — stop polling. - succeeded: confirmation, hotel, room, total_price + currency (what the guest is charged), supplier_paid + supplier_currency, payment_status, refundable, free_cancellation_until, cancellation_ladder and terms. - failed: error, written for the guest. The hold was released; nothing was charged. - attention: error (+ confirmation if known). The outcome could not be settled automatically; the hold is kept (nothing charged) while a person checks with the supplier. Do NOT book again. The guest is e-mailed in every case. Read-only and safe to repeat. Input schemasha256:1155fe61f31fd66a6d0e26c3ad75100a050467fac2acffa0ae57b9c0a97d816dOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
load_resourcesletsfg:tool:load_resourcesObserved interface and hashesLoad the LetsFG workflow guide (3-step booking flow, pricing, passenger rules, error handling). Call this ONCE at the start of a conversation to understand how to use the flight tools correctly. Clients that support MCP resources get this automatically — this tool is for clients that do not. Input schemasha256:3178d649f32f96ea850da50c27c062f5c20cbef86dec2f5af0587dff56ebdb67Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
resolve_hotel_cityletsfg:tool:resolve_hotel_cityObserved interface and hashesConvert a place name to the supplier city id that search_hotels needs. Always call this first if you only have a city name. Read-only and safe to repeat. Use `Id` from the first result as city_id and `Name` as city_name. Input schemasha256:1fe2f943ad42ac7ac8047306550a7cc6f7d5845c5a7a25d7636b70273f80cb3cOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
resolve_locationletsfg:tool:resolve_locationObserved interface and hashesConvert a city/airport name to IATA codes. Always call before search_flights if you only have a city name. Read-only, safe to call multiple times. Input schemasha256:39c179f46119e1ca7d89cc7eb093dfb3ba98d54fcf5674d8ad0ce1dc3ee6e64dOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed | |
search_flightsletsfg:tool:search_flightsObserved interface and hashesSearch hundreds of airlines for live flight prices — completely FREE, unlimited, read-only. Returns structured offers with prices, airlines, times, durations, and stopovers. Some offers carry `starlink` for in-flight Starlink Wi-Fi: "confirmed_all" / "confirmed_some" mean the carrier has FULLY fitted that aircraft type, "likely_all" / "likely_some" mean the rollout on that type is underway but incomplete. State only "confirmed_*" as fact; describe "likely_*" as "the airline is fitting this aircraft type, not guaranteed on your flight". Anything ending in "_some" has at least one leg WITHOUT it. An absent field means no information, NOT an absence of Wi-Fi. Covers airlines across all continents including low-cost carriers. Search is async: this tool polls for you, including waiting out the late split-ticket merge. Some offers are SPLIT TICKETS: two separately-issued tickets through a hub, each leg booked from whatever is cheapest for it (usually two different airlines), because no one seller offers the combination as a single ticket. They carry `split_ticket: "true"`, `combo_type: "virtual_interlining"` and `self_transfer: "unprotected"`. ALWAYS tell the user when an offer is a split ticket and what unprotected means: the tickets are not linked, so if the first flight is late and the connection is missed, the second airline owes nothing — no rebooking, no refund. Never present a split ticket as though it were one through-fare. Requires LETSFG_BEARER_TOKEN or LETSFG_API_KEY. See letsfg://guide resource for the full authenticate->search->book workflow. Input schemasha256:bf382bcdaf156b19910edc8bd28769f84003982fb1c30f83fd9e36fce13063fdOutput schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | 2026.5.78 | |
search_hotelsletsfg:tool:search_hotelsObserved interface and hashesSearch real, bookable hotel inventory. Requires a connected payment method — the SAME one that authorises flight booking. That applies to search too, not just booking, because a search opens a real session at the supplier. Every rate type is returned, refundable and non-refundable; each offer's `refundable` and `free_cancellation_until` say which. `price` is what the guest pays, in `currency` (USD unless you pass currency): the supplier's cost plus `markup_rate` (6.4% for Revolut Pay or an EEA card, 8.3% for a card issued outside the EEA). Nothing is added at booking. Keep the chosen offer whole — book_hotel needs its `session_id`, `combination_id_v2`, `price`, `expected_cost`, `currency` and `fx_rate`. Takes up to a few minutes. Input schemasha256:bd2a2b85cab36ae396d6fb8668910ff62daa1eedbb8c2a13ea0d320d9bdfad89Output schemaNot exposed in the analyzed interface. sha256:398b676e47d03a29016ee92fe378b8b4f1b3e965390c4c64ce78d27f79df74d1Description hash: Interface hash: Other observed Modelara metadata | tool | 2026.5.77 | No change observed |
No capabilities match these filters.
STATIC COMPARISONS
Release history
- 0 added0 removed0 schema0 write0 destructive0 unknown
- 2026.5.77 2026.5.78REVIEW0 added0 removed1 schema0 write0 destructive0 unknown