# FlightAware MCP > FlightAware MCP connects your AI agent directly to global aviation data. It lets you track real-time flight movements, check airport arrivals and departures, analyze historical flight paths dating back to 2011, and pull up detailed aircraft specifications—all through natural conversation. ## Overview - **Category:** the-unthinkable - **Price:** Free - **Tags:** flight-tracking, aviation-intelligence, airport-operations, real-time-data, historical-flight-data, ads-b ## Description Stop jumping between dedicated tracking websites and parsing complex data feeds just to figure out if a connection is going to make. This MCP gives your AI client full access to the world's flight status grid, turning complicated aviation queries into simple conversations. You ask what's happening at JFK, and it tells you everything: real-time weather, gate changes, whether the plane is delayed, or even how far out its scheduled arrival is. It doesn't just give you a list of flights; it acts like an operations coordinator. If you need to plan around disruptions, check competitor fleet movements, or analyze if a specific route has been reliable historically, this MCP handles it all. By connecting through Vinkius, your agent gets immediate access to hundreds of other specialized tools, making it the single hub for almost any kind of data lookup. ## Tools ### get_aircraft_info Retrieves detailed specifications, ownership data, and type information for a given aircraft tail number or registration. ### get_airport_arrivals Lists all inbound flights arriving at a specified airport with their estimated times, assigned gates, and current status. ### get_airport_departures Lists all outbound flights leaving a specific airport, including scheduled departure times, destination airports, and gate information. ### search_flights Finds active or recent flight data using a flight number, tail number, or by specifying the route between two airports. ### get_airport_info Provides static details like coordinates, ICAO codes, and timezone information for any airport. ### get_airport_routes Identifies common flight paths, typical altitudes, and frequency of use between two specified airports. ### get_airport_weather Returns current METAR weather reports and future TAF forecasts for a specific airport location. ### get_flight_map Generates a static image map showing the filed route, actual track points, and current position of an airborne flight. ### get_flight_route Returns the structured list of waypoints, airways, and fixes that make up a specific flight's planned path. ### get_flight_status Gathers all detailed operational status information for a known flight, including gate assignments, pushback times, and delay reasons. ### get_historical_flights Accesses complete historical tracking data for any specific flight, including its entire track log and performance metrics from 2011 onward. ### get_operator_flights Lists all active flights currently operated by a specific airline or operator code. ## Prompt Examples **Prompt:** ``` Search for all active United Airlines flights from Newark (KEWR) to San Francisco (KSFO). ``` **Response:** ``` Searching FlightAware... I found 5 active United flights on the KEWR-KSFO route today: UA123 (Boeing 737-900, departed KEWR 08:15 EST, en-route at FL370, ETA KSFO 11:42 PST), UA456 (Boeing 757-200, departed 10:30 EST, en-route at FL350, ETA 14:05 PST), UA789 (Airbus A320, departed 13:45 EST, currently climbing through FL280, ETA 17:18 PST), UA234 (Boeing 737-MAX 9, scheduled departure 16:20 EST), and UA567 (Boeing 787-9, scheduled 19:00 EST). Would you like detailed gate and terminal information for any of these flights? ``` **Prompt:** ``` What is the current weather at Chicago O'Hare (KORD) and are flights being delayed due to conditions? ``` **Response:** ``` Checking KORD weather and flight status... Current METAR observation at Chicago O'Hare: Wind 270 degrees at 18 knots gusting to 28, visibility 6 statute miles in light snow, broken clouds at 2500 feet, overcast at 4000 feet, temperature minus 4 Celsius, dewpoint minus 8, altimeter 29.87 inches Hg. Reviewing arrivals and departures: I'm seeing average delays of 25-40 minutes for inbound flights due to low ceiling and gusty crosswind conditions on runways 10L/28R. Several flights have been diverted to alternate airports (MDW, RFD). Outbound flights are experiencing similar delays with ground stops imposed periodically. Would you like me to monitor specific flights for you? ``` **Prompt:** ``` Show me the complete flight history and track points for British Airways flight BAW117 from London to New York yesterday. ``` **Response:** ``` Retrieving historical flight data for BAW117... Flight BAW117 (Boeing 777-300ER, registration G-STBF) departed London Heathrow (EGLL) at 2025-04-08 10:12 UTC (scheduled 10:05 UTC, 7 minutes early) from Terminal 5 Gate A12. The flight tracked westbound across the North Atlantic via the NATS track system, filing route: KONAN L607 RESNO 52N020W 52N030W 51N040W 50N050W 49N060W J547 CAM J753 MERIT. Cruising altitude FL380 with average ground speed 485 knots. Arrived New York JFK (KJFK) at 2025-04-08 13:28 UTC (scheduled 13:45 UTC, 17 minutes early) at Terminal 7 Gate 1. Total flight time: 7 hours 16 minutes. Complete track log contains 432 position points. Would you like me to generate a route map or analyze performance metrics for this crossing? ``` ## Capabilities ### Search and track active flights You can find real-time tracking information for a flight using its number, tail number, or origin and destination pair. ### Monitor airport activity The MCP provides live lists of both inbound arrivals and outbound departures at any major airport. ### Determine operational status You can pull detailed information on a specific flight, including its gate assignment, expected times, and current delay reasons. ### Assess weather impacts It retrieves current METAR reports and future TAF forecasts for any airport to gauge potential operational delays. ### Analyze flight history The MCP accesses continuous historical data, showing the full path and performance metrics of flights over years. ## Use Cases ### Coordinating ground transport for delayed passengers A client asks, 'What's happening with my connection at JFK?' Your agent runs `get_airport_arrivals` to confirm the delay and then uses `search_flights` to find alternative connections. It replies instantly with a timeline, saving you from manual lookups. ### Investigating competitor fleet movement An operations manager needs to know if a rival airline is running more flights today. They ask the MCP to list all operational flights for that carrier using `get_operator_flights`, giving them an immediate competitive overview. ### Preparing a flight briefing package Before a meeting, you need background on a route's typical performance. You ask the MCP to retrieve common routes between two points using `get_airport_routes` and check historical reliability via `get_historical_flights`, all in one query. ### Troubleshooting flight path anomalies A pilot notices a discrepancy. They ask the MCP to compare the filed plan with reality using `get_flight_route` and check the current position via `search_flights`. The AI agent flags where the actual track deviates from the planned route. ## Benefits - Get immediate operational details for a known flight. Instead of checking multiple sites for gate assignments or delay reasons, you ask your agent and get complete data using `get_flight_status`. - Analyze long-term performance trends. Use `get_historical_flights` to pull track points and timing data from years past. This helps prove if a route is consistently reliable or prone to seasonal issues. - Plan around weather impacts instantly. Check the current forecast using `get_airport_weather` before sending out any flight plan, knowing exactly what kind of wind shear or visibility restrictions you're dealing with. - Understand aircraft deep down. Need to know who owns a specific tail number? Use `get_aircraft_info` to get manufacturer specs and registration data without leaving your workflow. - Visualize the journey automatically. If someone asks 'Where is it?', you don't send a link; you use `get_flight_map` to generate an embedded static image of the current flight path. ## How It Works The bottom line is you talk to your AI client like talking to an operations manager; it handles all the complex API calls behind the scenes. 1. Subscribe to this MCP on Vinkius and enter your FlightAware AeroAPI key from the Developer Portal. 2. Connect your preferred AI client, like Cursor or Claude, to the Vinkius catalog using that API key. 3. Ask your agent a natural language question, such as 'What's the weather at KORD?' or 'Where is flight UA123 right now.' The MCP processes the query and returns structured aviation data. ## Frequently Asked Questions **How do I use the FlightAware MCP to check if a flight is delayed?** You should use `get_flight_status`. This tool returns detailed operational data, including any delay indicators and the specific reason for the schedule change. **Does the FlightAware MCP provide live weather updates for airports?** Yes. Use `get_airport_weather` to get current METAR observations and future TAF forecasts, which is critical for assessing operational impact. **Can I track a flight's full history using the FlightAware MCP?** Absolutely. The `get_historical_flights` tool lets you access continuous data dating back to 2011, giving you the complete track points and performance records. **What is the difference between searching by tail number and using search_flights?** Use `get_aircraft_info` if you only want specs on a specific tail number (like N12345). Use `search_flights` when you need to know where that aircraft currently is or what flights it's involved in. **Can the FlightAware MCP tell me about common routes between cities?** Yes, use `get_airport_routes`. It provides route strings and frequency of use for major flight paths connecting two specific airports.