Flightradar24 MCP Server

Overview

The Flightradar24 MCP server enables Claude to access real-time flight tracking data from Flightradar24. This integration allows you to query flight information, check airport status, monitor emergency flights, and more through natural language conversations with Claude.

Prerequisites

Before setting up this MCP server, you'll need:

1. Claude Desktop installed on your computer
2. A Flightradar24 API key (available with a subscription from Flightradar24's website)

Installation

Step 1: Clone the Repository

First, clone the repository to your local machine:

git clone https://github.com/sunsetcoder/flightradar24-mcp-server.git

Step 2: Install Dependencies and Build

Navigate to the cloned repository directory and install the required dependencies:

cd flightradar24-mcp-server
npm install
npm run build

Step 3: Configure Environment Variables

Create a .env file in the root directory of the project by copying the example file:

cp .env.example .env

Edit the .env file to include your Flightradar24 API key:

FR24_API_KEY=your_actual_api_key_here

Step 4: Integrate with Claude Desktop

Open your Claude Desktop configuration file:

• On Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• On Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the Flightradar24 MCP server to the mcpServers object in your config:

{
  "mcpServers": {
    "flightradar24-server": {
      "command": "node",
      "args": [
        "/FULL/PATH/TO/flightradar24-mcp-server/dist/index.js"
      ],
      "env": {
        "FR24_API_KEY": "your_api_key_here",
        "FR24_API_URL": "https://fr24api.flightradar24.com"
      }
    }
  }
}

Important notes:

• Replace /FULL/PATH/TO/flightradar24-mcp-server with the absolute path to where you cloned the repository
• Add your actual Flightradar24 API key in the env section
• Use forward slashes (/) in the path, even on Windows
• Restart Claude Desktop after making these changes

Usage Examples

Once the server is configured, you can ask Claude questions like:

• "What's the ETA for United Airlines flight UA123?"
• "Show me all flights currently at SFO"
• "Are there any emergency flights in the area?"
• "Show me all international flights arriving at SFO in the next 2 hours"
• "How many commercial flights are currently over the Pacific Ocean?"
• "Identify any flights that have declared an emergency in the California region"

Troubleshooting

Connection Issues

If Claude can't connect to the server:

• Verify the path in claude_desktop_config.json is correct and uses the full absolute path
• Check that your API key is valid and correctly entered
• Restart Claude Desktop after making configuration changes

API Response Issues

If the server connects but isn't returning flight data:

• Confirm your Flightradar24 API key is active and has the necessary permissions
• Check if the API URL is correct in your configuration
• Look for error messages in the server logs

API Access

Note that using Flightradar24's API requires a subscription. Make sure your subscription is active and has the appropriate level of access for the queries you're making.

Additional Help

If you continue to experience issues:

1. Verify Claude Desktop is properly installed and up to date
2. Check that your Flightradar24 API key is active and has the necessary permissions
3. Double-check the path in your configuration file
4. Look for error messages in the MCP server logs for specific issues