Aviation MCP Server
MCP server giving AI agents access to real-time aviation data — live flight tracking, airport weather, airline and airport information.
Features
| Tool | Description | Source |
|---|---|---|
track_live_flights |
Current flights worldwide or in a specific area | OpenSky Network |
track_flight |
Track a specific flight by callsign or ICAO24 | OpenSky Network |
get_flight_path |
Historical flight path/trajectory | OpenSky Network |
get_airport_arrivals |
Recent arrivals at an airport | OpenSky Network |
get_airport_departures |
Recent departures from an airport | OpenSky Network |
get_airport_weather |
Current METAR weather at an airport | AviationWeather.gov |
get_weather_forecast |
TAF weather forecast for an airport | AviationWeather.gov |
get_aviation_warnings |
Active SIGMETs and aviation warnings | AviationWeather.gov |
get_airport_info |
Airport details (location, timezone, etc.) | AirLabs |
get_airline_info |
Airline details (fleet, hub, status) | AirLabs |
Data Sources
- OpenSky Network — Live flight tracking, arrivals/departures, flight paths (no API key needed, 100 calls/day)
- AviationWeather.gov — METAR, TAF, SIGMETs (no API key needed, 100 req/min)
- AirLabs — Airport and airline database (free tier: 1,000 calls/month, API key required)
Installation
With pip
pip install aviation-mcp-server
From source
git clone https://github.com/AiAgentKarl/aviation-mcp-server.git
cd aviation-mcp-server
pip install -e .
Configuration
API Keys
Copy .env.example to .env and add your keys:
cp .env.example .env
# AirLabs — Optional (https://airlabs.co)
AIRLABS_API_KEY=your-key-here
Note: OpenSky Network and AviationWeather.gov require no API key. The AirLabs key is only needed for
get_airport_infoandget_airline_info.
Claude Desktop / Claude Code
Add to your MCP configuration:
{
"mcpServers": {
"aviation": {
"type": "stdio",
"command": "python",
"args": ["-m", "src.server"],
"env": {
"AIRLABS_API_KEY": "your-key-here"
}
}
}
}
Using uvx (no install needed)
{
"mcpServers": {
"aviation": {
"type": "stdio",
"command": "uvx",
"args": ["aviation-mcp-server"],
"env": {
"AIRLABS_API_KEY": "your-key-here"
}
}
}
}
Usage Examples
Track flights over Germany:
"Show me all flights currently over Germany"
Check airport weather:
"What's the current weather at Frankfurt Airport?"
Track a specific flight:
"Track Lufthansa flight DLH400"
Get airport arrivals:
"Show me recent arrivals at JFK"
Aviation warnings:
"Are there any active SIGMETs?"
Airport Codes
This server uses ICAO airport codes (4 letters) for weather and flight data:
| Airport | IATA | ICAO |
|---|---|---|
| Frankfurt | FRA | EDDF |
| Munich | MUC | EDDM |
| Berlin | BER | EDDB |
| New York JFK | JFK | KJFK |
| London Heathrow | LHR | EGLL |
| Paris CDG | CDG | LFPG |
| Tokyo Narita | NRT | RJAA |
Rate Limits
| API | Limit | Auth |
|---|---|---|
| OpenSky Network | 100 calls/day (anonymous) | None |
| AviationWeather.gov | 100 requests/minute | None |
| AirLabs | 1,000 calls/month (free tier) | API Key |
Tech Stack
- Python 3.11+
- MCP SDK (FastMCP)
- httpx (async HTTP)
- OpenSky Network, AviationWeather.gov, AirLabs APIs
License
MIT
Metadata
Release files for aviation-mcp-server 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| aviation_mcp_server-0.1.0.tar.gz | 10.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| aviation_mcp_server-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 24.4 kB
Release files / aviation_mcp_server-0.1.0.tar.gz
| Download URL | aviation_mcp_server-0.1.0.tar.gz |
|---|---|
| Size | 10.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5eea465ac19420394042c085d34ec7e5a1c0ff76f1856d6821e03e27dfb09712
|
|
BLAKE2b-256 checksum How to use checksums |
46454543e224a05508e0503821a843cdfeab9cfc9944ef4d22490b9c6754ee27
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Release files / aviation_mcp_server-0.1.0-py3-none-any.whl
| Download URL | aviation_mcp_server-0.1.0-py3-none-any.whl |
|---|---|
| Size | 14.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
10d73ac19cc4deea64a18ca92c04ea703a889c14bb783ee476b6ce8aa4efe4b0
|
|
BLAKE2b-256 checksum How to use checksums |
7b13c6b5ecde3aaadddefbbf679a2ddb7ac20ca4080e24c6f73f4e4c46d76002
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|