Pradumnasaraf/aviationstack-mcp

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:
- modelcontextprotocol/servers
- punkpeye/awesome-mcp-servers
- glama
- smithery
- mcpservers.org
Demo
https://github.com/user-attachments/assets/9325fcce-8ecc-4b01-8923-4ccb2f6968f4
Features
- **Look up a single flight by its flight number**
- **Get flights for a specific airline**
- **Fetch historical flights by date**
- **Retrieve arrival and departure schedules for airports**
- **Fetch future flight schedules** (from tomorrow through about 12 months ahead)
- **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.
Every tool returns the same JSON envelope. On success: {"ok": true, "count": N, "data": [...]}, plus a pagination block on the list_* tools and a message when there were no matches. On failure: {"ok": false, "context": "...", "error": "..."}. Any limit is capped at 100 records per call.
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 |
|------|-------------|------------|
| get_flight_status(flight_iata: str, flight_date: str = "") | Look up one flight by its IATA flight number, for today or a given date. | - **flight_iata**: Flight IATA number (e.g., "AA100") - **flight_date**: Optional date in YYYY-MM-DD format |
| flights_with_airline(airline_name: str, number_of_flights: int, flight_status: str = "") | Get live flights for a specific airline. | - **airline_name**: Name of the airline (e.g., "Delta Air Lines") - **number_of_flights**: Number of flights to return - **flight_status**: Optional status filter: scheduled, active, landed, cancelled, incident, diverted |
| 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 today's arrival or departure board for a given airport and airline. Current day only. | - **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 scheduled flights for a given airport, airline, and future date. Covers tomorrow through about 12 months ahead, including the next 7 days. | - **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, from tomorrow up to about 12 months ahead - **number_of_flights**: Number of flights to return |