Aviationstack

You can access aviation data through a specialized MCP server that exposes flight, aircraft, and reference data from the AviationStack API. This MCP server lets you fetch real-time and historical flights, schedules, aircraft details, and essential aviation references in an MCP-friendly environment, enabling easy integration into your applications and workflows.

How to use

Install and run an MCP client that can consume MCP servers. Once the server is running, you can invoke each available tool to retrieve flight data, aircraft details, and reference information. You will typically call tools by name with the required parameters from your MCP client, receiving structured data that you can route into your applications or dashboards.

How to install

Prerequisites You must have an Aviationstack API Key. You also need Python 3.13 or newer and a compatible MCP client with support for MCP servers.

# Step 1: Ensure Python is installed
python3 --version

# Step 2: Ensure you have a compatible MCP client installed (examples may vary by client).
# For the example MCP client, you will typically install dependencies for the MCP server you run.

# Step 3: Prepare your API key (set as an environment variable or pass to the client as required).
export AVIATION_STACK_API_KEY=your_api_key_here

# Step 4: Run the MCP server locally using the provided command sequence (see specific config below).

Additional notes

You will configure an MCP client to connect to the server using one of the available local run options described in the configuration examples. Ensure your API key is provided to the server environment as shown in the configuration blocks.

Configuration and run options

Two local run options are provided to start the Aviationstack MCP server client locally. Use the uvx-based one for a quick start or the full uv-based local run if you prefer building from source.

{
  "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>"
      }
    }
  }
}

Available tools

flights_with_airline

Get a random sample of flights for a specific airline. Parameters: airline_name (string), number_of_flights (int).

historical_flights_by_date

Get historical flights for a specific date. Parameters: flight_date (YYYY-MM-DD), number_of_flights (int), and optional filters airline_iata, dep_iata, arr_iata.

flight_arrival_departure_schedule

Get arrival or departure schedules for a given airport and airline. Parameters: airport_iata_code, schedule_type (arrival/departure), airline_name, number_of_flights.

future_flights_arrival_departure_schedule

Get future scheduled flights for a given airport, airline, and date. Parameters: airport_iata_code, schedule_type, airline_iata, date, number_of_flights.

random_aircraft_type

Get random aircraft types. Parameters: number_of_aircraft.

random_airplanes_detailed_info

Get detailed info on random airplanes. Parameters: number_of_airplanes.

random_countries_detailed_info

Get detailed info on random countries. Parameters: number_of_countries.

random_cities_detailed_info

Get detailed info on random cities. Parameters: number_of_cities.

list_airports

List airports with optional search and pagination. Parameters: limit, offset, search.

list_airlines

List airlines with optional search and pagination. Parameters: limit, offset, search.

list_routes

List routes with optional filters and pagination. Parameters: limit, offset, airline_iata, dep_iata, arr_iata.

list_taxes

List aviation taxes with optional search and pagination. Parameters: limit, offset, search.