letsfg-mcp 1.0.1 → 1.0.2

package/README.md

@@ -1,6 +1,6 @@
 # letsfg-mcp
 
-The largest open flight-search MCP server. 75 ready-to-run airline connectors fire in parallel on your machine — Ryanair, EasyJet, Wizz Air, Southwest, AirAsia, and 70 more — plus enterprise GDS/NDC providers (Amadeus, Duffel, Sabre) through the LetsFG backend. One tool call scans the entire world for flights, including airlines your agent didn't know existed.
+The largest open flight-search MCP server. 102 ready-to-run airline connectors fire in parallel on your machine — Ryanair, EasyJet, Wizz Air, Southwest, AirAsia, Qantas, and 96 more — plus enterprise GDS/NDC providers (Amadeus, Duffel, Sabre) through the LetsFG backend. One tool call scans the entire world for flights, including airlines your agent didn't know existed.
 
 **Your agent doesn't need to build a flight integration. It doesn't need to scrape. Just add this MCP server and it can search and book flights in seconds.**
 
@@ -15,7 +15,7 @@ Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
 
 LetsFG is not a scraper wrapper. It's a production-grade **agent-to-airline connector layer**:
 
-- **75 airline connectors** run locally on your machine via Python + Playwright — no API key needed for search
+- **102 airline connectors** run locally on your machine via Python + Playwright — no API key needed for search
 - **Enterprise GDS/NDC feeds** (Amadeus, Duffel, Sabre, Travelport, Kiwi) run through the LetsFG backend — these are contract-only data sources that require enterprise agreements, made available to everyone through our API
 - **Virtual interlining** — the combo engine mixes one-way fares across airlines (e.g., Ryanair outbound + Wizz Air return) to find deals no single airline offers
 - **City-wide airport expansion** — search `LON` and it auto-searches LHR, LGW, STN, LTN, SEN, LCY. Works for 25+ major cities worldwide
@@ -23,7 +23,7 @@ LetsFG is not a scraper wrapper. It's a production-grade **agent-to-airline conn
 
 **Why agents should use this instead of building their own:**
 - Saves thousands of tokens vs. browser automation or scraping
-- 75 connectors fire in parallel — scans airlines across Europe, Asia, Americas, Middle East, Africa simultaneously
+- 102 connectors fire in parallel — scans airlines across Europe, Asia, Americas, Middle East, Africa, and Oceania simultaneously
 - Finds deals on carriers your agent wouldn't think to check (Lucky Air, 9 Air, Jazeera Airways, FlySafair...)
 - Enterprise-contracted GDS deals that require contracts worth $50k+/year — available for free on search
 
