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.

     

     

Join the community. Help others find cheaper flights. Spread the word.
⭐ Star the repo. Share with a friend ✈️

         

---

Your AI agent just learned to book flights.

Hundreds of airlines. Real prices. One function call.

LetsFG gives your AI agent flight search and booking superpowers. Our server-side engine scans the entire world for the cheapest price — free with a 90-day Bearer token, or paid with the Developer API for direct booking URLs. Zero markup. Real airline tickets.

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

CLI or scripts: Run letsfg auth (one-time Twitter/X challenge) to get a 90-day token, then letsfg search hits our cloud engine instantly. Developer API: Paid, but returns direct airline booking URLs with no per-booking fee. → Get started

GitHub stars PyPI npm Connector Health smithery badge MIT License

Supporters

Three ways to use LetsFG

• CLI / SDK (Path 1): pip install letsfg and run letsfg auth once — a 30-second Twitter/X challenge gives you a 90-day Bearer token. After that, letsfg search calls our server-side engine and applies the open-source ranking algorithm locally. Search is free and unlimited. Booking links go through letsfg.co (1% concierge fee, min $3).

• PFS — Programmatic Flight Search (Path 2): For scripts and agents that call the API directly. letsfg.co is human-only by default (Cloudflare Turnstile + bot protection). Register a 90-day Bearer token via a one-time Twitter/X challenge:

  1. POST https://letsfg.co/api/agent-access/request → get { challenge_code, tweet_text }
  2. Post the tweet from your Twitter/X account
  3. POST https://letsfg.co/api/agent-access/verify { "challenge_code": "..." } → receive your Bearer token
  4. Search: POST https://letsfg.co/api/search with Authorization: Bearer <token>

  Full guide and response schema: letsfg.co/for-agents. Search results include live flight offers with booking links via letsfg.co (1% concierge fee, min $3).

