flightradar-mcp-server

FlightRadar MCP Server

A Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.

Features

This MCP server provides three main tools:

1. get_flight_data: Get detailed information about a specific flight by its IATA or ICAO code
2. search_flights: Search for flights by various criteria like airline, departure/arrival airports, and status
3. get_flight_status: Get a human-readable status summary for a specific flight

Installation

Installing via Smithery

To install flightradar-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Cyreslab-AI/flightradar-mcp-server --client claude

Prerequisites

• Node.js (v14 or higher)
• npm (v6 or higher)
• An AviationStack API key (get one at aviationstack.com)

Setup

1. Clone this repository:

   git clone https://github.com/Cyreslab-AI/flightradar-mcp-server.git
   cd flightradar-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

4. Configure the server in your MCP settings file:

   For Claude VSCode extension, add to ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:

   {
     "mcpServers": {
       "flightradar": {
         "command": "node",
         "args": ["/path/to/flightradar-mcp-server/build/index.js"],
         "env": {
           "AVIATIONSTACK_API_KEY": "YOUR_API_KEY_HERE"
         },
         "disabled": false,
         "autoApprove": []
       }
     }
   }
   

   For Claude desktop app, add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or similar path on other platforms.

Usage Examples

Once the server is configured, you can use it with Claude to get flight information:

Get Flight Status

User: What's the status of flight BA855?

Claude: Flight BA855 (British Airways) is currently landed.

Departure: Prague Vaclav Havel Airport (PRG), Terminal 1, Gate B5
Scheduled: 3/25/2025, 11:50:00 AM
Estimated: 3/25/2025, 11:50:00 AM

Arrival: Heathrow (LHR), Terminal 3
Scheduled: 3/25/2025, 1:10:00 PM

Search Flights

User: Find British Airways flights

Claude: I found 3212 British Airways flights. Here are the first 3:

1. BA5719: Tucson (TUS) to Dallas/Fort Worth (DFW)
   Status: scheduled
   Departure: 3/25/2025, 5:00:00 AM

2. BA6096: Prague (PRG) to Helsinki (HEL)
   Status: scheduled
   Departure: 3/25/2025, 11:40:00 AM

3. BA855: Prague (PRG) to London Heathrow (LHR)
   Status: landed
   Departure: 3/25/2025, 10:50:00 AM

Get Flight Details

User: Get detailed information about flight BA855

Claude: Here are the details for flight BA855:

Flight: BA855 (BAW855)
Airline: British Airways
Aircraft: Airbus A320 (Registration: G-EUUH)

Departure:
- Airport: Prague Vaclav Havel Airport (PRG/LKPR)
- Terminal: 1, Gate: B5
- Scheduled: 3/25/2025, 10:50:00 AM

Arrival:
- Airport: London Heathrow (LHR/EGLL)
- Terminal: 3
- Scheduled: 3/25/2025, 12:10:00 PM

Status: landed

API Key Configuration

This server requires an AviationStack API key to function. You can get a free API key (100 requests/month) at aviationstack.com.

The API key should be provided as an environment variable named AVIATIONSTACK_API_KEY in your MCP settings configuration.

License

MIT