# FlightAware MCP

> FlightAware MCP connects your agent to global aviation intelligence. You get real-time flight tracking, airport operations data, weather forecasts (METAR/TAF), and detailed aircraft telemetry by simply asking natural language questions.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** flight-tracking, aviation-data, airport-status, weather-reports, aircraft-info

## Description

This connector gives you deep access to worldwide aviation data without opening a browser tab or running complex scripts. Need to know if a cargo plane is delayed because of bad weather? Or maybe you just want the planned route for an international flight? You can get that information, and much more, directly from your agent. By connecting this MCP via Vinkius, you bring professional-grade aviation intelligence into your existing workflow, whether you're using Claude or Cursor. It handles everything from current weather observations at major hubs to historical flight paths of specific aircraft. Just ask for the data; it arrives ready for you to analyze.

## Tools

### get_aircraft
Retrieves specific identifying details about a particular aircraft model or registration.

### get_operator_flights
Retrieves all current and upcoming flight schedules associated with a specific airline operator.

### get_operator
Looks up general details regarding an airline or operating company.

### get_airport_flights
Lists all currently scheduled and active flights moving through a specified airport code.

### get_airport_weather
Fetches current weather reports (METAR) and forecasts (TAF) for a given airport location.

### get_flight_route
Calculates and shows the intended sequence of waypoints for a specific flight path.

### get_flight_track
Provides the precise position history, or 'track,' data points for an aircraft's past movement.

### get_flights
Gets current and scheduled flight information using a common identifier like a flight number.

## Prompt Examples

**Prompt:** 
```
Track flight SWA1234 and show me its current status.
```

**Response:** 
```
I've retrieved the data for SWA1234. It is currently airborne, flying from Dallas (DAL) to Austin (AUS). Current altitude is 24,000 ft with an estimated arrival in 15 minutes.
```

**Prompt:** 
```
What is the weather and forecast for London Heathrow (EGLL)?
```

**Response:** 
```
The current METAR for EGLL shows winds from 270 at 10kts, visibility 10km+, and scattered clouds at 3,000ft. The TAF forecast indicates clear conditions continuing for the next 6 hours.
```

**Prompt:** 
```
Show me the planned route for flight DLH400.
```

**Response:** 
```
The planned route for DLH400 (Frankfurt to New York) includes waypoints: OBOKA L607 SPI UT420 TNT. It is scheduled to fly at a cruise altitude of FL340.
```

## Capabilities

### Check real-time flight status
Retrieve the current location, altitude, and estimated arrival time for any active or scheduled flight.

### Monitor airport activity
Get a list of all incoming and outgoing flights at a specific airport using its ICAO or IATA code.

### Analyze weather conditions
Fetch current METAR reports and future TAF forecasts to gauge potential flight disruptions.

### Determine aircraft details
Look up specific information, like ownership or operator status, for any given aircraft type.

### Map flight paths and tracks
Visualize the planned route waypoints or review the actual position history (the track) of a past flight.

## Use Cases

### Client needs immediate flight updates
A travel agent asks their AI client to track a flight number. The agent uses `get_flights` and immediately reports the current altitude, destination, and estimated arrival time without needing to open a dedicated tracking website.

### Planning for remote industrial site access
An operations manager needs to know if cargo flights are clear. They prompt their agent using `get_airport_flights` for the local hub, getting immediate confirmation on congestion and scheduled departures.

### Investigating flight anomalies
A researcher wants to understand why a plane deviated from its planned path. They run `get_flight_route` first, then use `get_flight_track` to compare the expected waypoints against the actual position history.

### Checking operational readiness
A logistics team needs to know if an airport is cleared for operations. They run `get_airport_weather` first, checking both METAR and TAF data, ensuring no adverse conditions will ground the flight.

## Benefits

- Stop switching between tracking sites. You can check real-time status and historical data for a flight using the `get_flights` tool directly within your agent chat.
- Don't guess about airport conditions. Use `get_airport_weather` to pull current METAR reports and TAF forecasts, letting you plan around bad weather before you leave home.
- Need to verify who owns an aircraft? The `get_aircraft` tool lets you look up ownership details immediately, giving context that simple flight tracking misses.
- Forget piecing together schedules. Use `get_operator_flights` to see every current and upcoming trip for a specific airline in one place.
- You can track movement over time by using the `get_flight_track` tool, which shows the precise path an aircraft took instead of just its last known coordinate.

## How It Works

The bottom line is you ask a question about air travel; the MCP pulls the specific aviation data needed from FlightAware and presents it directly to your agent.

1. First, connect your AI client to this MCP on Vinkius and provide the necessary FlightAware AeroAPI key.
2. Next, prompt your agent with natural language instructions—for example, 'What's the weather at LAX?' or 'Track flight UA987.'
3. The system then executes the relevant tools, gathering global data points and returning a coherent, actionable answer to your client.

## Frequently Asked Questions

**How do I use the get_airport_weather tool with FlightAware MCP?**
You simply ask your agent for the weather at a specific airport code (e.g., 'What is the METAR for EGLL?'). The system handles fetching current conditions and future forecasts automatically.

**Can I find out if an airline operator has flights coming soon using get_operator_flights?**
Yes. Use `get_operator_flights` and provide the name of the airline or operator you're interested in, and the MCP will retrieve all scheduled upcoming trips for that company.

**What difference is there between get_flight_route and get_flight_track?**
The planned route shows where a flight *should* go (the waypoints). The track shows where the aircraft *actually was*, giving you historical position data.

**How do I check general details about an airplane using get_aircraft?**
Provide the specific model or registration number of the aircraft, and `get_aircraft` returns details like ownership and type information.

**What are the rate limits when querying for multiple flights using get_flights?**
The API enforces specific query quotas based on your subscription tier. You'll receive a 429 error code if you exceed these limits, so always build in exponential backoff logic.

**How do I authenticate my account before using get_airport_flights?**
You must provide your unique FlightAware AeroAPI key during the setup process. This key authenticates all calls and is required for every successful use of this MCP.

**What is the maximum time span I can retrieve data for using get_flight_track?**
The tool retrieves position history for a limited, rolling window. You specify the start and end timestamps in your request parameters to define the exact track period you want.

**What type of identifier should I use when calling get_operator?**
You can use both IATA (airline code) or full operator names. Using the three-letter IATA code is generally faster and more reliable for lookups.

**Can I get the exact position history of a flight?**
Yes. Use the `get_flight_track` tool with the flight identifier to retrieve a detailed list of coordinates and altitudes recorded during the flight.

**How do I check the current weather at a specific airport?**
You can use the `get_airport_weather` tool by providing the ICAO or IATA code (e.g., 'KJFK' or 'LHR'). It returns current METAR data and TAF forecasts.

**Is it possible to see all flights currently arriving at an airport?**
Absolutely. Use the `get_airport_flights` tool with the airport code and set the type to 'arrivals' to see all aircraft currently en route or recently landed.