MCPcopy Index your code
hub / github.com/LetsFG/LetsFG

github.com/LetsFG/LetsFG @v2026.5.76

Chat with this repo
repository ↗ · DeepWiki ↗ · release v2026.5.76 ↗ · + Follow
10,266 symbols 40,518 edges 824 files 2,583 documented · 25%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

LetsFG

We're LetsFG — a community of travelers.

Finding a flight shouldn't mean checking 47 websites. Or 3 hours of searching.

Or having that feeling you could've got a better deal if you'd just waited a little longer.

So we built something about it.

No markup. No tracking. No price that goes up because you looked twice.

Star to show love    Try on letsfg.co    pip install

Follow on Instagram    Follow on TikTok    Follow on X

Join the community. Help others find cheaper flights. Spread the word.

⭐ Star the repo. Share with a friend ✈️

Share on X   Share on LinkedIn   Share on Reddit   Share on WhatsApp   Share on Telegram   Send via Email


Your AI agent just learned to book flights.

400+ airlines. Real prices. One function call.

LetsFG gives your AI agent flight search and booking superpowers. 200+ connectors fire in parallel on your machine, scanning the entire world for the cheapest price. Zero markup. Real airline tickets.

The same flight costs $20–$50 less because you skip OTA inflation, cookie tracking, and surge pricing.

GitHub stars PyPI npm Connector Health smithery badge MIT License

Supporters

Evomi - Residential Proxies $0.49/GB


Three ways to use LetsFG

Path 1 — Local (CLI / SDK / MCP-local) Path 2 — letsfg.co (website + agent API) Path 3 — Developer API
Best for Developers, personal use, agents that can run a local browser AI agents that can't run local browsers (Claude, GPT, OpenClaw, etc.), human users, zero-install Teams, products, agents that want raw offers without per-booking fees
Speed 1–15 min (local browsers) Seconds (server-side) Seconds (server-side)
Cost 100% free, unlimited Free search; booking links require 1% concierge fee (min $3) Prepaid credits, no per-booking fee
Setup pip install letsfg letsfg.co letsfg.co/developers
Runs where Your machine Our servers Our servers
Offer links Direct airline booking URLs LetsFG unlock links (pay 1% fee to receive direct airline URL) Direct airline booking URLs
  • Local (Path 1): Fires 200+ airline connectors on your machine via Playwright. Free, unlimited, no API key required. Results include offer_ref and payment_token fields. Booking links are masked by default — use the concierge flow or the Developer API to get the direct airline URL (see below).
  • letsfg.co (Path 2): Purpose-built for agents (OpenClaw, Claude, GPT, etc.) and humans who need instant results without installing anything. Search is free. To get the direct booking link, call POST https://letsfg.co/api/developers/checkout with the offer_id, offer_ref, payment_token, and price — this returns a Stripe checkout URL. After the user or agent pays the 1% fee (min $3.00), poll GET https://letsfg.co/api/developers/payment-verify?token={payment_token} until verified: true to receive the booking_url.
  • Developer API (Path 3): Server-side search at letsfg.co/developers with prepaid credits. Returns direct airline booking URLs with no concierge fee and no per-booking checkout layer. Best for teams and products at volume.

Concierge fee vs. Developer API: The 1% concierge fee (min $3) applies only when unlocking offers via the letsfg.co website or agent API (Path 2). If you want direct airline URLs without any per-booking fee, sign up for the Developer API at letsfg.co/developers.


Real prices: LetsFG vs Google Flights

We searched 5 routes on Google Flights and LetsFG on the same day (June 15, 2026). Same airline, same itinerary — LetsFG was cheaper every time:

Route Airline Google Flights LetsFG You Save
LAX → Paris (CDG) WestJet, 1 stop $723 $687 $36
Warsaw → Bali (DPS) Etihad, 1 stop $876 $842 $34
SFO → London (LHR) WestJet, 1 stop $669 $636 $33
Chicago → Miami Spirit, nonstop $120 $114 $6
London → Barcelona Vueling, nonstop $62 $56 $6
LA → New York (JFK) Frontier, 1 stop $125 $124 $1

$116 saved across 6 flights. Google Flights inflates further on repeat searches. LetsFG returns the raw airline price every time.

Why the difference? Google Flights only searches its own limited set of airline partners. LetsFG searches everywhere — 200+ connectors including Skyscanner, Kiwi, Kayak, Momondo, plus direct airline websites (Ryanair, United, Southwest, EasyJet, Spirit, Norwegian, AirAsia, and 190+ more). More sources = better prices. And unlike travel websites, LetsFG returns the raw price with zero markup, no tracking, no inflation.


Try it right now — no install needed

Don't want to install anything? Use letsfg.co and search flights instantly in your browser:

🌐 Search on letsfg.co

Search any route, compare live results, and unlock the booking links for the flights you want without installing anything.

