LetsFG🔥🚀✈️ — agent-native flight search & booking.

Flights & hotels $50 cheaper in 5 seconds. Not redirects — real booking flows for AI agents.

LetsFG finds the cheapest flights across the entire internet — 180 airline connectors firing in parallel + enterprise GDS sources (Amadeus, Duffel, Sabre, Travelport) — and returns results in ~5 seconds. No web scraping wait times, no browser tabs, no inflated prices, and no redirect maze. Just raw airline prices, zero markup, and booking flows that end in real airline PNRs.

Native to OpenClaw, Perplexity Computer, Manus, Claude Code, Codex, Cursor, Windsurf — any AI agent that supports CLI, MCP, or packages. Built for developers shipping personal AI assistants, coding agents, and agentic workflows that need to do more than return links.

⭐ Search is free. Booking costs the ticket price only — zero markup. Star → register → get unlimited search access forever. No trial, no catch. Booking charges the raw airline ticket price via Stripe (we add zero margin).

Demo: LetsFG vs Default Agent Search

Side-by-side comparison: default agent search (OpenClaw, Perplexity Computer) vs LetsFG CLI. Same query — LetsFG finds cheaper flights across 180 airlines in seconds.

Why LetsFG?

Flight websites inflate prices with demand tracking, cookie-based pricing, and surge markup. The same flight is often $20–$50 cheaper through LetsFG — raw airline price, zero markup.

But the bigger difference for AI builders is the workflow: most travel products for agents stop at search and send the user away through redirects. LetsFG is built so an agent can search, unlock, and book inside one structured flow — ending in a real airline PNR, not a handoff.

LetsFG works by finding the best price across the entire internet. It fires 180 airline connectors in parallel, scanning carriers across Europe, Asia, Americas, Middle East, Africa, and Oceania — then merges results with enterprise GDS/NDC sources (Amadeus, Duffel, Sabre, Travelport) that provide competitive pricing from 400+ carriers including premium airlines like Lufthansa, British Airways, and Emirates. The best price wins.

That also matters for trust: in an agent-driven world, hidden OTA margin is not just a pricing issue — it's an incentives issue. LetsFG is not in the chain to quietly tax the passenger between the airline and the assistant.

One-Click Install

pip install letsfg

That's it. You can search flights immediately — no account, no API key, no configuration:

letsfg search-local GDN BCN 2026-06-15

This runs 180 airline connectors locally on your machine and returns real-time prices. Completely free, unlimited, zero setup.

Star History

Two Ways to Use LetsFG

Option A: Local Only (Free, No API Key)

Install and search. One command, zero configuration.

pip install letsfg
letsfg search-local LHR BCN 2026-04-15

What you get:

• 180 airline connectors running on your machine (Ryanair, Wizz Air, EasyJet, Southwest, AirAsia, Norwegian, Qantas, Webjet, Traveloka, Tiket.com, and 170+ more)

• Real-time prices scraped directly from airline websites

• Virtual interlining — cross-airline round-trips that save 30–50%

• Completely free, unlimited searches

from letsfg.local import search_local

result = await search_local("GDN", "BCN", "2026-06-15")
for offer in result.offers[:5]:
    print(f"{offer.airlines[0]}: {offer.currency} {offer.price}")

Option B: With API Key (Recommended — Much Better Coverage)

One extra command unlocks the full power of LetsFG:

pip install letsfg
letsfg register --name my-agent --email you@example.com
# → Returns: trav_xxxxx... (your API key)
export LETSFG_API_KEY=trav_...

letsfg search LHR JFK 2026-04-15

What you get (in addition to everything in Option A):

• Enterprise GDS/NDC providers — Amadeus, Duffel, Sabre, Travelport, Kiwi. These are contract-only data sources that normally require enterprise agreements worth $50k+/year. LetsFG is contracted with these providers and makes their inventory available to every user.

• 400+ full-service airlines — Lufthansa, British Airways, Emirates, Singapore Airlines, ANA, Cathay Pacific, and hundreds more that don't have public APIs

