Aviationstack

Aviationstack

An MCP server exposing tools to fetch real-time and future aviation data via AviationStack.

11
Stars
4
Forks
9
Releases

Overview

This MCP server provides a suite of tools to interact with the AviationStack API, delivering real-time and future flight data, aircraft types, and airplane details. All endpoints are implemented as MCP tools, designed to be consumed in an MCP-compatible environment, and exposed via a Python-based server. Core capabilities include retrieving flights for a specific airline, obtaining arrival and departure schedules for airports, and fetching future flight schedules. Additional tools offer random aircraft types and detailed information on randomly selected airplanes, countries, and cities. The project includes prerequisites such as an AviationStack API key, Python 3.13 or newer, and the uv package manager. The main server logic resides in server.py, with each MCP tool defined as a Python function decorated with @mcp.tool(). The server leverages the FastMCP framework from mcp.server.fastmcp. Configuration guidance is provided for integrating with MCP clients, either using uvx for a quick start or by cloning the repository and running the server locally. This setup enables rapid, structured access to aviation data within MCP client environments.

Details

Owner
Pradumnasaraf
Language
Python
License
MIT License
Updated
2025-12-07

Features

Get flights for a specific airline

Returns a random sample of flights for a specified airline.

Retrieve arrival and departure schedules for airports

Fetches arrival or departure schedules for a given airport and airline.

Fetch future flight schedules

Provides future scheduled flights for a given airport, airline, and date.

Get random aircraft types

Returns a selection of random aircraft type entries.

Get detailed info on random airplanes

Provides detailed information about randomly selected airplanes.

Get detailed info on random countries

Provides detailed information about randomly selected countries.

Get detailed info on random cities

Provides detailed information about randomly selected cities.

Tags

aviationstackMCP serverflight dataairlinesairportsaircraftschedulesreal-timefuturerandom dataPythonFastMCP