Flight MCP

🚀 Flight MCP Server

Real-time flight tracking for LLMs — Connect any AI assistant to live aircraft data from ADS-B Exchange. This project enables you to transform AI conversations with live flight intelligence. You can search aircraft by location, track specific flights, monitor military activity, and discover aviation patterns through a clean MCP interface.

🚀 Quick Start

1. Setup

bun install && bun run build

2. Get API Key

• Subscribe to ADS-B Exchange on RapidAPI.
• Add the key to .env: RAPIDAPI_KEY=your_key_here.

3. Test with Inspector

bun run inspect

✨ Features

• Transform AI conversations with live flight intelligence.
• Search aircraft by location, track specific flights, monitor military activity, and discover aviation patterns.

📦 Installation

The installation steps are as follows:

1. Run bun install && bun run build to set up the project.
2. Subscribe to ADS-B Exchange on RapidAPI and add the API key to the .env file.

💻 Usage Examples

Basic Usage

# Search aircraft around coordinates
search_aircraft(lat=40.7128, lon=-74.0060, radius_nm=25)
# → Aircraft within 25nm of NYC

# Get specific aircraft details  
get_aircraft(hex="a4b065")
# → Full aircraft data by ICAO code

Advanced Usage

# Browse military aircraft with filters
list_military_aircraft(
  region="us",           # us/europe/asia/all
  aircraft_type="H60",   # helicopters/cargo/fighters
  min_altitude=1000,     # exclude ground traffic
  limit=20,              # per page
  page=2                 # pagination
)

# Discover available aircraft types
get_military_aircraft_types(region="us")
# → Available types: H60, C17, F35, etc.

📚 Documentation

Example Response

{
  "hex": "a4b065",
  "callsign": "NKS185",
  "position": {"lat": 51.470, "lon": -0.456},
  "altitude": 38000,
  "speed": 460,
  "heading": 275
}

Use Cases

• Flight tracking: Monitor specific aircraft or routes.
• Aviation research: Analyze traffic patterns and aircraft types.
• Military monitoring: Track defense aircraft activity by region.
• Location intelligence: Find aircraft near points of interest.
• Real-time alerts: Build notifications for aircraft events.

⚠️ Important Note

Rate limits apply, and there is a 4 - second minimum polling. This project is powered by ADS - B Exchange.