get_historic_flight_events_light
Retrieve historical flight events like takeoff, landing, and gate transitions for specific flights using Flightradar24 data.
Instructions
Returns selected historical flight events (gate_departure, takeoff, cruising, airspace_transition, resuming_flightplan, descent, landed, gate_arrival), sorted by event_timestamp and grouped by flight_id. REQUIRED: flight_ids and event_types must be provided and non-empty.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flight_ids | Yes | Comma-separated fr24_ids (maximum 15 IDs). Cannot be combined with event_datetime. | |
| event_types | Yes | Event types to filter by (comma-separated values). Available values: all, gate_departure, takeoff, cruising, airspace_transition, descent, landed, gate_arrival. |
Implementation Reference
- src/fr24-client.ts:118-120 (handler)Core implementation of the getHistoricFlightEventsLight method, which invokes the makeRequest helper to fetch light historic flight events from the FR24 API endpoint '/historic/flight-events/light'.
async getHistoricFlightEventsLight(params: HistoricFlightEventsQueryParams): Promise<HistoricFlightEventsLight[]> { return this.makeRequest<HistoricFlightEventsLight[]>('/historic/flight-events/light', params); } - src/server.ts:97-100 (schema)Zod input schema for validating tool parameters: flight_ids (comma-separated FR24 flight IDs) and event_types.
const historicFlightEventsSchema = z.object({ flight_ids: z.string().min(1).describe('Comma-separated fr24_ids (maximum 15 IDs). Cannot be combined with event_datetime.'), event_types: z.string().min(1).describe('Event types to filter by (comma-separated values). Available values: all, gate_departure, takeoff, cruising, airspace_transition, descent, landed, gate_arrival.') }); - src/server.ts:498-522 (registration)MCP server tool registration for 'get_historic_flight_events_light', including description, input schema reference, and the handler function that delegates to FR24Client.
server.tool( 'get_historic_flight_events_light', 'Returns selected historical flight events (gate_departure, takeoff, cruising, airspace_transition, resuming_flightplan, descent, landed, gate_arrival), sorted by event_timestamp and grouped by flight_id. REQUIRED: flight_ids and event_types must be provided and non-empty.', historicFlightEventsSchema.shape, async (params: z.infer<typeof historicFlightEventsSchema>) => { try { console.log(`Raw params received by handler: ${JSON.stringify(params)}`); const result = await fr24Client.getHistoricFlightEventsLight(params); return { content: [{ type: 'text' as const, text: `Found ${result.length} flights with historic events (light details):\n${JSON.stringify(result, null, 2)}` }] }; } catch (error) { return { content: [{ type: 'text' as const, text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}` }], isError: true }; } } ); - src/types.ts:207-210 (schema)TypeScript type definition for input parameters matching the Zod schema.
export interface HistoricFlightEventsQueryParams { flight_ids: string; // Required, comma-separated fr24_ids (maximum 15 IDs) event_types: string; // Required, comma-separated event types or 'all' } - src/types.ts:248-253 (schema)TypeScript type definition for the light output response structure containing flight ID, callsign, hex, and list of events.
export interface HistoricFlightEventsLight { fr24_id: string; callsign: string; hex: string; events: FlightEvent[]; }