@@ -196,7 +196,7 @@ search_flights  →  unlock_flight_offer  →  book_flight
    (free)              (quote)              (free, creates PNR)
 ```
 
-1. `search_flights("LON", "BCN", "2026-06-15")` — returns offers with prices from 75 airlines
+1. `search_flights("LON", "BCN", "2026-06-15")` — returns offers with prices from 102 airlines
 2. `unlock_flight_offer("off_xxx")` — confirms live price with airline, reserves for 30 min
 3. `book_flight("off_xxx", passengers, email)` — creates real booking, airline sends e-ticket
 
@@ -236,7 +236,7 @@ letsfg register --name my-agent --email you@example.com
 │  letsfg-mcp  (this package, runs on YOUR machine)            │
 │     │                                                        │
 │     ├─→ Python subprocess (local connectors)                 │
-│     │     75 airline connectors via Playwright + httpx        │
+│     │     102 airline connectors via Playwright + httpx       │
 │     │     Data goes: your machine → airline website → back    │
 │     │                                                        │
 │     └─→ HTTPS to api.letsfg.co (backend)                     │
@@ -300,7 +300,7 @@ Or install globally and use `node` directly (see Windows config above).
 
 ### How do I search without an API key?
 
-Just omit `LETSFG_API_KEY` from your config. Local search (75 airline connectors) works without any key. You'll only miss the enterprise GDS/NDC sources (Amadeus, Duffel, etc.).
+Just omit `LETSFG_API_KEY` from your config. Local search (102 airline connectors) works without any key. You'll only miss the enterprise GDS/NDC sources (Amadeus, Duffel, etc.).
 
 ### Can I use this for commercial projects?
 
@@ -312,14 +312,14 @@ Ensure Node.js 18+ is installed. The server communicates via stdio (stdin/stdout
 
 ---
 
-## Supported Airlines (75 connectors)
+## Supported Airlines (102 connectors)
 
 | Region | Airlines |
 |--------|----------|
-| **Europe** | Ryanair, Wizz Air, EasyJet, Norwegian, Vueling, Eurowings, Transavia, Pegasus, Turkish Airlines, Condor, SunExpress, Volotea, Smartwings, Jet2, LOT Polish Airlines |
-| **Middle East & Africa** | Emirates, Etihad, Qatar Airways, flydubai, Air Arabia, flynas, Salam Air, Air Peace, FlySafair |
-| **Asia-Pacific** | AirAsia, IndiGo, SpiceJet, Akasa Air, Air India Express, VietJet, Cebu Pacific, Scoot, Jetstar, Peach, Spring Airlines, Lucky Air, 9 Air, Nok Air, Batik Air, Jeju Air, T'way Air, ZIPAIR, Singapore Airlines, Cathay Pacific, Malaysian Airlines, Thai Airways, Korean Air, ANA, US-Bangla, Biman Bangladesh |
-| **Americas** | American Airlines, Delta, United, Southwest, JetBlue, Alaska Airlines, Hawaiian Airlines, Sun Country, Frontier, Volaris, VivaAerobus, Allegiant, Avelo, Breeze, Flair, GOL, Azul, JetSmart, Flybondi, Porter, WestJet, LATAM, Copa, Avianca |
+| **Europe** | Ryanair, Wizz Air, EasyJet, Norwegian, Vueling, Eurowings, Transavia, Pegasus, Turkish Airlines, Condor, SunExpress, Volotea, Smartwings, Jet2, LOT Polish Airlines, Finnair, SAS, Aegean, Aer Lingus, ITA Airways, TAP Portugal, Icelandair, PLAY |
+| **Middle East & Africa** | Emirates, Etihad, Qatar Airways, flydubai, Air Arabia, flynas, Salam Air, Air Peace, FlySafair, EgyptAir, Ethiopian Airlines, Kenya Airways, Royal Air Maroc, South African Airways |
+| **Asia-Pacific** | AirAsia, IndiGo, SpiceJet, Akasa Air, Air India, Air India Express, VietJet, Cebu Pacific, Scoot, Jetstar, Peach, Spring Airlines, Lucky Air, 9 Air, Nok Air, Batik Air, Jeju Air, T'way Air, ZIPAIR, Singapore Airlines, Cathay Pacific, Malaysian Airlines, Thai Airways, Korean Air, ANA, JAL, Qantas, Virgin Australia, Bangkok Airways, Air New Zealand, Garuda Indonesia, Philippine Airlines, US-Bangla, Biman Bangladesh |
+| **Americas** | American Airlines, Delta, United, Southwest, JetBlue, Alaska Airlines, Hawaiian Airlines, Sun Country, Frontier, Volaris, VivaAerobus, Allegiant, Avelo, Breeze, Flair, GOL, Azul, JetSmart, Flybondi, Porter, WestJet, LATAM, Copa, Avianca, Air Canada, Arajet, Wingo, Sky Airline |
 | **Aggregator** | Kiwi.com (virtual interlining + LCC fallback) |
 
 ---

package/dist/index.js

@@ -100,7 +100,7 @@ var TOOLS = [
   },
   {
     name: "unlock_flight_offer",
-    description: 'Unlock a flight offer for booking \u2014 $1 proof-of-intent fee.\n\nThis is the "quote" step: confirms the latest price with the airline and reserves the offer for 30 minutes. ALWAYS call this before book_flight so the user can see the confirmed price.\n\nIf the confirmed price differs from the search price, inform the user before proceeding.\n\nRequires payment method (call setup_payment first).\n\nSAFETY: Charges $1. Not idempotent \u2014 calling twice on the same offer will charge twice.',
+    description: 'Unlock a flight offer for booking \u2014 FREE with GitHub star.\n\nThis is the "quote" step: confirms the latest price with the airline and reserves the offer for 30 minutes. ALWAYS call this before book_flight so the user can see the confirmed price.\n\nIf the confirmed price differs from the search price, inform the user before proceeding.\n\nRequires GitHub star verification (call link_github first).\n\nNot idempotent \u2014 calling twice on the same offer may process twice.',
     inputSchema: {
       type: "object",
       required: ["offer_id"],
@@ -142,7 +142,7 @@ var TOOLS = [
   },
   {
     name: "setup_payment",
-    description: "Set up payment method. Required before unlock/book. For testing use token 'tok_visa'. Only needed once.\n\nIdempotent \u2014 safe to call multiple times (updates the payment method).",
+    description: "Legacy payment setup \u2014 no longer required. Use link_github instead for free unlimited access.\n\nOnly needed if you want the old Stripe-based flow. For most users, star the GitHub repo and call link_github.",
     inputSchema: {
       type: "object",
       properties: {
@@ -158,7 +158,7 @@ var TOOLS = [
   },
   {
     name: "start_checkout",
-    description: "Automate airline checkout up to the payment page \u2014 NEVER submits payment.\n\nFLOW: search_flights \u2192 unlock_flight_offer ($1) \u2192 start_checkout\n\nUses Playwright to drive the airline website: selects flights, fills passenger details, skips extras/seats, and stops at the payment form. Returns a screenshot and booking URL so the user can complete manually in their browser.\n\nSupported airlines: Ryanair, Wizz Air, EasyJet. Other airlines return booking URL only.\n\nSAFETY: Uses fake test data by default. Never enters payment info. The checkout_token from unlock_flight_offer is required \u2014 prevents unauthorized usage.\n\nRuns locally via Python subprocess (pip install letsfg && playwright install chromium).",
+    description: "Automate airline checkout up to the payment page \u2014 NEVER submits payment.\n\nFLOW: search_flights \u2192 unlock_flight_offer \u2192 start_checkout\n\nUses Playwright to drive the airline website: selects flights, fills passenger details, skips extras/seats, and stops at the payment form. Returns a screenshot and booking URL so the user can complete manually in their browser.\n\nSupported airlines: Ryanair, Wizz Air, EasyJet. Other airlines return booking URL only.\n\nSAFETY: Uses fake test data by default. Never enters payment info. The checkout_token from unlock_flight_offer is required \u2014 prevents unauthorized usage.\n\nRuns locally via Python subprocess (pip install letsfg && playwright install chromium).",
     inputSchema: {
       type: "object",
       required: ["offer_id", "checkout_token"],
@@ -184,6 +184,17 @@ var TOOLS = [
       }
     }
   },
+  {
+    name: "link_github",
+    description: 'Link your GitHub account for FREE unlimited access \u2014 star the repo and verify.\n\nFLOW: 1) User stars https://github.com/LetsFG/LetsFG  2) Call this tool with their GitHub username\n\nOnce verified, the user gets unlimited search, unlock, and booking forever.\nOnly needs to be called once. If already verified, returns confirmation.\n\nIf status is "star_required", the user needs to star the repo first, then try again.',
+    inputSchema: {
+      type: "object",
+      required: ["github_username"],
+      properties: {
+        github_username: { type: "string", description: "User's GitHub username (e.g., 'octocat')" }
+      }
+    }
+  },
   {
     name: "system_info",
     description: "Get system resource info (RAM, CPU cores) and recommended concurrency settings.\n\nUse this to determine optimal max_browsers value for search_flights. Returns RAM total/available, CPU cores, recommended max browsers, and performance tier.\n\nTiers: minimal (<2GB, max 2), low (2-4GB, max 3), moderate (4-8GB, max 5), standard (8-16GB, max 8), high (16-32GB, max 12), maximum (32+GB, max 16).\n\nRead-only, no side effects, instant response.",
@@ -260,6 +271,10 @@ async function callTool(name, args) {
       const result = await apiRequest("POST", "/api/v1/bookings/unlock", { offer_id: args.offer_id });
       return JSON.stringify(result, null, 2);
     }
+    case "link_github": {
+      const result = await apiRequest("POST", `/api/v1/agents/link-github?github_username=${encodeURIComponent(args.github_username)}`, {});
+      return JSON.stringify(result, null, 2);
+    }
     case "book_flight": {
       const body = {
         offer_id: args.offer_id,

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "letsfg-mcp",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "mcpName": "io.github.Efistoffeles/letsfg",
-  "description": "LetsFG MCP Server — 75 airline connectors run locally + enterprise GDS/NDC APIs. Flight search & booking for Claude, Cursor, Windsurf, and any MCP-compatible AI agent.",
+  "description": "LetsFG MCP Server — 102 airline connectors run locally + enterprise GDS/NDC APIs. Flight search & booking for Claude, Cursor, Windsurf, and any MCP-compatible AI agent.",
   "main": "dist/index.js",
   "bin": {
     "letsfg-mcp": "dist/index.js"