Flightradar24 MCP Server

Instructions

Implementation Reference

• src/server.ts:340-361 (handler)

  The main handler function for the 'get_flight_summary_count' tool. Validates input parameters, cleans them, calls the FR24 client method, logs the result, and returns the flight summary count in a formatted text response or an error.
  async (params: z.infer<typeof flightSummaryCountToolParamsSchema>) => { try { validateHasRequiredParams(params, ['flight_datetime_from', 'flight_datetime_to']); const cleaned = cleanParams(params); const result = await fr24Client.getFlightSummaryCount(cleaned); console.log(`Flight summary count result: ${JSON.stringify(result, null, 2)}`); return { content: [{ type: 'text' as const, text: `Flight summary count: ${result.record_count}` }] }; } catch (error) { return { content: [{ type: 'text' as const, text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}` }], isError: true }; } }
• src/server.ts:76-87 (schema)

  Zod schema defining the input parameters for the get_flight_summary_count tool, including required date range and optional filters.
  const flightSummaryCountToolParamsSchema = z.object({ flight_datetime_from: z.string().min(1).describe('Start datetime (YYYY-MM-DDTHH:MM:SSZ). Requires flight_datetime_to. Cannot be used with flight_ids.'), flight_datetime_to: z.string().min(1).describe('End datetime (YYYY-MM-DDTHH:MM:SSZ). Requires flight_datetime_from. Cannot be used with flight_ids.'), flights: z.string().min(1).optional().describe('Flight numbers (comma-separated values, max 15).'), callsigns: z.string().min(1).optional().describe('Flight callsigns (comma-separated values, max 15).'), registrations: z.string().min(1).optional().describe('Aircraft registration numbers (comma-separated values, max 15).'), painted_as: z.string().min(1).optional().describe("Aircraft painted in an airline's livery (ICAO code, comma-separated, max 15)."), operating_as: z.string().min(1).optional().describe("Aircraft operating under an airline's call sign (ICAO code, comma-separated, max 15)."), airports: z.string().min(1).optional().describe('Airports (IATA/ICAO/ISO 3166-1 alpha-2) or countries. Use format: [direction:]<code>.'), routes: z.string().min(1).optional().describe('Flights between airports/countries (e.g., SE-US, ESSA-JFK). Max 15.'), aircraft: z.string().min(1).optional().describe('Aircraft ICAO type codes (comma-separated, max 15).') });
• src/server.ts:336-362 (registration)

  MCP server.tool registration for 'get_flight_summary_count', including name, description, schema reference, and inline handler function.
  server.tool( 'get_flight_summary_count', 'Returns the number of flights for a given flight summary query. IMPORTANT: flight_datetime_from and flight_datetime_to are required, and at least one additional search parameter should be provided.', flightSummaryCountToolParamsSchema.shape, async (params: z.infer<typeof flightSummaryCountToolParamsSchema>) => { try { validateHasRequiredParams(params, ['flight_datetime_from', 'flight_datetime_to']); const cleaned = cleanParams(params); const result = await fr24Client.getFlightSummaryCount(cleaned); console.log(`Flight summary count result: ${JSON.stringify(result, null, 2)}`); return { content: [{ type: 'text' as const, text: `Flight summary count: ${result.record_count}` }] }; } catch (error) { return { content: [{ type: 'text' as const, text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}` }], isError: true }; } } );
• src/fr24-client.ts:102-104 (helper)

  FR24Client helper method that performs the actual API request to retrieve the flight summary count.
  async getFlightSummaryCount(params: Record<string, any>): Promise<RecordCountResponse> { return this.makeRequest<RecordCountResponse>('/flight-summary/count', params); }