• Competitive pricing — the backend aggregates offers from multiple GDS sources and picks the cheapest for each route

• Unlock & book — confirm live prices and create real airline PNRs with e-tickets

• Both local connectors AND cloud sources run simultaneously — results merged and deduplicated automatically

Registration is instant, free, and handled by CLI — an AI agent can do it in one command. The API key connects you to our closed-source backend service which maintains enterprise contracts with GDS/NDC providers and premium carriers.

⭐ Star this repo and register — unlimited search, zero-markup booking. First 1,000 stars only.

from letsfg import LetsFG

bt = LetsFG()  # reads LETSFG_API_KEY from env
flights = bt.search("LHR", "JFK", "2026-04-15")
print(f"{flights.total_results} offers, cheapest: {flights.cheapest.summary()}")

Quick Start (Full Flow)

pip install letsfg

# Register and get API key (free, instant)
letsfg register --name my-agent --email you@example.com
export LETSFG_API_KEY=trav_...

# Search (free, unlimited)
letsfg search LHR JFK 2026-04-15
letsfg search LON BCN 2026-04-01 --return 2026-04-08 --cabin M --sort price

# Unlock (confirms live price, reserves for 30 min)
letsfg unlock off_xxx

# Book
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

All commands support --json for machine-readable output:

letsfg search GDN BER 2026-03-03 --json | jq '.offers[0]'

Install

Python (recommended — includes 180 local airline connectors)

pip install letsfg
playwright install chromium  # needed for browser-based connectors

JavaScript / TypeScript (API client only)

npm install -g letsfg

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

npx letsfg-mcp

Add to your MCP config (Claude Desktop, Cursor, Windsurf, etc.):

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

That's it — search works immediately, no API key needed. The MCP server runs 180 airline connectors locally on your machine and returns real-time prices. Rate limited to 10 searches per minute.

For unlock/book functionality, add an API key:

