aviationstack-mcp 1.2.0

Aviationstack MCP server.

Aviationstack MCP Server

This project is an MCP (Multi-Channel Platform) 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.

Demo

https://github.com/user-attachments/assets/8b976585-2c2b-4678-b7ca-7427a460d22dd22d

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

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

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 FastMCP class from mcp.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.

1. Using uvx without cloning the repository (recommended)

{
  "mcpServers": {
    "aviationstack-mcp": {
      "command": "uvx",
      "args": [
        "aviationstack-mcp"
      ],
      "env": {
        "AVIATION_STACK_API_KEY": "<your-api-key>"
      }
    }
  }
}

2. 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.