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);
  }