• Developer API (Path 3): Paid server-side search at letsfg.co/developers. Prepaid credits, direct airline booking URLs (no checkout step), full NL query parsing, and a /discover endpoint that checks 20 destinations in one call for 1 credit (2–5 s). Includes a free sandbox at /sandbox/flights/*. Full docs: letsfg.co/developers/api/docs.

Free server-side search: Use Path 1 or PFS — one Twitter/X challenge gives you a 90-day token and free searches on our servers. No Playwright, no local install beyond the SDK.
Direct booking URLs with no per-booking fee: Use the Developer API (Path 3) — prepaid credits, instant results, no checkout layer.

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:

$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 — Skyscanner, Kiwi, Kayak, Momondo, plus direct airline websites (Ryanair, United, Southwest, EasyJet, Spirit, Norwegian, AirAsia, and hundreds 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

Human users: Use letsfg.co and search flights instantly in your browser:

Search any route, compare live results, and unlock the booking links for the flights you want — no installation needed.

Agents / scripts (free server-side): Register a free Bearer token via a one-time Twitter/X challenge → use POST /api/search. This is PFS — Programmatic Flight Search powered by the letsfg.co engine, free for 90 days per token. See letsfg.co/for-agents for the full guide.

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

Pricing

CLI / SDK / MCP = free search. Run letsfg auth once (30-second Twitter/X challenge) and searches are free for 90 days. No credits, no Playwright. Booking links go through letsfg.co — the same 1% concierge fee (min $3) applies as on the website.

Developer API = prepaid, business use. letsfg.co/developers returns direct airline booking URLs with no per-booking fee. Monthly billing: $0.50/search for the first 10, $0.20 for 11–1,000, then $0.10/search. Resets monthly. Minimum top-up: $5.

PFS (raw API) = same as CLI but you call the API directly. Get a 90-day Bearer token via one Twitter/X challenge and call POST /api/search yourself. Purpose-built for agents (OpenClaw, Claude, GPT, etc.) that call the API directly.

💡 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

Get started

Pick where you want search to run. Local runs on your machine for free; PFS and the Developer API run on our servers.

🖥️ CLI / SDK — free, one-time auth

pip install letsfg
letsfg auth          # one-time Twitter/X challenge → 90-day Bearer token
letsfg search LHR BCN 2026-06-15

One auth step, then searches are free for 90 days — no install of browsers, no scrapers. The search runs on our servers.

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

Booking from CLI search: you get a letsfg.co booking link, not a direct airline URL. Unlock it through the letsfg.co concierge checkout (1% fee, min $3) to reveal the airline link. Want direct airline URLs with no fee? Use the Developer API below.

🐦 PFS — Programmatic Flight Search (free, server-side)

Run LetsFG's full search on our servers — no local browser, no install. Access requires a one-time Twitter/X challenge: letsfg.co is human-only (Cloudflare Turnstile), so a Bearer token is the only programmatic way in. The token is free and lasts 90 days.

# 1. Request a challenge code
curl -X POST https://letsfg.co/api/agent-access/request

# 2. Tweet the returned challenge code to @LetsFG_

# 3. Verify the tweet → receive a 90-day Bearer token
curl -X POST https://letsfg.co/api/agent-access/verify \
  -H "Content-Type: application/json" \
  -d '{"challenge_code":"<the code from step 1>"}'

# 4. Search with the token
curl -X POST https://letsfg.co/api/search \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"origin":"LHR","destination":"BCN","date_from":"2026-06-15"}'

Search is free; booking links go through letsfg.co (1% fee, min $3). Full guide and response schema: letsfg.co/for-agents.

⚡ Developer API — paid, server-side, direct booking URLs

For products and teams. Prepaid credits, results in seconds, direct airline booking URLs with no concierge fee — plus /discover (20 destinations in one call, 1 credit), async polling, NL query parsing, and a free sandbox.

# Register, then search with your API key
curl -X POST https://letsfg.co/developers/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{"agent_name":"my-agent","email":"[email protected]"}'

curl -X POST https://letsfg.co/developers/api/v1/flights/search \
  -H "X-API-Key: trav_..." \
  -H "Content-Type: application/json" \
  -d '{"origin":"LHR","destination":"BCN","date_from":"2026-06-15"}'

Pricing: $0.50/search for the first 10 each month, $0.20 for 11–1,000, $0.10 beyond. Minimum top-up $5. Test for free in the sandbox first. Full docs: letsfg.co/developers/api/docs.

# Search (free with letsfg auth token)
letsfg search LON BCN 2026-04-01 --return 2026-04-08 --sort price

# Unlock (confirms live price, holds for 30 min — 1% fee, min $3)
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 [email protected]

💡 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"]
    }
  }
}

Run letsfg auth inside the MCP session once (prints the tweet to post, then saves the token). After that, searches work immediately.

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

5-minute quickstarts: Claude Desktop · Cursor · Windsurf

Python SDK

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()}")

JavaScript 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`);

Python SDK (cloud search)

from letsfg.local import search_local

# Reads LETSFG_BEARER_TOKEN env var or ~/.letsfg/config.json (set by `letsfg auth`)
result = await search_local("GDN", "BCN", "2026-06-15")

for offer in result.offers[:5]:
    print(f"{offer.airlines[0]}: {offer.currency} {offer.price}")

Install

CLI Commands

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

How it works

CLI / SDK / MCP (free, cloud-backed)

letsfg auth (once) → Bearer token (90-day) → Search (free) → Unlock & Book via letsfg.co

1. Auth — letsfg auth runs the Twitter/X challenge: POST /api/agent-access/request → post the printed tweet → POST /api/agent-access/verify. Token saved to ~/.letsfg/config.json, valid 90 days.
2. Search — letsfg search LHR BCN 2026-06-15 calls POST https://letsfg.co/api/search, polls until done (60–90 s), and applies the open-source ranking algorithm locally.
3. Unlock & Book — booking links go through letsfg.co (1% concierge fee, min $3). Stripe card or MPP crypto accepted.

PFS — raw API (same as CLI, without the wrapper)

Twitter/X challenge → Bearer token (90-day) → POST /api/search → poll GET /api/results/<id>

1. Get a Bearer token — POST /api/agent-access/request → post the tweet → POST /api/agent-access/verify { "challenge_code": "..." }. Token valid 90 days.
2. Search — POST https://letsfg.co/api/search with Authorization: Bearer <token>. Returns { search_id }. Poll GET /api/results/<search_id> every 10 s until status: "done".
3. Unlock & Book — booking links go through letsfg.co (1% concierge fee, min $3).

Developer API — paid, direct booking URLs

Register → Fund balance → Discover or Search (credits) → Direct booking URL (no checkout)

1. Discover — POST /flights/discover with up to 20 destinations, get indicative prices sorted cheapest-first. 1 credit, 2–5 s. Use to rank options before committing to a full search.
2. Full search — POST /flights/search (blocking) or /flights/search/async (non-blocking + poll). 1 credit, 60–90 s.
3. Book — each offer includes a direct airline booking_url. No concierge fee, no checkout step.

Architecture

CLI / SDK / MCP / PFS

CLI / SDK / MCP / AI Agent
        │  Twitter/X challenge → 90-day Bearer token
        ▼
POST letsfg.co/api/search  (bot-protected, token required)
        │
        ▼
letsfg.co server-side search engine
        │
        ▼
GET /api/results/<search_id>  (poll every 10 s until done)
        │
        ▼
Ranking applied locally (sdk/js/src/ranking.ts, open-source)
        │
        ▼
Results + booking links via letsfg.co (1% fee)

Developer API

Product / Team / Agent
        │  API key + prepaid credits
        ▼
letsfg.co/developers/api/v1
  ├─ /flights/discover      (indicative prices, 20 dest, 1 credit, 2–5 s)
  ├─ /flights/search        (full search, 1 credit, 60–90 s)
  ├─ /flights/search/async  (non-blocking + poll)
  ├─ /flights/parse-query   (Gemini NL parsing, free)
  └─ /sandbox/flights/*     (fake data, same schema, free)
        │
        ▼
Direct airline booking_url — no checkout, no concierge fee

Star History