{
  "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. Star this repo and call link_github to verify — all tools unlock forever.

5-minute quickstarts: Claude Desktop · Cursor · Windsurf

Python SDK

from letsfg import LetsFG

bt = LetsFG(api_key="trav_...")
flights = bt.search("LHR", "JFK", "2026-04-15")
print(f"{flights.total_results} offers, cheapest: {flights.cheapest.summary()}")

unlocked = bt.unlock(flights.offers[0].id)
booking = bt.book(
    offer_id=unlocked.offer_id,
    passengers=[{"id": "pas_0", "given_name": "John", "family_name": "Doe", "born_on": "1990-01-15", "gender": "m", "title": "mr"}],
    contact_email="john.doe@example.com",
)
print(f"Booked! PNR: {booking.booking_reference}")

JS SDK

import { LetsFG } from 'letsfg';

const bt = new LetsFG({ apiKey: 'trav_...' });
const flights = await bt.search('LHR', 'JFK', '2026-04-15');
console.log(`${flights.totalResults} offers`);

CLI Commands

All commands accept --json for structured output and --api-key to override the env variable.

How It Works

1. Search (free) — returns offers with full details: price, airlines, duration, stopovers, conditions

2. Unlock — confirms live price with the airline, reserves for 30 minutes

3. Book — creates real airline PNR, e-ticket sent to passenger email

Three Search Modes

MCP runs locally by default for npx letsfg-mcp — zero setup, no API key. Set LETSFG_SEARCH_MODE=cloud to use the cloud backend instead. Cloud search + local search run simultaneously in the Python SDK. Results are merged, deduplicated, currency-normalized, and sorted.

Virtual Interlining

The combo engine builds cross-airline round-trips by combining one-way fares from different carriers. A Ryanair outbound + Wizz Air return can save 30-50% vs booking a round-trip on either airline alone.

City-Wide Airport Expansion

Search a city code and LetsFG automatically searches all airports in that city. LON expands to LHR, LGW, STN, LTN, SEN, LCY. NYC expands to JFK, EWR, LGA. Works for 25+ major cities worldwide — one search covers every airport.

Architecture

┌─────────────────────────────────────────────────────┐
│  AI Agents / CLI / SDK / MCP Server                 │
├──────────────────┬──────────────────────────────────┤
│  Local connectors │  Enterprise Cloud API            │
│  (180 airlines via│  (Amadeus, Duffel, Sabre,        │
│   Playwright)     │   Travelport, Kiwi — contract-   │
│                   │   only GDS/NDC providers)        │
├──────────────────┴──────────────────────────────────┤
│            Merge + Dedup + Combo Engine              │
│            (virtual interlining, currency norm)      │
└─────────────────────────────────────────────────────┘

Local Airline Connectors (180 airlines)

The Python SDK includes 180 production-grade airline connectors — not fragile scrapers, but maintained integrations that handle each airline's specific API pattern. No API key needed for local search. Each connector uses one of three proven strategies:

Supported Airlines

Local Search (No API Key)

from letsfg.local import search_local

# Runs all relevant connectors on your machine — completely free
result = await search_local("GDN", "BCN", "2026-06-15")

# Limit browser concurrency for constrained environments
result = await search_local("GDN", "BCN", "2026-06-15", max_browsers=4)

# CLI local-only search
letsfg search-local GDN BCN 2026-06-15

# Limit browser concurrency
letsfg search-local GDN BCN 2026-06-15 --max-browsers 4

Shared Browser Infrastructure

All browser-based connectors share a common launcher (connectors/browser.py) with:

• Automatic Chrome discovery (Windows, macOS, Linux)

• Stealth headless mode (--headless=new) — undetectable by airline bot protection

• Off-screen window positioning to avoid stealing focus

• CDP persistent sessions for airlines that require cookie state

• Adaptive concurrency — automatically scales browser instances based on system RAM

• BOOSTED_BROWSER_VISIBLE=1 to show browser windows for debugging

Performance Tuning

LetsFG auto-detects your system's available RAM and scales browser concurrency accordingly:

Override auto-detection when needed:

# Environment variable (highest priority)
export LETSFG_MAX_BROWSERS=4

# CLI flag
letsfg search-local LHR BCN 2026-04-15 --max-browsers 4

# Check your system profile
letsfg system-info

# Python SDK
from letsfg import configure_max_browsers, get_system_profile

profile = get_system_profile()
print(f"RAM: {profile['ram_available_gb']:.1f} GB, Tier: {profile['tier']}, Recommended: {profile['recommended_max_browsers']}")

configure_max_browsers(4)  # explicit override

Error Handling

Packages

Documentation

API Docs

• OpenAPI spec: openapi.yaml (included in this repo)

• Interactive Swagger UI: https://api.letsfg.co/docs

• ReDoc: https://api.letsfg.co/redoc

• Agent discovery: https://api.letsfg.co/.well-known/ai-plugin.json

• Agent manifest: https://api.letsfg.co/.well-known/agent.json

• LLM instructions: https://api.letsfg.co/llms.txt

• Smithery: https://smithery.ai/servers/letsfg

Base URL: https://api.letsfg.co

Links

• PyPI: https://pypi.org/project/letsfg/

• npm (JS SDK): https://www.npmjs.com/package/letsfg

• npm (MCP): https://www.npmjs.com/package/letsfg-mcp

Contact & Partnerships

Interested in B2B integration, partnership, or bulk/enterprise access? Reach out:

• General: contact@letsfg.co

• Founder: adam@letsfg.co

We're actively looking for partners — airlines, travel platforms, AI agent builders, and anyone building on top of flight data. Don't hesitate to reach out.

Contributing

See CONTRIBUTING.md for guidelines.

Security

See SECURITY.md for our security policy.

License

Free for personal use. Search is free for everyone — no agreement needed. Commercial booking requires a 1% fee (min $1 USD) via Stripe Connect. By using the Software you agree to the LICENSE. To set up a commercial agreement, email contact@letsfg.co or adam@letsfg.co.