Flightradar24 MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Flightradar24 MCP Server show me live flights near San Francisco"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
Related MCP server: Flightradar24 MCP Server
Installation
Via npm
npm install -g @bachstudio/fr24api-mcpPrerequisites
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 keyRestart 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-mcpAvailable 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.5Track specific flight
Get flight tracks for flight ID: 2f4a8b3cHistorical data
Get historical flights at JFK airport on timestamp 1640995200 with airports: inbound:JFKFlight summary
Get flight summary from 2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z for route JFK-LAXDevelopment
Building from Source
git clone https://github.com/BACH-AI-Tools/fr24api-mcp.git
cd fr24api-mcp
npm install
npm run buildContributing
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
Available Tools
15 toolsget_airline_infoA
Returns airline name, ICAO and IATA codes. REQUIRED: icao code must be provided and non-empty.
Inputs: icao (required).
get_airport_info_fullA
Returns detailed airport information: full name, ICAO and IATA codes, localization, elevation, country, city, state, timezone details. REQUIRED: code must be provided and non-empty.
Inputs: code (required).
get_airport_info_lightB
Returns airport name, ICAO and IATA codes. REQUIRED: code must be provided and non-empty.
Inputs: code (required).
get_flight_summary_countB
Returns the number of flights for a given flight summary query. IMPORTANT: flight_datetime_from and flight_datetime_to are required, and at least one additional search parameter should be provided.
Inputs: flight_datetime_from (required), flight_datetime_to (required), flights, callsigns, +6 more.
get_flight_summary_fullA
Returns comprehensive timings and locations of aircraft takeoffs and landings, including detailed flight, aircraft, and operator information. Both real-time and extensive historical data are available. Data is available starting from 2024-04-07 and will be extended further in the near future. IMPORTANT: flight_datetime_from and flight_datetime_to are required, and at least one additional search parameter (other than sort and limit) should be provided.
Inputs: flight_datetime_from (required), flight_datetime_to (required), flights, callsigns, +8 more.
get_flight_summary_lightA
Returns key timings and locations of aircraft takeoffs and landings alongside all primary flight, aircraft, and operator information. Both real-time and historical data are available. Data is available starting from 2024-04-07 and will be extended further in the near future. IMPORTANT: flight_datetime_from and flight_datetime_to are required, and at least one additional search parameter (other than sort and limit) should be provided.
Inputs: flight_datetime_from (required), flight_datetime_to (required), flights, callsigns, +8 more.
get_flight_tracksA
Returns positional tracks of a specific flight. REQUIRED: flight_id must be provided and non-empty.
Inputs: flight_id (required).
get_historic_flight_events_fullA
Returns selected historical flight events (gate_departure, takeoff, cruising, airspace_transition, resuming_flightplan, descent, landed, gate_arrival), with detailed information, sorted by event_timestamp and grouped by flight_id. REQUIRED: flight_ids and event_types must be provided and non-empty.
Inputs: flight_ids (required), event_types (required).
get_historic_flight_events_lightA
Returns selected historical flight events (gate_departure, takeoff, cruising, airspace_transition, resuming_flightplan, descent, landed, gate_arrival), sorted by event_timestamp and grouped by flight_id. REQUIRED: flight_ids and event_types must be provided and non-empty.
Inputs: flight_ids (required), event_types (required).
get_historic_flights_countA
Returns number of historical aircraft flight positions. IMPORTANT: Timestamp is required, and at least one additional search parameter (other than limit) must be provided and non-empty.
Inputs: timestamp (required), bounds, flights, callsigns, +13 more.
get_historic_flights_positions_fullA
Returns historical aircraft flight movement information including latitude, longitude, speed, and altitude alongside key flight and aircraft information such as origin, destination, callsign, registration and aircraft type. FR24 API provides access to historical flight data, dating back to May 11, 2016, depending on the user's subscription plan. IMPORTANT: Timestamp is required, and at least one additional search parameter (other than limit) must be provided and non-empty.
Inputs: timestamp (required), bounds, flights, callsigns, +13 more.
get_historic_flights_positions_lightB
Returns historical aircraft flight movement information including latitude, longitude, speed and altitude. FR24 API provides access to historical flight data, dating back to May 11, 2016, depending on the user's subscription plan. IMPORTANT: Timestamp is required, and at least one additional search parameter (other than limit) must be provided and non-empty.
Inputs: timestamp (required), bounds, flights, callsigns, +13 more.
get_live_flights_countA
Returns the count of real-time aircraft flights matching the specified criteria. IMPORTANT: At least one search parameter (other than limit) must be provided and non-empty. Choose from: bounds, flights, callsigns, registrations, painted_as, operating_as, airports, routes, aircraft, altitude_ranges, squawks, categories, data_sources, airspaces, gspeed.
Inputs: bounds, flights, callsigns, registrations, +12 more.
get_live_flights_positions_fullA
Returns real-time aircraft flight movement information including latitude, longitude, speed, and altitude alongside key flight and aircraft information such as origin, destination, callsign, registration and aircraft type. IMPORTANT: At least one search parameter (other than limit) must be provided and non-empty. Choose from: bounds, flights, callsigns, registrations, painted_as, operating_as, airports, routes, aircraft, altitude_ranges, squawks, categories, data_sources, airspaces, gspeed.
Inputs: bounds, flights, callsigns, registrations, +12 more.
get_live_flights_positions_lightA
Returns real-time aircraft flight movement information including latitude, longitude, speed, and altitude. IMPORTANT: At least one search parameter (other than limit) must be provided and non-empty. Choose from: bounds, flights, callsigns, registrations, painted_as, operating_as, airports, routes, aircraft, altitude_ranges, squawks, categories, data_sources, airspaces, gspeed.
Inputs: bounds, flights, callsigns, registrations, +12 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 15 tools
Tools are generally distinct by resource type (airline, airport, flight summaries, tracks, events, positions) and data depth (full/light), but there is significant overlap within categories. For example, get_flight_summary_full and get_flight_summary_light serve similar purposes with varying detail, which could confuse agents about which to select for basic needs. The presence of both full and light versions for multiple endpoints creates redundancy that may lead to misselection.
Tool names follow a consistent verb_noun pattern with get_ prefixes and descriptive suffixes (e.g., _full, _light, _count). However, there are minor deviations: get_airport_info_full and get_airport_info_light use 'info' while others use more specific terms like 'summary' or 'positions', and get_flight_tracks lacks a suffix, breaking the pattern slightly. Overall, the naming is predictable and readable.
With 15 tools, the count is reasonable for a flight data server covering airlines, airports, flights, and historical/live data. It is slightly on the higher side due to duplicate full/light versions, but each tool serves a distinct data depth or resource, making it manageable. The scope justifies the number without feeling overly bloated.
The toolset provides comprehensive coverage for querying flight data, including airlines, airports, flight summaries, tracks, events, and live/historical positions. Minor gaps exist, such as no tools for updating or deleting data (which may be intentional for a read-only API) and no direct tools for flight scheduling or alerts, but core retrieval operations are well-covered for the domain.
Maintenance
Related MCP Connectors
Live flight status and scheduled-route search via the official FlightAware AeroAPI.
Live flight status, airport boards, aircraft lookups and what is overhead, from PlaneTrack.ai.
Unofficial FlightAware MCP — wraps FlightAware AeroAPI v4 (aeroapi.flightaware.com)
Paid Aviation & Airport Operations Intelligence API via x402. Unpaid tool calls return 402.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables real-time aircraft tracking from Claude Desktop using the airplanes.live API, supporting searches by callsign, registration, hex ID, and position.9MIT
- AlicenseAqualityDmaintenanceProvides real-time and historical flight data via the Flightradar24 API, enabling AI assistants to track aircraft positions, flight summaries, and airport details.151,468 npm30MIT
- AlicenseNot gradedqualityCmaintenanceEnables live aircraft tracking by geographic area, individual aircraft lookup, flight route resolution, and airport arrivals/departures using OpenSky Network ADS-B data.103 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables natural-language and tool-based access to live flight status, airport departure/arrival boards, and scheduled flight timetables via the Cirium FlightStats Flex API.326 npmMIT