io.github.chrischall/flightaware-mcp
Live flight tracking and aviation data via FlightAware AeroAPI (flights, airports, alerts).
Versions
0.2.0latestTools 33
fa_get_airport Get details for an airport by code (ICAO like KJFK, IATA like JFK, or LID).
fa_get_airport_flights Get a flight board for an airport: all flights, or just arrivals/departures/scheduled_arrivals/scheduled_departures.
fa_list_airports List airports known to AeroAPI (paged). Use the cursor to page through.
fa_get_nearby_airports Find airports near a latitude/longitude within a radius (statute miles).
fa_get_airport_delays Get current airport delays — all delayed airports, or just one when `id` is given.
fa_get_airport_weather Get weather for an airport: current METAR observations, or the TAF forecast.
fa_get_airport_flight_counts Get current flight counts at an airport: { departed, enroute, scheduled_arrivals, scheduled_departures }.
fa_get_airport_routes Get the most popular routes (with aircraft types, counts, and filed altitudes) flown between an origin and destination airport.
fa_resolve_airport Resolve an airport code to its canonical AeroAPI identifier (and equivalents). NOTE: requires a Standard or Premium AeroAPI tier — the free Personal tier returns 401.
fa_list_alerts List the flight alerts configured on your AeroAPI account.
fa_get_alert Get a single configured flight alert by its id.
fa_create_alert Create a flight alert on your AeroAPI account. Without confirm:true this returns a dry-run preview of the request and makes NO network call; with confirm:true it creates the alert.
fa_update_alert Update an existing flight alert (replaces its configuration). Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it applies the update.
fa_delete_alert Delete a flight alert by id. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it deletes the alert.
fa_get_alerts_endpoint Get the current delivery (webhook) endpoint configured for your AeroAPI alerts.
fa_set_alerts_endpoint Set the delivery (webhook) endpoint AeroAPI POSTs alert notifications to. Without confirm:true this returns a dry-run preview and makes NO network call; with confirm:true it applies the change.
fa_get_flights Get flights for an ident — a flight designator (e.g. UAL123, AAL100), aircraft registration (e.g. N12345), or fa_flight_id. Returns recent, current, and scheduled flights for that ident.
fa_search_flights Search airborne flights using AeroAPI\'s simplified query syntax — a single string of "-key value" pairs. Keys: -prefix -type -idents -identOrReg -airline -destination -origin -originOrDestination -aboveAltitude -belowAltitude -aboveGroundspeed -belowGroundspeed -latlong "MINLAT MINLON MAXLAT MAXLON" -filter {ga|airline}. Example: -airline UAL -belowAltitude 30000
fa_search_flights_advanced Search flights using AeroAPI\'s full structured query language (more expressive than fa_search_flights). The `query` is a space-separated list of {operator key value} predicates, e.g. "{match ident UAL*} {> alt 300} {= dest KLAX}".
fa_get_flight_track Get the position track (breadcrumb log) for a specific flight by fa_flight_id.
fa_get_flight_position Get the most recent reported position for an in-air flight by fa_flight_id.
fa_get_flight_route Get the decoded route (fixes/waypoints) for a specific flight by fa_flight_id.
fa_get_flight_map Get a rendered map image (PNG) of a flight by fa_flight_id. Writes the PNG to disk (default: $AEROAPI_OUTPUT_DIR or cwd) and returns the path, or returns it inline as base64 when inline:true.
fa_get_flight_history Get historical flights for an ident (designator, registration, or fa_flight_id) beyond the recent window covered by fa_get_flights. NOTE: historical data requires a Standard or Premium AeroAPI tier — the free Personal tier returns 401.
fa_search_flight_positions Search live flight POSITIONS using the structured "{operator key value}" query language (same grammar as fa_search_flights_advanced — NOT the simplified "-key value" syntax). Returns position points rather than flight summaries. Example: {match ident UAL*} {> alt 300}.
fa_count_flights Count flights matching a query without returning the flights themselves. Returns { count }. Uses the SIMPLIFIED "-key value" syntax (same as fa_search_flights, NOT the structured grammar of fa_search_flights_advanced). Example: -airline UAL -belowAltitude 30000.
fa_resolve_flight Resolve a flight ident (designator/registration) to its canonical form and any alternate idents. NOTE: requires a Standard or Premium AeroAPI tier — the free Personal tier returns 401.
fa_get_scheduled_flights Get airline-scheduled flights between two dates (YYYY-MM-DD), optionally filtered by origin, destination, airline, or flight number.
fa_foresight_search Predictive flight search via AeroAPI Foresight (Boolean query language, like fa_search_flights_advanced, but predicted data). NOTE: Foresight is a premium tier — expect a 402/403 unless your subscription includes it.
fa_get_operator Get details for an operator (airline) by code (ICAO like UAL, or IATA like UA).
fa_get_operator_flights Get a flight board for an operator (airline): all flights, or arrivals/departures/enroute/scheduled.
fa_list_operators List operators (airlines) known to AeroAPI (paged). Use the cursor to page through.
fa_get_aircraft_owner Get the registered owner of an aircraft by tail number / registration (e.g. N12345).
Permissions 3
network medium shell high env_vars low