N2YO Satellite Tracker MCP Server

Instructions

Implementation Reference

• src/server.ts:219-261 (registration)

  Tool registration including name, description, and input schema definition.
  { name: "get_radio_passes", description: "Get upcoming radio communication passes of a satellite for an observer location", inputSchema: { type: "object", properties: { noradId: { type: "string", description: "NORAD catalog number of the satellite", }, observerLat: { type: "number", description: "Observer latitude in degrees", minimum: -90, maximum: 90, }, observerLng: { type: "number", description: "Observer longitude in degrees", minimum: -180, maximum: 180, }, observerAlt: { type: "number", description: "Observer altitude in meters above sea level", default: 0, }, days: { type: "number", description: "Number of days to look ahead (max 10)", default: 10, maximum: 10, }, minElevation: { type: "number", description: "Minimum elevation in degrees (max 90)", default: 10, maximum: 90, }, }, required: ["noradId", "observerLat", "observerLng"], }, },
• src/server.ts:995-1025 (handler)

  Primary MCP tool handler: validates args, fetches radio passes from client, formats and returns CallToolResult.
  private async getRadioPasses(args: any): Promise<CallToolResult> { SatelliteValidator.validateVisualPassRequest(args); // Same validation as visual passes const passes = await this.n2yoClient.getRadioPasses( args.noradId, args.observerLat, args.observerLng, args.observerAlt || 0, args.days || 10, args.minElevation || 10 ); return { content: [ { type: "text", text: JSON.stringify({ satellite: { noradId: args.noradId }, observer: { latitude: args.observerLat, longitude: args.observerLng, altitude: args.observerAlt || 0, }, radioPasses: passes, count: passes.length, note: "Radio passes optimized for communication windows with elevation and timing data" }, null, 2), }, ], }; }
• src/n2yo-client.ts:461-479 (handler)

  Core N2YO client method implementing the radio passes API call (mocked response).
  async getRadioPasses( noradId: string, observerLat: number, observerLng: number, observerAlt: number = 0, days: number = 10, minElevation: number = 10 ): Promise<RadioPass[]> { const response = await this.makeRequest(`/radiopasses/${noradId}/${observerLat}/${observerLng}/${observerAlt}/${days}/${minElevation}`, { id: noradId, observer_lat: observerLat, observer_lng: observerLng, observer_alt: observerAlt, days, min_elevation: minElevation, }); return response.passes || []; }
• src/n2yo-client.ts:54-67 (schema)

  TypeScript interface defining the structure of radio pass data.
  export interface RadioPass { startAz: number; startAzCompass: string; startEl: number; startUTC: number; maxAz: number; maxAzCompass: string; maxEl: number; maxUTC: number; endAz: number; endAzCompass: string; endEl: number; endUTC: number; }
• src/server.ts:456-457 (registration)

  Dispatch registration in callTool switch statement.
  case "get_radio_passes": return await this.getRadioPasses(args);