# Flight Radar — how to use (mcp.ai)

Live flight radar: real-time position of any aircraft transmitting ADS-B right now. Search by registration, ICAO hex or callsign, see traffic within a radius of any point (sorted by distance), find out which plane is flying over you, list aircraft by type (A320, 737, PC-12) or military aircraft airborne. Includes airport lookup by IATA/ICAO code, offline base with ~90k airports with city, country, coordinates and timezone. Data from the adsb.lol community network (best coverage in urban areas). No credentials, platform-hosted.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_flightradar?ms=1784578800000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `flightradar_aircraft`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/flightradar`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/flightradar/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/flightradar/aircraft` — Posição ao vivo de aeronaves específicas, por matrícula (registration), código hex ICAO 24-bit e/ou callsign. Aceita até 50 identificadores numa chamada (misturando os 3 tipos). Retorna por identifica
  - body: { registrations?: string[], hexes?: string[], callsigns?: string[] }
- `POST https://api.mcp.ai/api/flightradar/airport` — Informações de aeroportos por código IATA, ICAO, GPS ou local (aceita vários códigos numa chamada). Base offline com ~90 mil aeroportos do mundo todo (incl. heliportos e pistas pequenas). Retorna por 
  - body: { codes: string[] }
- `POST https://api.mcp.ai/api/flightradar/closest` — A aeronave mais próxima de um ponto (dentro do raio em milhas náuticas). Retorna { found, aircraft } com distance_nm e bearing_deg. Bom pra responder "que avião é esse passando aqui em cima?".
  - body: { lat: number, lon: number, radius_nm?: number }
- `POST https://api.mcp.ai/api/flightradar/military` — Aeronaves militares transmitindo ADS-B agora no mundo. Retorna { total_airborne, aircraft[] } com posição, tipo e callsign de cada uma.
  - body: { limit?: integer }
- `POST https://api.mcp.ai/api/flightradar/nearby` — Aeronaves transmitindo ADS-B agora num raio (em milhas náuticas) de um ponto, ordenadas da mais próxima pra mais distante. Retorna { total_in_radius, aircraft: [{ registration, callsign, type, lat, lo
  - body: { lat: number, lon: number, radius_nm?: number, limit?: integer }
- `POST https://api.mcp.ai/api/flightradar/type` — Aeronaves de um tipo ICAO especifico transmitindo agora no mundo (ex.: PC12 = Pilatus PC-12, E195 = Embraer 195, AS50 = Esquilo). Retorna { total_airborne, aircraft[] } com posição de cada uma. Funcio
  - body: { type: string, limit?: integer }

## Example prompts
- "Which plane is flying over me right now?"
- "Where is aircraft N12345?"
- "How many planes are over New York within 30 miles?"

## More
- Page: https://mcp.ai/flightradar
- Agent spec (llms.txt): https://mcp.ai/flightradar/llms.txt
- Postman collection: https://mcp.ai/flightradar/postman.json