# AviationStack MCP

> AviationStack MCP gives your AI agent access to global, real-time flight and aviation data. Check current flight statuses, look up airport codes worldwide, analyze airline schedules, and map out complex international routes instantly. It's essential for anyone building tools that rely on accurate travel logistics.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** flight-tracking, aviation-data, airline-schedules, airport-info, real-time-flights

## Description

This connector lets you pull deep aviation intelligence directly into your workflow. Whether you’re tracking a specific plane or mapping out global connectivity, the data is live. You can check real-time flight status updates using flight numbers, retrieve detailed information about airports and cities globally, and understand airline infrastructure by listing aircraft types or querying schedules. It's more than just checking a schedule; it lets your agent build complex travel reports without scraping websites. When you connect this MCP through the Vinkius catalog, your AI client treats aviation data like any other API call—it’s reliable, structured, and immediately actionable. You can analyze historical flight patterns or pull future schedules to coordinate massive logistics operations.

## Tools

### list_aircraft_types
Retrieves available global aircraft types and their technical specifications.

### list_cities
Provides a comprehensive list of cities across the globe.

### list_airlines
Gathers a complete list of active international airlines.

### list_timetable
Retrieves specific airport timetables, requiring a professional plan or higher.

### list_airplanes
Gets detailed information for specific aircraft registrations.

### list_airports
Provides the global list of operational airports.

### list_countries
Gathers a comprehensive list of countries worldwide.

### list_flights
Fetches real-time or historical data for any given flight number and date.

### list_future_flights
Retrieves upcoming flight schedules, requiring a professional plan or higher.

### list_routes
Gets the scheduled routes connecting various airlines and hubs.

### list_taxes
Provides specific information regarding aviation taxes.

## Prompt Examples

**Prompt:** 
```
What is the current status of flight LH400?
```

**Response:** 
```
I'm checking the real-time data for LH400... The flight is currently 'active', departed from Frankfurt (FRA) at 10:45 AM and is estimated to land in New York (JFK) at 1:20 PM local time.
```

**Prompt:** 
```
List all airports in Tokyo.
```

**Response:** 
```
Fetching airports for Tokyo... I found Narita International (NRT) and Haneda Airport (HND). Would you like the specific ICAO codes or timezone details for these?
```

**Prompt:** 
```
Show me the scheduled routes for Emirates.
```

**Response:** 
```
Querying airline routes... I've retrieved the latest scheduled routes for Emirates. They include major hubs like Dubai (DXB) to London (LHR), Paris (CDG), and Singapore (SIN). Shall I list more specific route details?
```

## Capabilities

### Track Flight Status
Get current and historical status updates for specific flights using a flight number and date.

### Lookup Global Infrastructure
Access comprehensive lists of airports, cities, and countries with their respective codes and time zones.

### Analyze Airline Details
Query details about global airlines, specific aircraft models, or individual plane registrations.

### Plan Global Routes
Inspect scheduled airline routes and timetables to understand connectivity between major hubs.

## Use Cases

### Coordinating a Multi-Leg Trip
A travel coordinator needs to know if an international connection will work. They ask their agent, which uses `list_flights` for real-time data and then checks `list_airports` for the destination's timezone details before confirming arrival times.

### Developing a Flight Tracker App
A developer needs to build an app that shows historical flight paths. They use `list_flights` with past dates and then pull aircraft type specs using `list_aircraft_types` to ensure the data is complete.

### Market Research on Air Travel
A consultant wants to see which airlines service a specific region. They use `list_airlines`, cross-reference it with `list_routes`, and then check global tax rates via `list_taxes` to build a complete cost model.

### Mapping Infrastructure
A data scientist is mapping all available air travel infrastructure. They use `list_cities` to get population centers, then `list_airports` to find the specific hubs near those cities, and finally `list_countries` for national boundaries.

## Benefits

- Check real-time status for any flight. Use `list_flights` to get current location updates or check historical data using a specific date.
- Model global connections easily. Query `list_routes` and `list_timetable` to understand how airlines connect major international hubs.
- Build out foundational data sets. Access structured lists of airports (`list_airports`), cities, and countries so your agent knows where it is operating.
- Analyze carrier fleets. Use `list_airlines` or check specific aircraft details via `list_airplanes` to understand the scope of an airline's operation.
- Plan for future logistics. Access upcoming flight schedules using `list_future_flights`, giving you lead time before a trip is booked.

## How It Works

The bottom line is that you tell your AI client what you need, and this MCP handles the connection to billions of data points across global aviation records.

1. Subscribe to the MCP and enter your unique AviationStack API Access Key.
2. Your AI client connects, recognizing all available aviation data tools.
3. You prompt your agent with a request (e.g., 'What was the status of flight UA123 on Oct 1st?'), and it executes the necessary tool call.

## Frequently Asked Questions

**How do I check current flight status using AviationStack MCP?**
You use `list_flights` and provide a specific flight number along with the date. The tool pulls real-time data to give you the active status, departure points, and estimated arrival times.

**Can I find airport information in Asia using AviationStack MCP?**
Yes, use `list_airports` or `list_cities`. The tool provides global coverage and gives you the necessary IATA/ICAO codes for any major hub.

**Does AviationStack MCP handle historical flight data?**
It does. Simply use the `list_flights` tool, making sure to include a specific date in your request to pull records from the past.

**What is required for future flight schedules with AviationStack MCP?**
`list_future_flights` requires a Professional plan or higher. This access level ensures you get upcoming schedules rather than just current status updates.

**Can I find out about airline tax requirements using AviationStack MCP?**
Yes, use the `list_taxes` tool to retrieve specific aviation tax information related to routes and operations.