Letsfg MCP Server

@LetsFG

代码仓库

基本信息

分类

其他

传输方式

stdio

作者

LetsFG

提交者

Efistoffeles

关于 Letsfg MCP Server

Agent-native travel search. 5 second flights & hotels $50 cheaper. Free forever for the first 1000 Stargazers.

#business #framework #ai #mcp #personal #travel #flights #hotels #booking #python-sdk #flight-search #ai-agents#airline-api#ai-agent #openclaw

Letsfg MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "letsfg": {
      "command": "npx",
      "args": [
        "-y",
        "letsfg-mcp"
      ],
      "env": {
        "LETSFG_API_KEY": "your_api_key"
      }
    }
  }
}

Letsfg MCP Server 工具

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.

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.

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.

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.

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.

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

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

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.

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.

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.

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

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

概览

What is LetsFG?

LetsFG is an agent-native travel search tool that finds the cheapest flights across 75 airline connectors and enterprise GDS sources (Amadeus, Duffel, Sabre, Travelport) in roughly 5–10 seconds. It returns raw airline prices with no markup, tracking, or cookies. It is designed for AI agents (OpenClaw, Perplexity Computer, Manus, Claude Code, Codex, Cursor, Windsurf) as well as direct CLI, MCP, and SDK use.

How to use LetsFG?

Install the Python package with pip install letsfg and optionally playwright install chromium for browser-based connectors. Then run CLI commands (e.g., letsfg search-local LHR BCN 2026-04-15) or use the Python/JS SDK. For MCP integration, add the letsfg-mcp server to your MCP config. Registration for an API key is optional but recommended for access to enterprise GDS sources (400+ airlines) and booking features.

Key features of LetsFG

Searches 75 direct airline connectors and 400+ carriers via GDS/NDC sources
Returns results in ~5–10 seconds with real-time prices, no markup
Free forever for the first 1,000 stargazers (register after starring)
Works natively in AI agents via CLI, MCP, or SDK (Python, JS)
Virtual interlining builds cross‑airline round‑trips saving 30–50%
City‑wide airport expansion (e.g., LON → all London airports)

Use cases of LetsFG

An AI travel agent searching for cheapest flights across all airlines in seconds
A developer comparing flight prices programmatically without web scraping
A user booking flights directly from an AI assistant (Claude Desktop, Cursor, etc.)
A frequent traveler finding cheaper fares than OTAs like Google Flights or Expedia

常见问题

How do I install LetsFG?

Run `pip install letsfg` and then `playwright install chromium` for local connectors. No account or API key is needed for basic local search.

What dependencies or runtime does it require?

Python 3+ and Playwright for browser‑based connectors. The JS SDK and MCP server do not require Playwright.

How is LetsFG different from Google Flights or other OTAs?

LetsFG returns raw airline prices with no cookies, demand tracking, or markup. It is also faster (5–10 seconds vs 30+ seconds) and works directly inside AI agents.

Where does flight data come from?

Local connectors run on your machine and scrape airline websites directly. With an API key, the cloud backend also queries enterprise GDS/NDC providers (Amadeus, Duffel, Sabre, Travelport, Kiwi) and merges results.

What transports and authentication does LetsFG support?

CLI, Python SDK, JS SDK, and MCP. Authentication is optional – local search works without an API key; unlocking and booking require a free registered API key.

其他分类下的更多 MCP 服务器

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Lemon.io

lemon-io

Request dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3