# AirLabs MCP

> AirLabs connects your AI agent to global aviation data. It lets you track real-time flights worldwide by flight number or location, check current airport delays and status across 50,000+ airports, and analyze entire airline route networks and fleet compositions through natural conversation.

## Overview
- **Category:** the-unthinkable
- **Price:** Free
- **Tags:** flight-tracking, aviation-data, real-time-api, airport-intelligence, flight-schedules, logistics

## Description

Your AI can now act as a dedicated operations coordinator for aviation data. Instead of opening multiple browser tabs—one for weather, one for flight tracking, another for airport codes—your agent pulls all the necessary information automatically. You ask about a route, and it gives you real-time status checks: Are there delays at JFK? What's the full schedule from ATL to MCO? Does Delta operate that aircraft type? The MCP handles the heavy lifting, combining live flight tracking with deep database access for airports, airlines, and aircraft types. This level of detail is usually locked behind expensive enterprise feeds, but by connecting via Vinkius, your agent gets instant access to a global aviation data analyst's toolkit. You just talk to it.

## Tools

### get_aircraft
Retrieves full specs and status for an individual aircraft using its hex code.

### get_airlines
Searches and lists metadata for any airline, like its country of origin or fleet size.

### get_airports
Searches the global database to find details about any airport by city or IATA code.

### autocomplete_airport
Suggests matching airports by name or code for user input fields.

### get_airport_delays
Pulls current average delay stats and on-time performance metrics for a specific airport.

### get_airline_fleet
Lists all planes in an airline's fleet, including age and type.

### get_flight_info
Gives a detailed status report on one specific flight, including gates and terminals.

### get_flights_by_airport
Lists every flight arriving or departing from a specific airport in a single view.

### get_flights
Searches for all real-time active flights across the globe by area or airline code.

### get_nearby_airports
Identifies all airports within a set distance of given geographic coordinates.

### get_airline_routes
Shows every route pair (origin/destination) operated by a specific airline.

### get_schedules
Retrieves the standard timetables and frequency for routes between two specific airports.

## Prompt Examples

**Prompt:** 
```
Show me all active United Airlines flights right now with their current positions and destinations.
```

**Response:** 
```
Searching AirLabs for United Airlines (UA) active flights... I found 387 flights currently in operation. Notable flights include: UA1 (Boeing 777-300ER, EWR to LHR, en-route at FL390 over Atlantic), UA890 (Boeing 787-9, NRT to SFO, en-route at FL380, ETA 14:23 PST), UA234 (Airbus A320, ORD to DEN, departed 35 minutes ago, climbing through FL280), and UA456 (Boeing 737-MAX 9, IAH to LAX, scheduled departure in 20 minutes). Would you like me to filter by a specific route or show more details for any flight?
```

**Prompt:** 
```
What is the flight schedule from New York JFK to London Heathrow, and which airlines operate this route?
```

**Response:** 
```
Checking schedules from JFK to LHR... I found 73 weekly flights on this route operated by 5 airlines: British Airways (BA) — 14 flights weekly with Boeing 777 and Airbus A350 aircraft, American Airlines (AA) — 14 flights weekly with Boeing 777-300ER and 787-9, Delta Air Lines (DL) — 7 flights weekly with Airbus A330-900neo, United Airlines (UA) — 7 flights weekly with Boeing 767-400 and 777-200, and Virgin Atlantic (VS) — 7 flights weekly with Airbus A350-1000. Average flight time is 7 hours 15 minutes eastbound, 8 hours westbound. Earliest departure is BA112 at 08:00 EST, latest is VS4 at 21:30 EST. Would you like schedules for a specific date?
```

**Prompt:** 
```
Are there any delays at Chicago O'Hare (ORD) right now, and what flights are currently departing?
```

**Response:** 
```
Checking ORD delay statistics and departures... Current delay data for Chicago O'Hare: Average departure delay is 23 minutes, average arrival delay is 18 minutes. On-time performance: 68% of flights departing within 15 minutes of schedule. Weather-related delays: moderate (gusty winds at 22 knots). Now checking active departures: I found 47 flights currently departing or scheduled for departure in the next 2 hours. Notable departures include: UA1545 (Boeing 737-900 to SFO, Gate C18, delayed 35 minutes), AA2891 (Airbus A321 to DFW, Gate H12, on-time departure), DL1723 (Boeing 757-200 to ATL, Gate C24, departed 12 minutes ago), and WN3456 (Boeing 737-MAX 8 to DEN, Gate B15, boarding). Would you like complete departure board details?
```

## Capabilities

### Track live flights globally
Search for active flights anywhere in the world using criteria like flight number, airline code, or geographic coordinates.

### Analyze airport conditions and delays
Check current delay statistics, on-time percentages, and operational status for any specific airport.

### Research airline networks and fleets
Build a profile of an entire airline by checking its full fleet composition or analyzing all the routes it operates.

### Find airport location details
Quickly look up airport codes, names, and types for anywhere in the world using autocomplete suggestions.

