{
  "markdown": "# Flightradar24 MCP Server\n\n[![npm version](https://badge.fury.io/js/@flightradar24%2Ffr24api-mcp.svg)](https://badge.fury.io/js/@flightradar24%2Ffr24api-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThis [Model Context Protocol (MCP)](https://modelcontextprotocol.io) 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.\n\n## Features\n\n- **Real-time Flight Tracking**: Get live positions of aircraft worldwide\n- **Historical Flight Data**: Access flight data dating back to May 11, 2016\n- **Comprehensive Flight Information**: Detailed aircraft, airline, and airport data\n- **Flexible Filtering**: Search by callsigns, registrations, routes, aircraft types, and more\n- **Flight Summaries**: Complete takeoff and landing information\n- **Aircraft Tracks**: Detailed positional tracking for specific flights\n\n## Installation\n\n### Via npm\n\n```bash\nnpm install -g @flightradar24/fr24api-mcp\n```\n\n## Prerequisites\n\n1. **Node.js**: Version 18.0.0 or higher\n2. **Flightradar24 API Key**: Get your API key from [https://fr24api.flightradar24.com](https://fr24api.flightradar24.com)\n\n## Configuration\n\n### Claude Desktop Integration\n\nAdd this configuration to your `claude_desktop_config.json` file:\n\n```json\n{\n  \"mcpServers\": {\n    \"fr24api\": {\n      \"command\": \"npx\",\n      \"args\": [\"@flightradar24/fr24api-mcp@latest\"],\n      \"env\": {\n        \"FR24_API_KEY\": \"your_api_key_here\"\n      }\n    }\n  }\n}\n\n```\n\n**Important Notes:**\n- Replace `your_api_key_here` with your actual Flightradar24 API key\n- Restart Claude Desktop after adding the configuration\n- If installed locally, use the full path: `\"command\": \"node\", \"args\": [\"/path/to/build/index.js\"]`\n\n### Other MCP Clients\n\nFor other MCP clients, run the server directly:\n\n```bash\nFR24_API_KEY=your_api_key_here npx @flightradar24/fr24api-mcp\n```\n\n## Available Tools\n\n### Live Flight Data\n\n#### `get_live_flights_positions_light`\nGet real-time aircraft positions with basic information.\n\n**Parameters** (at least one required):\n- `bounds`: Geographic area (north,south,west,east coordinates)\n- `flights`: Flight numbers (comma-separated, max 15)\n- `callsigns`: Flight callsigns (comma-separated, max 15)\n- `registrations`: Aircraft registrations (comma-separated, max 15)\n- `airports`: Airport codes with optional direction (e.g., \"inbound:JFK,outbound:LAX\")\n- `routes`: Flight routes (e.g., \"JFK-LAX,LHR-CDG\")\n- `aircraft`: Aircraft ICAO types (comma-separated, max 15)\n- `altitude_ranges`: Altitude ranges in feet (e.g., \"0-3000,30000-40000\")\n- `categories`: Flight categories (P,C,M,J,T,H,B,G,D,V,O,N)\n- `limit`: Maximum results (default: no limit, max: 30000)\n\n#### `get_live_flights_positions_full`\nGet real-time aircraft positions with comprehensive flight details.\n*Same parameters as above*\n\n#### `get_live_flights_count`\nGet count of live flights matching criteria.\n*Same parameters as above*\n\n### Historical Flight Data\n\n#### `get_historic_flights_positions_full`\nGet historical flight positions with full details.\n\n**Required Parameters:**\n- `timestamp`: Unix timestamp for historical snapshot\n\n**Optional Parameters:**\n*Same as live flight parameters*\n\n#### `get_historic_flights_positions_light`\nGet historical flight positions with basic information.\n*Same parameters as above*\n\n#### `get_historic_flights_count`\nGet count of historical flights.\n*Same parameters as above*\n\n### Flight Summaries\n\n#### `get_flight_summary_full`\nGet comprehensive flight takeoff/landing information.\n\n**Required Parameters:**\n- `flight_datetime_from`: Start datetime (YYYY-MM-DDTHH:MM:SSZ)\n- `flight_datetime_to`: End datetime (YYYY-MM-DDTHH:MM:SSZ)\n\n**Optional Parameters:**\n- `flights`, `callsigns`, `registrations`, `airports`, `routes`, `aircraft`\n- `sort`: Sort order (\"asc\" or \"desc\")\n- `limit`: Maximum results (max: 20000)\n\n#### `get_flight_summary_light`\nGet essential flight takeoff/landing information.\n*Same parameters as above*\n\n#### `get_flight_summary_count`\nGet count of flights in summary query.\n*Same parameters as above (without sort/limit)*\n\n### Specific Flight Data\n\n#### `get_flight_tracks`\nGet detailed positional tracks for a specific flight.\n\n**Required Parameters:**\n- `flight_id`: Flightradar24 flight ID (hexadecimal)\n\n### Reference Data\n\n#### `get_airline_info`\nGet airline information by ICAO code.\n\n**Required Parameters:**\n- `icao`: Airline ICAO code\n\n#### `get_airport_info_light`\nGet basic airport information.\n\n**Required Parameters:**\n- `code`: Airport IATA or ICAO code\n\n#### `get_airport_info_full`\nGet comprehensive airport information including location, elevation, timezone.\n\n**Required Parameters:**\n- `code`: Airport IATA or ICAO code\n\n## Usage Examples\n\n### Find flights around New York\n```\nGet live flights in the New York area with bounds: 41.0,-74.5,40.5,-73.5\n```\n\n### Track specific flight\n```\nGet flight tracks for flight ID: 2f4a8b3c\n```\n\n### Historical data\n```\nGet historical flights at JFK airport on timestamp 1640995200 with airports: inbound:JFK\n```\n\n### Flight summary\n```\nGet flight summary from 2024-01-01T00:00:00Z to 2024-01-02T00:00:00Z for route JFK-LAX\n```\n\n## Development\n\n### Building from Source\n\n```bash\ngit clone https://github.com/flightradar24/fr24api-mcp.git\ncd fr24api-mcp\nnpm install\nnpm run build\n```\n\n\n### Contributing\n\n1. Fork the repository\n2. Create a feature branch\n3. Make your changes\n4. Add tests if applicable\n5. Submit a pull request\n\n## Support\n\n- **Documentation**: [https://fr24api.flightradar24.com](https://fr24api.flightradar24.com)\n- **Issues**: [GitHub Issues](https://github.com/Flightradar24/fr24api-mcp/issues)\n- **API Support**: Contact Flightradar24 API support\n\n## License\n\nMIT License - see [LICENSE](LICENSE) file for details.\n\n## Changelog\n\n### 1.0.2\n- fix: flight summary 14 days prompt\n- release file update to asure trusted publisher works (#6)\n\n\n### 1.0.1\nRelease to [MCP Registry](https://github.com/modelcontextprotocol/registry)\n\n\n### 1.0.0\n- Initial public release\n- Comprehensive flight data access\n- Real-time and historical data support\n- Enhanced parameter validation\n- Improved error handling ",
  "bytes": 6331,
  "sha": "4b5e92010e09e78577d2eceaff60f97c110dd50840b4f2c8673ca2224f5a0e0b",
  "repo_slug": "flightradar24/fr24api-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_flightradar24_fr24api_mcp_801d27d6/readme"
}