# LetsFG — Flights & Hotels (npm · letsfg-mcp)

Search and book flights and hotels: hundreds of airlines, plus bookable hotel rates.

- Trust score: 72/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- remote · `letsfg.co`: 38/100, [markdown](https://verifymcp.io/servers/letsfg-letsfg/developers-api-mcp.md), [page](https://verifymcp.io/servers/letsfg-letsfg/developers-api-mcp)
- npm · `letsfg-mcp`: 72/100 (this document), [markdown](https://verifymcp.io/servers/letsfg-letsfg/letsfg-mcp.md), [page](https://verifymcp.io/servers/letsfg-letsfg/letsfg-mcp)

## Channel facts

- Registry: `npm`
- Package: `letsfg-mcp`
- Version: `2026.5.77`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - No production dependencies, so there is no dependency health to assess.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 5 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 79/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 3169 tokens (~211/item across 15 items; 14 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 29/100
  - Stability check failed: the tool surface changed between 2026.5.75 and 2026.5.77: 2 tool removals, 1 breaking changes, 2 additions.
- **Tool Coverage**: 97/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 91% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 14 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 15 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### How do I install the LetsFG — Flights & Hotels MCP server?

LetsFG — Flights & Hotels runs locally as an npm package, launched with npx -y letsfg-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add letsfg-letsfg -- npx -y letsfg-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "letsfg-letsfg": {
      "command": "npx",
      "args": [
        "-y",
        "letsfg-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "letsfg-letsfg": {
      "command": "npx",
      "args": [
        "-y",
        "letsfg-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add letsfg-letsfg -- npx -y letsfg-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "letsfg-letsfg": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "letsfg-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add letsfg-letsfg --command npx --arg -y --arg letsfg-mcp
```

### Hermes

```yaml
mcp_servers:
  letsfg-letsfg:
    command: "npx"
    args: ["-y", "letsfg-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "letsfg-letsfg": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "letsfg-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add letsfg-letsfg -t stdio -c npx -a -y letsfg-mcp
```

### Other

```json
{
  "mcpServers": {
    "letsfg-letsfg": {
      "command": "npx",
      "args": [
        "-y",
        "letsfg-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-19 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 22 to 25.

### 2026-09-17 (score 71, +1)

No change was recorded against any check on this day. Stability & Change Management went from 15 to 19.

### 2026-09-15 (score 70, +26)

- [security improvement] Malware scan: unverified → pass
- [security improvement] Known CVEs: unverified → pass
- [functional improvement] Dependency health: unverified → pass

### 2026-09-14 (score 44, −25)

- [security regression] Stability: unverified → fail
- [security regression] Malware scan: pass → unverified
- [security regression] Known CVEs: pass → unverified
- [security regression] Tool safety: pass → unverified
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [functional regression] Schema quality: 170 → 211
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Dependency health: pass → unverified
- [functional improvement] Stability: unverified → 0.27
- [functional] Package version: 2026.5.75 → 2026.5.77

### 2026-09-07 (score 69, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-09-06 (score 54)

First indexed and scored.

## MCP tools (14)

### `search_flights` (~565 tokens)

Search 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 parameters:

- `adults` (integer): Number of adults (default: 1)
- `cabin_class` (string): M=economy, W=premium, C=business, F=first
- `children` (integer): Number of children (2-11)
- `currency` (string): Currency code (EUR, USD, GBP)
- `date_from` (string, required): Departure date YYYY-MM-DD
- `departure_time_from` (string): Earliest departure time HH:MM (e.g., '06:00')
- `departure_time_to` (string): Latest departure time HH:MM (e.g., '14:00')
- `destination` (string, required): IATA code of arrival (e.g., 'BCN', 'LAX')
- `max_results` (integer): Max offers to return
- `origin` (string, required): IATA code of departure (e.g., 'LON', 'JFK'). Use resolve_location if you only have a name.
- `return_from` (string): Return date YYYY-MM-DD (omit for one-way)

### `resolve_location` (~62 tokens)

Convert 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 parameters:

- `query` (string, required): City or airport name (e.g., 'London', 'Berlin')

### `book_flight` (~225 tokens)

Book 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 parameters:

- `contact_email` (string, required): Booking contact email
- `idempotency_key` (string): Unique key to prevent double-bookings on retry (e.g., UUID). Strongly recommended.
- `offer_id` (string, required): Offer ID from search_flights
- `passengers` (array, required): Passengers with 'id' from search passenger_ids
- `search_id` (string, required): search_id from search_flights

### `get_flight_booking` (~180 tokens)

Poll 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 parameters:

- `booking_ref` (string, required): The booking_ref book_flight returned

### `answer_booking_question` (~310 tokens)

Answer 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 parameters:

- `booking_ref` (string, required): The booking_ref book_flight returned
- `confirm` (boolean): kind "extra" only: take it (true) or decline (false).
- `kind` (string, required): From awaiting_choice.kind
- `round` (number, required): From awaiting_choice.round. Required.
- `seats` (array): kind "seat" only: the chosen seats, e.g. [{ "d": "12A" }].
- `skip` (boolean): Decline outright — no seat, no extra.

### `resolve_hotel_city` (~82 tokens)

Convert 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 parameters:

- `text` (string, required): Place name (e.g., 'Warsaw', 'Paris')

### `search_hotels` (~338 tokens)

Search 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 parameters:

- `adults` (number): Adult guests (default 2)
- `check_in` (string, required): yyyy-MM-dd
- `check_out` (string, required): yyyy-MM-dd
- `child_ages` (array): Age of each child; the supplier needs these to price
- `children` (number): Child guests (default 0)
- `city_id` (number, required): From resolve_hotel_city (`Id`)
- `city_name` (string, required): From resolve_hotel_city (`Name`)
- `currency` (string): ISO code every price is quoted in (default USD)
- `limit` (number): Max hotels to return (default 40)
- `nationality` (string): Two-letter guest nationality. Rates and taxes genuinely differ by it.

### `book_hotel` (~594 tokens)

Book 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 parameters:

- `adults` (number): Adults in the room, as searched (default 2)
- `check_in` (string, required): yyyy-MM-dd
- `check_out` (string, required): yyyy-MM-dd
- `city_id` (number, required)
- `city_name` (string, required)
- `combination_id` (number): From the chosen offer (optional)
- `combination_id_v2` (string, required): From the chosen offer — identifies that exact rate
- `currency` (string): The offer's `currency`, verbatim (omitted means PLN)
- `email` (string, required): The guest's e-mail: the confirmation, or a note that it did not go through, goes here.
- `expected_cost` (number, required): The offer's `expected_cost` (supplier cost, PLN), verbatim
- `expected_price` (number, required): The offer's `price`, verbatim
- `fx_rate` (number): The offer's `fx_rate`, verbatim (omit for a PLN offer)
- `guests` (array, required): ONE entry per guest in the room, children included: adults first, then children in the child_ages order used in search_hotels (the party travels with the offer's session). Each is {title, first_name,…
- `hotel_code` (number, required): From the chosen hotel
- `hotel_name` (string)
- `idempotency_key` (string): Optional. A retry with the same key returns the booking already under way
- `phone` (string, required)
- `phone_country_code` (string): Default '48'
- `session_id` (string, required): The chosen offer's session_id
- `special_requests` (array)

### `get_hotel_booking` (~177 tokens)

Collect 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 parameters:

- `booking_job_id` (string, required): From book_hotel

### `cancel_hotel_booking` (~98 tokens)

Cancel 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 parameters:

- `confirmation` (string, required): From the completed booking

### `authenticate` (~229 tokens)

Explain how to connect a card so this server can search and book. Nothing is charged to connect — a 0.00 Revolut setup that saves the card so a booking can be charged later.

Call with no arguments. It returns the current instructions and add_card_url (https://letsfg.co/connect). 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 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 card screen.

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.

### `connect_payment` (~142 tokens)

[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.

### `get_agent_profile` (~62 tokens)

[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.

### `load_resources` (~66 tokens)

Load 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.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/letsfg-letsfg/letsfg-mcp#diagnostics

## Score history

- 2026-09-20: 72
- 2026-09-19: 72
- 2026-09-18: 71
- 2026-09-17: 71
- 2026-09-16: 70
- 2026-09-15: 70
- 2026-09-14: 44
- 2026-09-13: 69
- 2026-09-12: 69
- 2026-09-11: 69
- 2026-09-10: 69
- 2026-09-09: 69
- 2026-09-08: 69
- 2026-09-07: 69
- 2026-09-06: 54

## Common questions

### What is the LetsFG — Flights & Hotels MCP server?

LetsFG — Flights & Hotels is an MCP server listed in the public MCP registry as io.github.LetsFG/letsfg. Search and book flights and hotels: hundreds of airlines, plus bookable hotel rates. This page covers its npm package (letsfg-mcp).

### Is the LetsFG — Flights & Hotels MCP server safe to use?

LetsFG — Flights & Hotels scores 72 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the LetsFG — Flights & Hotels MCP server expose?

LetsFG — Flights & Hotels exposes 14 tools: search_flights, resolve_location, book_flight, get_flight_booking, answer_booking_question, and 9 more. Their descriptions and schemas cost roughly 3,130 tokens of context every time the server is loaded.

### Is the LetsFG — Flights & Hotels MCP server still maintained?

LetsFG — Flights & Hotels is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the LetsFG — Flights & Hotels MCP server under?

LetsFG — Flights & Hotels declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/letsfg-mcp
- Socket report: https://socket.dev/npm/package/letsfg-mcp
- Repository: https://github.com/LetsFG/LetsFG
- Website: https://letsfg.co/
- Changelog RSS feed: https://verifymcp.io/servers/letsfg-letsfg/letsfg-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/letsfg-letsfg/letsfg-mcp.json
- HTML version of this page: https://verifymcp.io/servers/letsfg-letsfg/letsfg-mcp