### Determine flight schedules
Pull complete timetables to see how often an airline runs a route between two specific airports.

## Use Cases

### Checking for last-minute disruptions
A travel agent needs to know if a client's connection is at risk. They run `get_flights` and cross-reference the result with `get_airport_delays`. The agent tells the client: 'The flight itself is fine, but ORD has high departure delays today; plan for extra time.'

### Analyzing a new market entry
A corporate strategy team needs to evaluate a rival's presence. They use `get_airlines` to identify the target company and then call `get_airline_routes` to map all their current operational connections.

### Planning a remote site visit
A field engineer is going to an unlisted regional spot. They use `get_nearby_airports` with the coordinates, which pinpoints the closest general aviation airport and its details, saving them from guessing.

### Building a dynamic departure board
An airport operations team wants to display all activity. They run `get_flights_by_airport` to see everything leaving or arriving at the main terminal in real time.

## Benefits

- Stop guessing competitor size. You can pull the full fleet composition of any airline using `get_airline_fleet` to see their operational capacity and average age.
- Plan complex trips efficiently. Use `get_schedules` to determine if a route is seasonal or year-round, avoiding missed connections due to unreliable timetables.
- Get immediate status reports for passengers. Check detailed flight info using `get_flight_info` to know the exact gate and terminal when they land.
- Predict operational risk before leaving home. Use `get_airport_delays` to assess if an airport has a poor on-time performance history today.
- Find alternatives fast. Need a fallback location? Run `get_nearby_airports` with coordinates to identify the closest usable airfields, even if they aren't major hubs.

## How It Works

The bottom line is that your AI acts as a single point of contact for complex aviation queries, eliminating manual data fetching.

1. Subscribe to this MCP and plug in your AirLabs API key into the Vinkius catalog.
2. Your AI client receives permission to run all aviation-specific tools defined by AirLabs.
3. You ask your agent a question—like, 'What are the delays at ORD?'—and it uses the right tool to give you the answer.

## Frequently Asked Questions

**How do I check flight status with get_flights on AirLabs?**
You search for active flights by providing the airline code, destination, or geographic area. This tool gives you real-time positions and estimated arrival/departure times.

**Does get_airport_delays provide historical data?**
It returns current average delay stats compared to historical averages, so you can assess today's operational risk. This is better than just checking the schedule.

**What if I don't know the airport code? Can autocomplete_airport help?**
Yes. Use `autocomplete_airport`. It lets you type a partial name or city, and it ranks matching airports with their full IATA/ICAO codes.

**Can get_schedules tell me if a route is seasonal?**
Yes, the tool provides frequency of service and days of operation, letting you know if the route runs all year or only during peak seasons.

**What parameters do I need to provide for the `get_nearby_airports` tool?**
You must supply a geographic coordinate (latitude and longitude) and a specific radius distance. The function returns all large, medium, or general aviation airports within that measurable range, along with their exact distances from your given point.

**What kind of operational data does `get_airline_fleet` provide?**
This tool gives deep insight into an airline's assets. You get the full list of aircraft registrations, manufacturer details, age in years, delivery dates, and current operational status (active, stored, or retired).

**How can I analyze a competitor's network using `get_airline_routes`?**
The tool delivers every route pair operated by the airline. You find details like service frequency, days of operation, and whether that specific connection is year-round or seasonal.

**What information does `get_aircraft` provide when I use a hex code?**
It provides comprehensive data on the physical aircraft. You receive the registration number, the ICAO type code, manufacturer model, and details like engine count and current operational status.

**Can my AI search for all active flights operated by a specific airline like United or Delta?**
Yes! Use the `get_flights` tool with the airline IATA code parameter (e.g., "UA" for United, "DL" for Delta, "BA" for British Airways). Your AI agent will return all currently active flights with flight numbers, aircraft types, departure and arrival airports, current positions, altitudes, speeds, and flight statuses. For a complete list of all routes that an airline operates, use `get_airline_routes` with the same airline IATA code. This gives you both real-time operational data and the full route network.

**How do I check flight schedules between two specific airports for travel planning?**
Use the `get_schedules` tool with the airline IATA code, and optionally the departure airport IATA (dep_iata) and arrival airport IATA (arr_iata) parameters. For example, to see all schedules from JFK to LAX, you would specify dep_iata="JFK" and arr_iata="LAX". The API will return all scheduled flights with airlines, flight numbers, aircraft types, departure and arrival times, and days of operation. You can also filter by a specific date to see schedules for your exact travel day.

**Can I look up the complete fleet composition and aircraft details for an airline?**
Absolutely! Use the `get_airline_fleet` tool with the airline IATA code (e.g., "UA" for United, "EK" for Emirates). Your AI will return the complete fleet with all aircraft registrations, types (Boeing 737, Airbus A380, etc.), ages, delivery dates, and operational status. This is perfect for fleet analysis, understanding airline strategy, comparing competitor fleets, or researching aircraft utilization patterns.