List the user's flights from Flighty. Does NOT include friends' flights (use flighty_list_friend_flights for that).

Filtering:

• No filter: returns ALL flights (upcoming + past), sorted by departure date descending (most recent first)

• upcoming_only=true: only flights with future departures, sorted soonest first — the first result is the user's next flight

• year=2025: only flights from that year, sorted descending (matches the app's past-by-year view)

NOTE: upcoming_only only returns flights that have not yet departed. For the user's current travel context (in-progress flights, recently landed, about to depart), use flighty_current_flights instead.

All timestamps are UTC.

Get detailed information about a single specific flight. Look up by either internal flight ID (UUID) or by flight number (e.g. "UA194").

Provide exactly one of flight_id or flight_number. If flight_number is provided and the user has flown that route multiple times, returns only the MOST RECENT instance. To see all instances, use flighty_search_flights with the airline filter instead.

All timestamps are UTC. Returns a single flight object, or null if not found.

Search the user's flight history by airline, departure/arrival airports, or date range. All filters are optional and combine with AND logic.

Results sorted by departure date descending (most recent first). All timestamps are UTC.

Airport filters match by IATA code (exact, case-insensitive) OR by city name (partial, case-insensitive). Airline filter matches by IATA code (exact) OR airline name (partial).

Get the user's current travel context — flights departing within 24 hours in either direction from now. This captures in-progress flights, flights about to depart, and recently landed flights.

Use this when the user asks about their current flight, current trip, what gate they arrive at, baggage claim, layovers, or anything related to active travel. Use flighty_list_flights with upcoming_only=true for future travel planning instead.

Sorted by departure time ascending (earliest first). All timestamps are UTC.

Get the current operational status of a flight already in the user's Flighty database, including delay information, gate assignments, weather, and aircraft details. This only works for flights the user has added to Flighty. Looks up the MOST RECENT instance of the given flight number.

Status values: "scheduled", "delayed" (departure delay > 15 min), "in_air" (departed but not arrived), "landed", or "cancelled".

Data freshness depends on the Flighty app's last sync — this does NOT make live API calls. All timestamps are UTC.

Returns: flight_number, status, is_cancelled, departure/arrival airports, scheduled/estimated/actual times, delay minutes, gate info, weather, aircraft.

Get historical delay statistics for a flight already in the user's Flighty database — how often it is early, on-time, late, cancelled, or diverted. This data is attached by Flighty when a flight is added to the user's account. It cannot look up forecasts for arbitrary flights not in the database.

Looks up the MOST RECENT instance of the flight to retrieve its stored delay forecast data. All timestamps are UTC.

Returns: flight_number, route (e.g. "SFO -> EWR"), observations (sample size), mean_delay_minutes, and percentage breakdowns (early_pct, ontime_pct, late_15/30/45_pct, cancelled_pct, diverted_pct). Returns null if no forecast data is available.

List flights belonging to the user's connected friends in Flighty. Excludes the user's own flights (use flighty_list_flights for those).

Same filtering as flighty_list_flights:

• No filter: all friend flights, sorted descending (most recent first)

• upcoming_only=true: future flights only, sorted soonest first — the first result is the friend's next flight

• year=2025: flights from that year, sorted descending

All timestamps are UTC. Returns the same flight schema as flighty_list_flights, plus a friend_name field.

Search the Flighty airport database by IATA code, ICAO code, airport name, or city name. Sorted by relevance (major airports first).

Returns: id, name, iata, icao, city, country, countryCode, timeZoneIdentifier, latitude, longitude, website.

Search the Flighty airline database by IATA code, ICAO code, airline name, or alliance. Sorted by relevance.

Returns: id, name, iata, icao, alliance, website, callsign, formattedPhone.

Get aggregate statistics about the user's flight history: total flights, distance traveled, unique airports and airlines, top routes, and top airlines. Optionally filter to a specific year.

Includes all flights (past and upcoming). Distance is provided in both kilometers and miles.

Get layover/connection information for the user's flights. Shows pairs of connecting flights, the connection airport, layover duration, and minimum connection time.

Results sorted by the first leg's departure time descending (most recent first). All timestamps are UTC.

Returns: id, inbound_flight (first leg, e.g. "AA1449"), from_airport, connection_airport, connection_airport_name, outbound_flight (second leg, e.g. "AA1166"), to_airport, arrival_time, departure_time, layover_minutes, min_connection_time_min.

Add a flight to the user's Flighty account by flight code and date. The flight is registered with Flighty's server and syncs to all devices (phone, watch, etc.) within seconds.

The airline is detected from the flight code prefix (e.g. "DL" from "DL10"). The Flighty API provides full enrichment: gate assignments, weather, equipment, delay forecast, codeshare partners.

This tool calls the Flighty API — it requires the Flighty app to be installed and signed in.

Returns the server-side flight UUID on success.

Remove a flight from the user's Flighty account. The flight is deleted from the server and the deletion syncs to all devices.

Provide the flight UUID (from flighty_list_flights or flighty_add_flight results). This is the server-side UUID, not the flight number.

WARNING: This permanently removes the flight from your Flighty account across all devices. This cannot be undone — you would need to re-add the flight.

Returns version, author, and capability information about this Flighty MCP server.