Aviationstack MCP Server

Aviationstack MCP Server

MCP server offering comprehensive endpoints for aviation and flight data.

11
Stars
4
Forks
11
Watchers
2
Issues
Aviationstack MCP Server provides an MCP-compliant API that exposes tools to access real-time and scheduled flight data, aircraft details, random aircraft types, countries, and city information from the AviationStack API. It offers ready-to-use endpoints for airline-specific flight queries, airport schedules, and in-depth vehicle, country, and city data. The solution applies the Model Context Protocol by defining MCP tools as Python functions with standardized interfaces, designed for seamless integration into MCP-compatible environments. The server is built using Python, incorporates the FastMCP library, and is intended for easy deployment and use in application development.

Key Features

MCP-compliant server implementation
Endpoints for real-time and scheduled flight information
Fetches flight details by airline and airport
Retrieves future arrival and departure schedules
Provides random aircraft types and detailed airplane info
Delivers country and city information
Python 3.13+ support
Integration-ready with MCP clients
Uses FastMCP infrastructure
Simple setup with environment-based API keys

Use Cases

Integrating real-time flight data into travel and logistics applications
Developing tools that require airline or airport schedule information
Building dashboards for aviation analytics
Obtaining diverse samples of aircraft, airplane, or airport information for modeling
Enriching geographic knowledge with country or city data
Supplying aviation-related data to AI-powered virtual assistants
Testing and prototyping aviation data pipelines
Educational platforms teaching modern aviation information systems
Research on global aviation trends using live data
Plug-and-play aviation tools for any MCP-compatible environment

README

Aviationstack MCP Server

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 types, and airplane details, making it easy to integrate aviation data into your applications.

Demo

https://github.com/user-attachments/assets/9325fcce-8ecc-4b01-8923-4ccb2f6968f4

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
  • Get detailed info on random countries
  • Get detailed info on random cities

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
random_countries_detailed_info(number_of_countries: int) Get detailed info on random countries. - number_of_countries: Number of countries to return
random_cities_detailed_info(number_of_cities: int) Get detailed info on random cities. - number_of_cities: Number of cities 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)
json
{
  "mcpServers": {
    "Aviationstack MCP": {
      "command": "uvx",
      "args": [
        "aviationstack-mcp"
      ],
      "env": {
        "AVIATION_STACK_API_KEY": "<your-api-key>"
      }
    }
  }
}
  1. By cloning the repository and running the server locally
json
{
  "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.

Star History

Star History Chart

Repository Owner

Repository Details

Language Python
Default Branch main
Size 50 KB
Contributors 1
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

Python
100%

Tags

Topics

mcp mcp-server python uv uvicorn

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • FastMCP

    FastMCP

    The fast, Pythonic way to build MCP servers and clients.

    FastMCP is a production-ready framework for building Model Context Protocol (MCP) applications in Python. It streamlines the creation of MCP servers and clients, providing advanced features such as enterprise authentication, composable tools, OpenAPI/FastAPI generation, server proxying, deployment tools, and comprehensive client libraries. Designed for ease of use, it offers both standard protocol support and robust utilities for production deployments.

    • 20,201
    • MCP
    • jlowin/fastmcp
  • anki-mcp

    anki-mcp

    MCP server for seamless integration with Anki via AnkiConnect.

    An MCP server that bridges Anki flashcards with the Model Context Protocol, exposing AnkiConnect functionalities as standardized MCP tools. It organizes Anki actions into intuitive services covering decks, notes, cards, and models for easy access and automation. Designed for integration with AI assistants and other MCP-compatible clients, it enables operations like creating, modifying, and organizing flashcards through a unified protocol.

    • 6
    • MCP
    • ujisati/anki-mcp
  • Web3 MCP

    Web3 MCP

    A Model Context Protocol server for unified blockchain data access.

    Web3 MCP is a Model Context Protocol server that provides access to blockchain data through Ankr's Advanced API. It allows large language models to interact seamlessly with multiple blockchain networks such as Ethereum, BSC, Polygon, and Avalanche. With support for NFT, token, and blockchain query APIs, it enables users and AI agents to retrieve on-chain data, statistics, and analytics efficiently within an MCP context.

    • 3
    • MCP
    • tumf/web3-mcp
  • TickTick MCP

    TickTick MCP

    MCP server for AI-powered TickTick task management integration

    TickTick MCP is a Model Context Protocol (MCP) server that enables standardized integration of TickTick's task management features with AI assistants and developer applications. It allows programmatic access to create, update, retrieve, complete, or delete tasks and projects in TickTick via Python. Using this MCP server, AI systems can leverage TickTick's API to help automate and manage user's to-do lists and projects through natural language or other interfaces.

    • 6
    • MCP
    • ekkyarmandi/ticktick-mcp
  • mcp-time

    mcp-time

    A Model Context Protocol server for time and date operations

    mcp-time is a Model Context Protocol (MCP) server that enables AI assistants and MCP clients to perform standardized time and date-related operations. It provides natural language parsing for relative time expressions, supports flexible formatting, and allows manipulation and comparison of times. The server offers multiple integration methods, including stdio, HTTP stream, Docker, and npx for compatibility with various clients. It is designed for robust time handling and easy integration with AI tools.

    • 8
    • MCP
    • TheoBrigitte/mcp-time
  • Climatiq MCP Server

    Climatiq MCP Server

    MCP server providing AI assistants with real-time carbon emissions calculations via Climatiq API.

    Climatiq MCP Server implements the Model Context Protocol to bridge AI assistants with the Climatiq API for precise carbon emissions calculations. It exposes a set of tools for various emissions scenarios, including electricity use, travel, freight, and more. The server generates resource URIs for detailed emission reports and provides natural language explanations on climate impact. Configuration is streamlined via environment variables, CLI tools, or files, supporting easy integration with platforms like Claude Desktop.

    • 6
    • MCP
    • jagan-shanmugam/climatiq-mcp-server
  • Didn't find tool you were looking for?

    Be as detailed as possible for better results