Flightradar24 MCP Server 🛩️

A Claude Desktop MCP server that helps you track flights in real-time using Flightradar24 data. Perfect for aviation enthusiasts, travel planners, or anyone curious about flights overhead!

What Can This Do? ✨

🔍 Track any flight in real-time
⏰ Get arrival and departure times for specific flights
🌉 View the status of flights at an airport
🚨 Monitor emergency flights

Setup Guide 🚀

1. Prerequisites

Claude Desktop installed on your computer
A Flightradar24 API key (get one from Flightradar24's website)

2. Installation

Clone this repository somewhere on your computer:

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

Install dependencies & build the project:

cd flightradar24-mcp-server
npm install
npm run build

3. Integration 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 following to the mcpServers object in your config:

{
  "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"
      }
    }
  }
}

Important Steps:
- Replace /FULL/PATH/TO/flightradar24-mcp-server with the actual full path to where you cloned the repository
- Add your Flightradar24 API key in the env section
- Make sure to use forward slashes (/) in the path, even on Windows
Restart Claude Desktop for the changes to take effect

Environment Setup

Copy .env.example to .env:
```
cp .env.example .env
```
Update the .env file with your actual Flightradar24 API key:
```
FR24_API_KEY=your_actual_api_key_here
```

Note: Never commit your actual API key to version control. The .env file is ignored by git for security reasons.

Let's Try It Out! 🎮

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"

Example conversation with Claude:

You: What's the status of flight UA123?
Claude: Let me check that for you...
[Claude will use the MCP server to fetch real-time flight information]

Common Questions & Troubleshooting 🤔

"Claude can't connect to the server"

Check if the path in claude_desktop_config.json is correct
Make sure you're using the full absolute path
Verify your API key is correct
Try restarting Claude Desktop

"The server isn't responding"

Make sure your Flightradar24 API key is valid
Check if the API URL is correct
Look for any error messages in server logs


## Need More Help? 🆘

1. Make sure Claude Desktop is properly installed
2. Verify your Flightradar24 API key is active
3. Check the path in your configuration is absolute and correct
4. Look for error messages in Claude Desktop's logs

## License 📄

MIT - Feel free to use this however you want!

---

Made with ❤️ for aviation enthusiasts

Flightradar24 MCP Server 🛩️