Flightradar24 MCP Server
This Model Context Protocol (MCP) server provides access to the Flightradar24 API for real-time and historical flight data. This server enables AI assistants like Claude to access comprehensive aviation data including live flight positions, aircraft information, airport details, and flight histories.
Original Project: This project is based on the official Flightradar24 MCP server.
Original repository: https://github.com/Flightradar24/fr24api-mcp
Features
- Real-time Flight Tracking: Get live positions of aircraft worldwide
- Historical Flight Data: Access flight data dating back to May 11, 2016
- Comprehensive Flight Information: Detailed aircraft, airline, and airport data
- Flexible Filtering: Search by callsigns, registrations, routes, aircraft types, and more
- Flight Summaries: Complete takeoff and landing information
- Aircraft Tracks: Detailed positional tracking for specific flights
Installation
Via npm
npm install -g @bachstudio/fr24api-mcp
Prerequisites
- Node.js: Version 18.0.0 or higher
- Flightradar24 API Key: Get your API key from https://fr24api.flightradar24.com
Configuration
Claude Desktop Integration
Add this configuration to your claude_desktop_config.json file:
{
"mcpServers": {
"fr24api": {
"command": "npx",
"args": ["@bachstudio/fr24api-mcp@latest"],
"env": {
"FR24_API_KEY": "your_api_key_here"
}
}
}
}
Important Notes:
- Replace
your_api_key_herewith your actual Flightradar24 API key - Restart Claude Desktop after adding the configuration
- If installed locally, use the full path:
"command": "node", "args": ["/path/to/build/index.js"]
Other MCP Clients
For other MCP clients, run the server directly:
FR24_API_KEY=your_api_key_here npx @bachstudio/fr24api-mcp
Available Tools
Live Flight Data
get_live_flights_positions_light
Get real-time aircraft positions with basic information.
Parameters (at least one required):
bounds: Geographic area (north,south,west,east coordinates)flights: Flight numbers (comma-separated, max 15)callsigns: Flight callsigns (comma-separated, max 15)registrations: Aircraft registrations (comma-separated, max 15)airports: Airport codes with optional direction (e.g., "inbound:JFK,outbound:LAX")routes: Flight routes (e.g., "JFK-LAX,LHR-CDG")aircraft: Aircraft ICAO types (comma-separated, max 15)altitude_ranges: Altitude ranges in feet (e.g., "0-3000,30000-40000")categories: Flight categories (P,C,M,J,T,H,B,G,D,V,O,N)limit: Maximum results (default: no limit, max: 30000)
get_live_flights_positions_full
Get real-time aircraft positions with comprehensive flight details. Same parameters as above
get_live_flights_count
Get count of live flights matching criteria. Same parameters as above
Historical Flight Data
get_historic_flights_positions_full
Get historical flight positions with full details.
Required Parameters:
timestamp: Unix timestamp for historical snapshot
Optional Parameters: Same as live flight parameters
get_historic_flights_positions_light
Get historical flight positions with basic information. Same parameters as above
get_historic_flights_count
Get count of historical flights. Same parameters as above
Flight Summaries
get_flight_summary_full
Get comprehensive flight takeoff/landing information.
Required Parameters:
flight_datetime_from: Start datetime (YYYY-MM-DDTHH:MM:SSZ)flight_datetime_to: End datetime (YYYY-MM-DDTHH:MM:SSZ)
Optional Parameters:
flights,callsigns,registrations,airports,routes,aircraftsort: Sort order ("asc" or "desc")limit: Maximum results (max: 20000)
get_flight_summary_light
Get essential flight takeoff/landing information. Same parameters as above
get_flight_summary_count
Get count of flights in summary query. Same parameters as above (without sort/limit)
Specific Flight Data
get_flight_tracks
Get detailed positional tracks for a specific flight.
Required Parameters:
flight_id: Flightradar24 flight ID (hexadecimal)
Reference Data
get_airline_info
Get airline information by ICAO code.
Required Parameters:
icao: Airline ICAO code
get_airport_info_light
Get basic airport information.
Required Parameters:
code: Airport IATA or ICAO code
get_airport_info_full
Get comprehensive airport information including location, elevation, timezone.
Required Parameters:
code: Airport IATA or ICAO code
Usage Examples
Find flights around New York
Get live flights in the New York area with bounds: 41.0,-74.5,40.5,-73.5
Track specific flight
Get flight tracks for flight ID: 2f4a8b3c
Historical data
Get historical flights at JFK airport on timestamp 1640995200 with airports: inbound:JFK
Flight summary
Get flight summary from 2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z for route JFK-LAX
Development
Building from Source
git clone https://github.com/BACH-AI-Tools/fr24api-mcp.git
cd fr24api-mcp
npm install
npm run build
Contributing
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
Support
- Documentation: https://fr24api.flightradar24.com
- Issues: GitHub Issues
- API Support: Contact Flightradar24 API support
License
MIT License - see LICENSE file for details.
Changelog
1.0.1
Release to MCP Registry
1.0.0
- Initial public release
- Comprehensive flight data access
- Real-time and historical data support
- Enhanced parameter validation
- Improved error handling