home / mcp / flightradar24 mcp server

Flightradar24 MCP Server

Model Context Protocol server for Flight Tracking

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "sunsetcoder-flightradar24-mcp-server": {
      "command": "node",
      "args": [
        "/Users/<username>/<FULL_PATH...>/flightradar24-mcp-server/dist/index.js"
      ],
      "env": {
        "FR24_API_KEY": "your_api_key_here",
        "FR24_API_URL": "https://fr24api.flightradar24.com"
      }
    }
  }
}

You can run a Flightradar24 MCP Server locally to access real-time flight data and airport statuses through a client that speaks MCP. This server acts as a bridge, fetching live flight information from Flightradar24 and making it searchable and actionable for queries like ETAs, current positions, and emergency flights.

How to use

Set up a client that connects to your local MCP server. The server operates as a standard MCP endpoint, so you will issue requests to the configured local process. Typical uses include asking for the ETA of a specific flight, listing all flights currently at a given airport, checking if there are any emergency flights nearby, and filtering international arrivals within a time window. Your client can present results in a readable format or drive dashboards for monitoring in real time.

How to install

Prerequisites you need before starting are Node.js and npm, so you can install dependencies and build the project.

# 1) Prerequisites
# Ensure Node.js and npm are installed on your system
node -v
npm -v

# 2) Install and build
# Clone the MCP server repository
git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git

# Navigate to the project and install dependencies
cd flightradar24-mcp-server
npm install
npm run build

Additional configuration and usage details

Configure the MCP server to run from your local environment and expose it to your MCP client. The server is started as a standard Node.js process and requires your Flightradar24 API key. Create or update your environment file to provide the API key and the API URL, and ensure the runtime command points to the built index.js file.

Configuration for running with your MCP client

{
  "mcpServers": {
    "flightradar24-server": {
      "command": "node",
      "args": [
        "/Users/<username>/<FULL_PATH...>/flightradar24-mcp-server/dist/index.js"
      ],
      "env": {
        "FR24_API_KEY": "your_api_key_here",
        "FR24_API_URL": "https://fr24api.flightradar24.com"
      }
    }
  }
}

Environment variables you need

Create a local environment file or set the variables in your process manager so the server can access the API. The required variables shown here are FR24_API_KEY and FR24_API_URL.

Starting the MCP server after setup

Start the server using the command and environment you configured. If you use the provided configuration, start the Node process so the MCP client can connect and issue flight data queries.

Troubleshooting tips

If the server does not respond, verify that the API key is valid, the API URL is correct, and the environment variables are loaded by the process. Check the server logs for any error messages and ensure the built index.js path is accurate in your configuration.

Security considerations

Never commit your actual API key into version control. Use a local .env file or a secrets manager to supply FR24_API_KEY and related variables at runtime. Ensure that access to the MCP server is restricted to authorized clients.

Example conversations you can enable with your MCP client

Ask for flight-specific details, airport status, or emergency flags to get up-to-date information from the live Flightradar24 feed.

Available tools

trackFlight

Fetch real-time position and status for a specific flight using the MCP interface.

getETA

Retrieve arrival or departure times for a given flight.

airportStatus

Query current flight activity and status at a specified airport.

emergencyFlights

Identify flights that have declared an emergency or shown abnormal status in a region.