What can you do with this server?

This MCP server provides access to aviation data through the AviationStack API, enabling retrieval of flight information, schedules, aircraft details, and reference data. * Flights for a specific airline – Retrieve a sample of flights operating under a given airline name * Historical flights – Get flights for a specific historical date * Arrival/departure schedules – Fetch arrival or departure schedules for a specific airport and airline using IATA codes * Future flight schedules – Retrieve upcoming scheduled arrivals or departures for a given airport, airline, and date * Aircraft types – Fetch information on random aircraft type classifications * Detailed airplane info – Retrieve detailed information on individual airplanes * Country & city info – Fetch detailed information on countries and cities * Reference data – List available airports, airlines, flight routes, and aviation taxes with search and pagination support Most tools support filtering by airline, airport IATA codes, dates, and other parameters, and all endpoints are implemented as MCP tools ready for integration into MCP-compatible environments.

Which integrations are available for this server?

Enables querying flight information for Delta Air Lines, including retrieving flight schedules, arrival and departure information Allows retrieving flight data using IATA airport and airline codes, supporting operations like checking arrivals/departures for specific airports and scheduling future flights

How do I use Aviationstack MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Aviationstack MCP Server show me 5 upcoming arrivals at JFK for Delta" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Aviationstack MCP Server by Pradumnasaraf

Aviationstack MCP Server

This project is an MCP (Model Context Protocol) server that provides a set of tools to interact with the AviationStack API. It exposes endpoints for retrieving real-time and future flight data, aircraft and airplane details, and core reference data (airports, airlines, routes, taxes), making it easy to integrate aviation data into your applications.

You can also find the Aviationstack MCP server in these well-known MCP server repositories for easy access:

Demo

https://github.com/user-attachments/assets/9325fcce-8ecc-4b01-8923-4ccb2f6968f4

Features

Get flights for a specific airline
Fetch historical flights by date
Retrieve arrival and departure schedules for airports
Fetch future flight schedules
Get random aircraft types
Get detailed info on random airplanes
Get detailed info on random countries
Get detailed info on random cities
List airports, airlines, routes, and taxes

All endpoints are implemented as MCP tools and are ready to be used in an MCP-compatible environment.

Prerequisites

Aviationstack API Key (You can get a FREE API Key from Aviationstack)
Python 3.13 or newer
uv package manager installed

Available Tools

Tool	Description	Parameters
`flights_with_airline(airline_name: str, number_of_flights: int)`	Get a random sample of flights for a specific airline.	- `airline_name`: Name of the airline (e.g., "Delta Air Lines") - `number_of_flights`: Number of flights to return
`historical_flights_by_date(flight_date: str, number_of_flights: int, airline_iata: str = "", dep_iata: str = "", arr_iata: str = "")`	Get historical flights for a date (Basic plan+).	- `flight_date`: Date in `YYYY-MM-DD` format - `number_of_flights`: Number of flights to return - `airline_iata`: Optional airline IATA filter - `dep_iata`: Optional departure airport IATA filter - `arr_iata`: Optional arrival airport IATA filter
`flight_arrival_departure_schedule(airport_iata_code: str, schedule_type: str, airline_name: str, number_of_flights: int)`	Get arrival or departure schedules for a given airport and airline.	- `airport_iata_code`: IATA code of the airport (e.g., "JFK") - `schedule_type`: "arrival" or "departure" - `airline_name`: Name of the airline - `number_of_flights`: Number of flights to return
`future_flights_arrival_departure_schedule(airport_iata_code: str, schedule_type: str, airline_iata: str, date: str, number_of_flights: int)`	Get future scheduled flights for a given airport, airline, and date.	- `airport_iata_code` : IATA code of the airport - `schedule_type`: "arrival" or "departure" - `airline_iata`: IATA code of the airline (e.g., "DL" for Delta) - `date`: Date in `YYYY-MM-DD` format - `number_of_flights`: Number of flights to return
`random_aircraft_type(number_of_aircraft: int)`	Get random aircraft types.	- `number_of_aircraft`: Number of aircraft types to return
`random_airplanes_detailed_info(number_of_airplanes: int)`	Get detailed info on random airplanes.	- `number_of_airplanes`: Number of airplanes to return
`random_countries_detailed_info(number_of_countries: int)`	Get detailed info on random countries.	- `number_of_countries`: Number of countries to return
`random_cities_detailed_info(number_of_cities: int)`	Get detailed info on random cities.	- `number_of_cities`: Number of cities to return
`list_airports(limit: int = 10, offset: int = 0, search: str = "")`	List airports.	- `limit`: Number of results to return - `offset`: Pagination offset - `search`: Optional search query
`list_airlines(limit: int = 10, offset: int = 0, search: str = "")`	List airlines.	- `limit`: Number of results to return - `offset`: Pagination offset - `search`: Optional search query
`list_routes(limit: int = 10, offset: int = 0, airline_iata: str = "", dep_iata: str = "", arr_iata: str = "")`	List routes.	- `limit`: Number of results to return - `offset`: Pagination offset - `airline_iata`: Optional airline IATA filter - `dep_iata`: Optional departure airport IATA filter - `arr_iata`: Optional arrival airport IATA filter
`list_taxes(limit: int = 10, offset: int = 0, search: str = "")`	List aviation taxes.	- `limit`: Number of results to return - `offset`: Pagination offset - `search`: Optional search query

Development

The main server logic is in server.py.
All MCP tools are defined as Python functions decorated with @mcp.tool().
The server uses the FastMCP class from mcp.server.fastmcp.

MCP Server configuration

To add this server to your favorite MCP client, you can add the following to your MCP client configuration file.

Using uvx without cloning the repository (recommended)

{ "mcpServers": { "Aviationstack MCP": { "command": "uvx", "args": [ "aviationstack-mcp" ], "env": { "AVIATION_STACK_API_KEY": "<your-api-key>" } } } }

By cloning the repository and running the server locally

{ "mcpServers": { "Aviationstack MCP": { "command": "uv", "args": [ "--directory", "/path/to/aviationstack-mcp/src/aviationstack_mcp", "run", "-m", "aviationstack_mcp", "mcp", "run" ], "env": { "AVIATION_STACK_API_KEY": "<your-api-key>" } } } }

Related MCP server: FlightRadar MCP Server