get_radio_passes
Find upcoming radio communication passes for a satellite based on your location. Enter the satellite's NORAD ID, your latitude, longitude, and optional altitude to get pass details for the next 10 days.
Instructions
Get upcoming radio communication passes of a satellite for an observer location
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | Number of days to look ahead (max 10) | |
| minElevation | No | Minimum elevation in degrees (max 90) | |
| noradId | Yes | NORAD catalog number of the satellite | |
| observerAlt | No | Observer altitude in meters above sea level | |
| observerLat | Yes | Observer latitude in degrees | |
| observerLng | Yes | Observer longitude in degrees |
Implementation Reference
- src/server.ts:995-1025 (handler)The primary handler function for the 'get_radio_passes' MCP tool. Validates arguments, delegates to N2YOClient, and returns formatted 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/server.ts:222-260 (schema)JSON Schema defining the input parameters and validation rules for the get_radio_passes tool.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:219-261 (registration)Registration of the get_radio_passes tool in the getTools() method, including name, description, and input schema.{ 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/n2yo-client.ts:461-479 (helper)Supporting method in N2YOClient that performs the actual API request to retrieve radio passes data from N2YO service.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 || []; }