An MCP server using the AviationStack API to fetch real-time flight data including airline flights, airport schedules, future flights and aircraft types ✈️.
SaferSkills independently audited Aviationstack Mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
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.
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.
| 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")<br> - `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")<br> - `number_of_flights`: Number of flights to return<br> - `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<br> - `number_of_flights`: Number of flights to return<br> - `airline_iata`: Optional airline IATA filter<br> - `dep_iata`: Optional departure airport IATA filter<br> - `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")<br> - `schedule_type`: "arrival" or "departure"<br> - `airline_name`: Name of the airline<br> - `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<br> - `schedule_type`: "arrival" or "departure"<br> - `airline_iata`: IATA code of the airline (e.g., "DL" for Delta)<br> - `date`: Date in YYYY-MM-DD format, from tomorrow up to about 12 months ahead<br> - `number_of_flights`: Number of flights to return |
random_aircraft_type(number_of_aircraft: int) | Get aircraft types from a random offset in the dataset. | - `number_of_aircraft`: Number of aircraft types to return |
random_airplanes_detailed_info(number_of_airplanes: int) | Get detailed info on airplanes from a random offset in the dataset. | - `number_of_airplanes`: Number of airplanes to return |
random_countries_detailed_info(number_of_countries: int) | Get detailed info on countries from a random offset in the dataset. | - `number_of_countries`: Number of countries to return |
random_cities_detailed_info(number_of_cities: int) | Get detailed info on cities from a random offset in the dataset. | - `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<br> - `offset`: Pagination offset<br> - `search`: Optional search query |
list_airlines(limit: int = 10, offset: int = 0, search: str = "") | List airlines. | - `limit`: Number of results to return<br> - `offset`: Pagination offset<br> - `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<br> - `offset`: Pagination offset<br> - `airline_iata`: Optional airline IATA filter<br> - `dep_iata`: Optional departure airport IATA filter<br> - `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<br> - `offset`: Pagination offset<br> - `search`: Optional search query |
The server ships reusable prompts that steer a model toward the right tool.
| Prompt | Arguments | Purpose |
|---|---|---|
plan_flight_status_lookup | flight_iata, flight_date | Check one specific flight, and explain its codeshares. |
plan_airline_flight_lookup | airline_name, number_of_flights | Query live flights for an airline. |
plan_future_schedule_lookup | airport_iata_code, date, schedule_type | Query a future airport schedule. |
plan_reference_data_lookup | data_type, search | Explore airport, airline, route or tax reference data. |
| Resource | URI | Contents |
|---|---|---|
server_metadata | aviationstack://meta/server | API base URL and the accepted API key variables. |
aviationstack_endpoints | aviationstack://meta/endpoints | The Aviationstack endpoints each tool calls. |
tool_input_examples | aviationstack://examples/tool-input/{tool_name} | A sample payload for a given tool. |
src/aviationstack_mcp/server.py.@mcp.tool().matching plain function. Tests target the plain functions.
FastMCP class from mcp.server.fastmcp. The mcp dependency ispinned to <2, because 2.x renames FastMCP to MCPServer.
Set up and run the checks the CI runs:
uv sync --all-groups
# Unit tests
uv run python -m unittest discover -s tests -v
# Lint, must stay at 10.00/10
uv run pylint $(git ls-files '*.py')
# Coverage
uv run coverage run --source=aviationstack_mcp -m unittest discover -s tests
uv run coverage report.well-known/mcp/server-card.json is generated, not hand-edited. After changing any tool, prompt or resource, regenerate it or CI will fail:
uv run python scripts/generate_server_card.py # rewrite the card
uv run python scripts/generate_server_card.py --check # what CI runsTo 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": "<your-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": "<your-api-key>"
}
}
}
}This project is licensed under the MIT License. See LICENSE for details.
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.