Flightradar24 MCP Server

Instructions

Implementation Reference

• src/server.ts:287-306 (handler)

  MCP tool handler for 'get_flight_summary_full'. Validates parameters, cleans null/empty values, calls FR24Client.getFlightSummaryFull, and returns formatted JSON response or error.

    try {
      validateHasRequiredParams(params, ['flight_datetime_from', 'flight_datetime_to', 'sort', 'limit']);
      const cleaned = cleanParams(params);
      const result = await fr24Client.getFlightSummaryFull(cleaned);
      return {
        content: [{
          type: 'text' as const,
          text: `Found ${result.length} flight summaries (full 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/fr24-client.ts:94-96 (handler)

  Core API client method that executes the HTTP request to FR24's /flight-summary/full endpoint using the generic makeRequest helper.

  async getFlightSummaryFull(params: Record<string, any>): Promise<FlightSummaryFull[]> {
    return this.makeRequest<FlightSummaryFull[]>('/flight-summary/full', params);
  }

• src/server.ts:61-74 (schema)

  Zod input schema defining parameters for the get_flight_summary_full tool, including required date ranges and optional filters.

  const flightSummaryToolParamsSchema = 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).'),
    sort: z.enum(['asc', 'desc']).optional().describe('Sorting order by first_seen (default: asc).'),
    limit: z.number().optional().describe('Limit of results. Recommended, unless needed. Max 20000.')
  });

• src/server.ts:282-307 (registration)

  Registration of the 'get_flight_summary_full' tool on the MCP server, including name, description, input schema, and handler function.

  server.tool(
    'get_flight_summary_full',
    'Returns comprehensive timings and locations of aircraft takeoffs and landings, including detailed flight, aircraft, and operator information. Both real-time and extensive historical data are available. Data is available starting from 2024-04-07 and will be extended further in the near future. IMPORTANT: flight_datetime_from and flight_datetime_to are required, and at least one additional search parameter (other than sort and limit) should be provided.',
    flightSummaryToolParamsSchema.shape,
    async (params: z.infer<typeof flightSummaryToolParamsSchema>) => {
      try {
        validateHasRequiredParams(params, ['flight_datetime_from', 'flight_datetime_to', 'sort', 'limit']);
        const cleaned = cleanParams(params);
        const result = await fr24Client.getFlightSummaryFull(cleaned);
        return {
          content: [{
            type: 'text' as const,
            text: `Found ${result.length} flight summaries (full 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/server.ts:7-14 (helper)

  Helper function to remove null, undefined, and empty string properties from parameters before API calls.

  function cleanParams<T extends Record<string, any>>(params: T): Partial<T> {
    const cleaned: Partial<T> = {};
    for (const key in params) {
      if (params[key] !== null && params[key] !== undefined && params[key] !== '') {
        cleaned[key] = params[key];
      }
    }
    return cleaned;