When you're ready to integrate it into your own agent, keep reading.


Pricing

How you use it Search Unlock Book Runs where?
CLI / Python SDK / npm ✅ Free ✅ Free Ticket price only Your machine
MCP Server (local) ✅ Free ✅ Free Ticket price only Your machine
Developer API Prepaid Prepaid Ticket price only Our servers
letsfg.co ✅ Free Small one-time fee per search Ticket price only Our servers

Local = 100% free, personal use. The CLI, Python SDK, npm packages, and local MCP server run 200+ connectors covering 400+ airlines on your machine. No API key needed, no fees, no limits. Searches take 1–15 minutes depending on how many connectors run.

Developer API = prepaid, business use. letsfg.co/developers runs searches server-side — no local Playwright, no wait, results in seconds. Built for products and teams. Prepaid credits.

letsfg.co = free search + small unlock fee. Search is free, and when you unlock a search you get the booking links for all flights from that search. Purpose-built for agents (OpenClaw etc.) that can't run local browser automation.

💡 Know someone who travels? The more people discover LetsFG, the more airlines we cover — and the better it gets for everyone. ⭐ Star · Share with a friend


Why developers star this repo

Google Flights / Expedia LetsFG
Price Inflated (tracking, cookies, surge) Raw airline price. $116 cheaper across 6 verified routes.
Coverage Misses budget airlines 200+ connectors, 400+ airlines
Speed 30s+ (loading, ads, redirects) ~10 seconds
Repeat search raises price? Yes Never
Works in AI agents? No Native (CLI, MCP, SDK)
Booking Redirects to OTA checkout Real airline PNR, e-ticket to inbox
Cabin class filter No Economy, premium, business, first
Cost to you Hidden markup CLI/local: 100% free. Server: free search, 1% unlock.

Get started in 30 seconds

pip install letsfg

Search flights immediately — no API key, no registration, no account needed:

letsfg search LHR BCN 2026-06-15

That single command fires 200+ connectors on your machine and returns real-time prices from 400+ airlines. Free. Unlimited. Zero setup.

Short on time? Use --mode fast to search only OTAs + key airlines (~25 connectors, 20-40s instead of 6+ min):

letsfg search LHR BCN 2026-06-15 --mode fast

Flying business or first? Filter by cabin class — only get results that match:

letsfg search LHR JFK 2026-06-15 --cabin C    # business class
letsfg search LHR JFK 2026-06-15 --cabin F    # first class
letsfg search LHR JFK 2026-06-15 --cabin W    # premium economy

Want to unlock and book? Star the repo for free access:

# Star the repo on GitHub, then verify
letsfg star --github your-username

The CLI auto-registers behind the scenes and saves your API key to ~/.letsfg/config.json. No manual steps.

Full search → unlock → book flow

# Search (free, unlimited)
letsfg search LON BCN 2026-04-01 --return 2026-04-08 --sort price

# Unlock (confirms live price, holds for 30 min — free)
letsfg unlock off_xxx

# Book (ticket price only, zero markup)
letsfg book off_xxx \
  --passenger '{"id":"pas_0","given_name":"John","family_name":"Doe","born_on":"1990-01-15","gender":"m","title":"mr"}' \
  --email john.doe@example.com

💡 Like what you see? Support us — ⭐ Star · Share with a friend


Works everywhere your agent runs

MCP Server (Claude Desktop / Cursor / Windsurf / OpenClaw)

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

That's it — search works immediately, no API key needed. 200+ connectors covering 400+ airlines run locally.

If you cloned the repo or run the SDK locally, stay on this path. You do not need to register for the paid public developer API to use local connectors, and local searches can still feed analytics and telemetry.

Add API key for unlock/book

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

Get a key: letsfg register --name my-agent --email you@example.com

5-minute quickstarts: [Clau

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Method 6,069
Function 3,377
Class 589
Interface 228
Route 3

Languages

Python80%
TypeScript20%

Modules by API surface

website/public/developers/docs/assets/javascripts/bundle.79ae519e.min.js347 symbols
website/public/developers/docs/assets/javascripts/lunr/wordcut.js139 symbols
sdk/python/letsfg/connectors/checkout_engine.py136 symbols
sdk/python/letsfg/connectors/ancillary_live_probe.py62 symbols
website/app/results/[searchId]/ResultsPanel.tsx56 symbols
website/public/developers/docs/assets/javascripts/lunr/min/lunr.tr.min.js55 symbols
website/lib/trusted-offer.ts54 symbols
sdk/python/letsfg/connectors/engine.py50 symbols
sdk/js/src/index.ts49 symbols
sdk/python/letsfg/connectors/browser.py48 symbols
sdk/python/letsfg/connectors/scoot.py46 symbols
connectors/browser.py45 symbols

For agents

$ claude mcp add LetsFG \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page