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 i
Add this skill
npx mdskills install Pradumnasaraf/aviationstack-mcpComprehensive aviation API integration with 13 well-documented tools and clear setup instructions
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:
https://github.com/user-attachments/assets/9325fcce-8ecc-4b01-8923-4ccb2f6968f4
All endpoints are implemented as MCP tools and are ready to be used in an MCP-compatible environment.
| 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 formatnumber_of_flights: Number of flights to returnairline_iata: Optional airline IATA filterdep_iata: Optional departure airport IATA filterarr_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 airlinenumber_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 airportschedule_type: "arrival" or "departure"airline_iata: IATA code of the airline (e.g., "DL" for Delta)date: Date in YYYY-MM-DD formatnumber_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 returnoffset: Pagination offsetsearch: Optional search query |
| list_airlines(limit: int = 10, offset: int = 0, search: str = "") | List airlines. | - limit: Number of results to returnoffset: Pagination offsetsearch: 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 returnoffset: Pagination offsetairline_iata: Optional airline IATA filterdep_iata: Optional departure airport IATA filterarr_iata: Optional arrival airport IATA filter |
| list_taxes(limit: int = 10, offset: int = 0, search: str = "") | List aviation taxes. | - limit: Number of results to returnoffset: Pagination offsetsearch: Optional search query |server.py.@mcp.tool().FastMCP class from mcp.server.fastmcp.To add this server to your favorite MCP client, you can add the following to your MCP client configuration file.
uvx without cloning the repository (recommended){
"mcpServers": {
"Aviationstack MCP": {
"command": "uvx",
"args": [
"aviationstack-mcp"
],
"env": {
"AVIATION_STACK_API_KEY": ""
}
}
}
}
{
"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": ""
}
}
}
}
This project is licensed under the MIT License. See LICENSE for details.
Install via CLI
npx mdskills install Pradumnasaraf/aviationstack-mcpAviationstack MCP is a free, open-source AI agent skill. 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 i
Install Aviationstack MCP with a single command:
npx mdskills install Pradumnasaraf/aviationstack-mcpThis downloads the skill files into your project and your AI agent picks them up automatically.
Aviationstack MCP works with Claude Code, Claude Desktop, Cursor, Vscode Copilot, Windsurf, Continue Dev, Gemini Cli, Amp, Roo Code, Goose. Skills use the open SKILL.md format which is compatible with any AI coding agent that reads markdown instructions.