A Model Context Protocol server for flight tracking and status information
npm install flightradar-mcp-server
A Model Context Protocol (MCP) server that provides real-time flight tracking and status information using the AviationStack API.
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
To install flightradar-mcp-server for Claude Desktop automatically via Smithery:
``bash`
npx -y @smithery/cli install @Cyreslab-AI/flightradar-mcp-server --client claude
- Node.js (v14 or higher)
- npm (v6 or higher)
- An AviationStack API key (get one at aviationstack.com)
1. Clone this repository:
`bash`
git clone https://github.com/Cyreslab-AI/flightradar-mcp-server.git
cd flightradar-mcp-server
2. Install dependencies:
`bash`
npm install
3. Build the server:
`bash`
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:
`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.
Once the server is configured, you can use it with Claude to get flight information:
`
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
`
`
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
`
`
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
`
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.
MIT