# BoostedTravel [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/Boosted-Chat/BoostedTravel  
**GitHub Stars:** 2052  
**npm Downloads (last month):** 2515  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/boostedtravel

## Description
Flight search & booking for AI agents. 400+ airlines, $20-50 cheaper than OTAs.

## Tools
Capabilities this server exposes over MCP:

- **search_flights** — 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.
- **resolve_location** — 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.
- **unlock_flight_offer** — [Developer API only] Confirm live price with the airline and reserve the offer for 30 minutes.

NOT part of the agent flow and NOT needed before book_flight. It requires LETSFG_API_KEY (the paid, prepaid Developer API) and refuses to run on a Bearer token, because the PFS unlock endpoint does not exist — calling it that way used to 404.

If you authenticated with `letsfg auth`, go straight from search_flights to book_flight.

Requires a Developer API key. Legacy path — not idempotent.
- **book_flight** — 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.
- **get_flight_booking** — 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.
- **resolve_hotel_city** — 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.
- **search_hotels** — Search real, bookable hotel inventory. Requires a payment method on file — the SAME card that authorises flight booking. That applies to search too, not just booking, because a search opens a real session at the supplier.

Only free-cancellation, pay-later rates are returned, so everything you see can actually be booked on these terms. The result set is smaller than a metasearch and that is deliberate.

`price` is what the guest pays. Keep `session_id` and the chosen offer's `combination_id_v2` — together they identify that exact rate, and book_hotel needs both. Takes up to a few minutes.
- **book_hotel** — Book one hotel rate. Charges 5% of the price to the card on file immediately as a NON-REFUNDABLE reservation fee; the balance is paid directly to the supplier through the pay link we return, by balance_due_by (the supplier's own auto-cancellation date).

Returns a booking_job_id, NOT the booking — a booking takes minutes. Poll get_hotel_booking until status is succeeded or failed.

The fee is charged BEFORE the room is committed, so a declined card costs nothing: no reservation exists and nothing is charged.

Send expected_price and expected_balance back exactly as search returned them. NOT idempotent — calling twice for the same rate books the room twice and charges two fees.
- **get_hotel_booking** — Collect the result of a booking started with book_hotel. Poll every ~20s.

status is in_progress, succeeded or failed. On success you get confirmation, reservation_fee_charged, pay_link, balance_due, balance_due_by and the full cancellation ladder. Read-only and safe to repeat.
- **cancel_hotel_booking** — Release a hotel reservation. Free until balance_due_by; after that the hotel's own ladder applies and can reach 100%. The ladder is in the booking terms, so check the cost first.

The 5% reservation fee is NOT refunded. Takes over a minute; if it times out do NOT assume it failed — re-check before retrying.
- **authenticate** — 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 setup_payment for this.
- **setup_payment** — [Developer API only — you almost certainly want `authenticate` instead] Attaches a card to a PAID prepaid Developer API account. Refuses to run unless LETSFG_API_KEY is set, because agents kept calling this and creating billing accounts they did not need.
- **get_agent_profile** — [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** — 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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `LETSFG_BEARER_TOKEN`, `LETSFG_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What BoostedTravel MCP server does

The BoostedTravel MCP server connects an AI agent to live flight and hotel inventory. Flight searches return structured offers containing prices, airlines, schedules, durations, stopovers, and other itinerary details. Coverage includes airlines across all continents, including low-cost carriers. Hotel searches return real, bookable inventory, but only free-cancellation, pay-later rates are included.

The service supports both discovery and booking. Agents can search flights, reserve or book an offer, poll booking progress, search hotels, book a selected room, retrieve the final hotel result, and cancel a hotel reservation. It also provides location-resolution tools for converting city or airport names into the identifiers required by search calls.

## How it works

The BoostedTravel MCP server uses asynchronous workflows for searches and bookings. Before a flight search, resolve a city name to an IATA code with `resolve_location`. Flight search itself waits for the provider response, including delayed split-ticket processing. If an offer has `split_ticket: "true"`, the agent must clearly explain that the itinerary contains separately issued tickets and an unprotected connection. A missed connection caused by a late first flight does not obligate the second airline to rebook or refund the passenger.

The normal flight path is authenticate, search, and book. A bearer-token booking may return `booking_in_progress` with a `booking_ref`; poll `get_flight_booking` every 20–30 seconds until the state is `completed`, `failed`, or `needs_attention`. Do not rebook while the status is changing. A `booking_url` from `book_flight` means no booking completed and no charge was made, so it should be given to the user rather than retried automatically.

Hotel operations have a similar sequence: resolve the supplier city, search, book, and poll `get_hotel_booking`. Hotel booking returns a job identifier rather than an immediate confirmation. The reservation fee is charged before the room is committed, while the remaining balance is paid to the supplier through the returned payment link.

## Setup and configuration

Set either `LETSFG_BEARER_TOKEN` or `LETSFG_API_KEY`. A bearer token is intended for the standard agent flow; the Developer API key enables Developer API-only operations such as offer unlocking, profile access, and prepaid API billing. `unlock_flight_offer` is a legacy Developer API path and is not part of the normal bearer-token booking flow.

The `authenticate` tool explains how to connect a card and returns the current connection instructions plus an approval URL. A person must approve the card connection in a browser. Agents must not request or automate entry of card numbers. Connecting the card does not charge the user, but the same card is required for hotel searches and flight bookings.

The service can also be used as a hosted MCP endpoint, so local installation is not required for the documented agent setup. The README also lists `letsfg` for Python and `letsfg-mcp` for npm, but the supplied material does not specify a directly runnable local server command.

## Tools and capabilities

- Resolve airport, city, and hotel-supplier locations.
- Search live flights across hundreds of airlines.
- Inspect Starlink indicators when present; `confirmed_*` values indicate confirmed fitting, while `likely_*` values indicate an incomplete rollout that is not guaranteed on the selected flight.
- Book flights and poll delayed booking outcomes.
- Search, book, poll, and cancel hotel reservations.
- Load the travel workflow guide through the MCP resource or `load_resources`.

## Limitations and notes

Flight booking uses real passenger information, and passenger names must match passports. Hotel booking is not idempotent: repeating a successful call can create another reservation and charge another fee. Hotel cancellation is free until the supplier deadline, but the 5% reservation fee is not refunded; after the deadline, the supplier's cancellation ladder can apply.

The Stripe setup fields and tokens described as retired on September 2, 2026 must not be used. The current card connection flow is handled through `authenticate` and the browser approval process.

_Full upstream README: https://allmcps.com/mcp/boostedtravel/readme_