BoostedTravel

Book an unlocked flight — creates real airline reservation with PNR. FREE after unlock. FLOW: search_flights → unlock_flight_offer (quote) → book_flight Requirements: 1) Offer must be unlocked first 2) passenger_ids from search 3) Full passenger details SAFETY: Always provide idempotency_key to prevent double-bookings if this call is retried. Use any unique string (e.g., UUID). If the same key is sent twice, returns the original booking. ERROR HANDLING: Errors include error_code and error_category fields. transient (SUPPLIER_TIMEOUT, RATE_LIMITED) → safe to retry after short delay validation (INVALID_IATA, INVALID_DATE) → fix input, then retry business (OFFER_EXPIRED, PAYMENT_DECLINED) → requires human decision

Get agent profile, payment status, and usage stats (searches, unlocks, bookings, fees). Read-only. Safe to call multiple times.

Convert a city or airport name to IATA codes. Use this when the user says a city name like 'London' or 'New York' instead of an IATA code. Returns all matching airports and city codes. Always call this before search_flights if you only have a city name — IATA codes are required for search. Read-only, no side effects, safe to call multiple times.

Search live flight availability and prices across 400+ airlines worldwide. Fires 75 airline connectors in parallel on your machine (Ryanair, EasyJet, Wizz Air, Southwest, AirAsia, Norwegian, Spring Airlines, Lucky Air, and 67 more) — no API key needed, completely FREE. Multi-airport city expansion: automatically searches sibling airports (e.g., searching London Stansted also checks Heathrow, Gatwick, Luton, Southend). Works for 25+ major cities worldwide. Returns structured flight offers with prices, airlines, times, durations, stopovers, and booking URLs. Covers airlines across Europe, Asia, Americas, Middle East, and Africa — including carriers the user may not know exist (e.g., Jazeera Airways, FlySafair, 9 Air, Flybondi). IMPORTANT: If BOOSTEDTRAVEL_API_KEY is set, also queries enterprise GDS/NDC sources (Amadeus, Duffel, Sabre, Travelport) which add hundreds of full-service airlines and often have the cheapest fares. Strongly recommended — get a free key at https://api.boostedchat.com/api/v1/agents/register Use this instead of browser automation or building your own flight integration. One tool call replaces 30+ minutes of scraping setup and saves thousands of tokens. Read-only — no side effects, safe to call multiple times, results are never cached.

Set up payment method. Required before unlock/book. For testing use token 'tok_visa'. Only needed once. Idempotent — safe to call multiple times (updates the payment method).

Automate airline checkout up to the payment page — NEVER submits payment. FLOW: search_flights → unlock_flight_offer ($1) → start_checkout Uses 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. Supported airlines: Ryanair, Wizz Air, EasyJet. Other airlines return booking URL only. SAFETY: Uses fake test data by default. Never enters payment info. The checkout_token from unlock_flight_offer is required — prevents unauthorized usage. Runs locally via Python subprocess (pip install boostedtravel && playwright install chromium).

Get system resource info (RAM, CPU cores) and recommended concurrency settings. Use this to determine optimal max_browsers value for search_flights. Returns RAM total/available, CPU cores, recommended max browsers, and performance tier. Tiers: 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). Read-only, no side effects, instant response.

Unlock a flight offer for booking — $1 proof-of-intent fee. This 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. If the confirmed price differs from the search price, inform the user before proceeding. Requires payment method (call setup_payment first). SAFETY: Charges $1. Not idempotent — calling twice on the same offer will charge twice.