# fr24api-mcp [Health: Active]

**Category:** 🚆 Travel & Transportation  
**Repository:** https://github.com/Flightradar24/fr24api-mcp  
**GitHub Stars:** 29  
**npm Downloads (last month):** 8552  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/fr24api-mcp

## Description
MCP server providing access to the Flightradar24 API for real-time and historical flight data

## Tools
Capabilities this server exposes over MCP:

- **get_live_flights_positions_light** — Get real-time aircraft positions with basic information.
- **get_live_flights_positions_full** — Get real-time aircraft positions with comprehensive flight details.
- **get_live_flights_count** — Get count of live flights matching criteria.
- **get_historic_flights_positions_full** — Get historical flight positions with full details.
- **get_historic_flights_positions_light** — Get historical flight positions with basic information.
- **get_historic_flights_count** — Get count of historical flights.
- **get_flight_summary_full** — Get comprehensive flight takeoff/landing information.
- **get_flight_summary_light** — Get essential flight takeoff/landing information.
- **get_flight_summary_count** — Get count of flights in summary query.
- **get_flight_tracks** — Get detailed positional tracks for a specific flight.
- **get_airline_info** — Get airline information by ICAO code.
- **get_airport_info_light** — Get basic airport information.
- **get_airport_info_full** — Get comprehensive airport information including location, elevation, timezone.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "fr24api-mcp": {
    "command": "npx",
    "args": ["-y","@flightradar24/fr24api-mcp"],
    "env": {
      "FR24_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `FR24_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What fr24api-mcp does

The fr24api-mcp MCP server exposes Flightradar24 aviation data as MCP tools. It supports current aircraft-position queries, historical position lookups, flight summaries, detailed tracks for an identified flight, and reference data for airlines and airports.

Live position tools can return either basic or full information, and a separate count tool reports how many flights match the query. Filters can include geographic bounds, flight numbers, callsigns, aircraft registrations, airports, routes, aircraft ICAO types, altitude ranges, and flight categories. Live queries can return up to 30,000 results when a limit is used.

Historical position tools accept a Unix timestamp and offer light, full, and count variants. Historical data is available from May 11, 2016, according to the project documentation.

## How it works

The server communicates with MCP clients over its standard command-line process. An MCP client sends tool calls, and the server uses the supplied Flightradar24 API key to query the Flightradar24 API.

Flight summary tools search a UTC datetime interval using `flight_datetime_from` and `flight_datetime_to` in ISO format. They can filter by flights, callsigns, registrations, airports, routes, and aircraft. Full and light variants return different levels of summary detail, while the count variant returns the number of matching flights. Summary results can be sorted ascending or descending and limited to 20,000 records.

The `get_flight_tracks` tool requires a Flightradar24 flight ID in hexadecimal format. Airline lookup requires an ICAO code, while both airport tools accept an IATA or ICAO airport code.

## Setup and configuration

Install the package globally with npm:

```bash
npm install -g @flightradar24/fr24api-mcp
```

Node.js 18 or newer is required. Obtain a Flightradar24 API key, then provide it through the `FR24_API_KEY` environment variable. For Claude Desktop, configure the server with `npx` and set the variable in the client configuration:

```json
{
  "mcpServers": {
    "fr24api": {
      "command": "npx",
      "args": ["@flightradar24/fr24api-mcp@latest"],
      "env": {
        "FR24_API_KEY": "your_api_key_here"
      }
    }
  }
}
```

Other MCP clients can launch it directly with `FR24_API_KEY=your_api_key_here npx @flightradar24/fr24api-mcp`. Restart Claude Desktop after changing its configuration. When running a locally built copy, use Node.js with the path to `build/index.js`.

## Tools and capabilities

The fr24api-mcp MCP server provides:

- Live positions with light or full aircraft details
- Live flight counts using the same filtering options
- Historical positions and counts for a requested timestamp
- Full and light flight summaries, plus summary counts
- Detailed tracks for a specific flight ID
- Airline information by ICAO code
- Basic or full airport information, including location, elevation, and timezone in the full response

Build from source with `npm install` followed by `npm run build` after cloning the repository.

## Limitations and notes

A live position query requires at least one filter, such as bounds, flights, callsigns, registrations, airports, routes, aircraft, altitude ranges, or categories. Several list-style filters accept at most 15 values, and live results have a documented maximum of 30,000. Historical position requests require a timestamp, while summary requests require both start and end datetimes. Summary results have a maximum limit of 20,000. API access depends on a valid Flightradar24 API key and the applicable Flightradar24 API service.

_Full upstream README: https://allmcps.com/mcp/fr24api-mcp/readme_

