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 types, and airplane details, 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
- 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
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 |
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 |
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
FastMCPclass frommcp.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
uvxwithout 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>"
}
}
}
}
License
This project is licensed under the MIT License. See LICENSE for details.
Metadata
Release files for iflow-mcp_pradumnasaraf_aviationstack-mcp 1.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0.tar.gz | 25.3 kB | Without provenance | Details for iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0-py3-none-any.whl |
Total release size: 32.2 kB
Release files / iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0.tar.gz
| Download URL | iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0.tar.gz |
|---|---|
| Size | 25.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0bdac2af9fdb55b7ffdc587379de70f0c804950a7ea3aa2a5a19a85b2d4dea62
|
|
BLAKE2b-256 checksum How to use checksums |
7e7dd590d99af124d4d1eb1097647dbe5ad53d500ab932adca0d8ecd39e06549
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0-py3-none-any.whl
| Download URL | iflow_mcp_pradumnasaraf_aviationstack_mcp-1.4.0-py3-none-any.whl |
|---|---|
| Size | 6.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d967d3bee84f01073abaac95bcc888d748548e623dffe89d7fbd73199636c313
|
|
BLAKE2b-256 checksum How to use checksums |
7283d3c712b32c86fbd12814c96711a0838449350f5304ee3a508b2208515145
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_pradumnasaraf_aviationstack-mcp 1.4.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.