flights_with_airlineLABSCO SUMMARY
Plan limits are named per tool, not discovered at runtime.
The historical-flights tool says up front that it needs the Basic plan, which saves the loop where a call fails and nobody knows whether it is the key, the query or the tier. Everything is paged with limit and offset, which matters because airport and airline tables are long. Running via uvx means the whole setup is a key and a config entry.
What it is
A twelve-tool server over the AviationStack API. Each tool maps to a question about flights rather than to a raw endpoint, and the reference data — airports, airlines, routes, taxes — is queryable alongside the flight data.
What you get
- flights_with_airline returns a sample of flights for a named airline
- historical_flights_by_date takes a date in YYYY-MM-DD form with optional airline, departure and arrival IATA filters — this one needs the Basic plan or above
- flight_arrival_departure_schedule returns arrivals or departures for an airport and airline; future_flights_arrival_departure_schedule does the same for a future date
- random_aircraft_type, random_airplanes_detailed_info, random_countries_detailed_info and random_cities_detailed_info return sample reference records
- list_airports, list_airlines, list_routes and list_taxes page through the reference tables with limit, offset and a search string
- Route listing filters by airline, departure and arrival IATA codes
Requirements
Python 3.13 or newer and uv. The published package is aviationstack-mcp, version 1.6.0, run with uvx aviationstack-mcp — no clone needed. It requires an AviationStack API key in AVIATION_STACK_API_KEY; a free key covers most tools, and historical flights need the Basic plan.
Setup effort
One command plus a key — uvx aviationstack-mcp, then supply credentials
USE CASES
01
Checking what is flying today for an airline
A sample of that airline's flights, with the count you ask for.
02
Looking at an airport's board
Arrivals or departures for a specific airport and airline.
03
Planning around a future date
Scheduled flights for an airport, airline and date ahead of time.
04
Looking back at what happened
Historical flights for a date, filterable by airline and by both airports.
05
Resolving codes to names
Airport, airline and route tables searchable and paged.
12 tools
Listed in project docs. Your client may show a different list.
historical_flights_by_dateflight_arrival_departure_schedulefuture_flights_arrival_departure_schedulerandom_aircraft_typerandom_airplanes_detailed_inforandom_countries_detailed_inforandom_cities_detailed_infolist_airportslist_airlineslist_routeslist_taxesBEFORE YOU INSTALL
What to know first
Tools you get
12 tools named in the project's documentation.
Requires
- uvx on PATH
- Python 3.13 or later
- AVIATION_STACK_API_KEY in your environment
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"Aviationstack MCP": {
"command": "uvx",
"args": [
"aviationstack-mcp"
],
"env": {
"AVIATION_STACK_API_KEY": "<YOUR_AVIATION_STACK_API_KEY>"
}
}
}
}uvx
TERMINAL
uvx aviationstack-mcp
