track_multiple_callsigns
Monitor multiple ham radio callsigns simultaneously to track positions and support balloon chase operations using APRS.fi data.
Instructions
Track multiple callsigns at once
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| callsigns | Yes | Array of callsigns to track | |
| apiKey | No | APRS.fi API key (optional if set via /set-api-key) |
Implementation Reference
- index.ts:409-421 (handler)MCP tool handler in the CallToolRequestSchema switch statement that invokes the getMultiplePositions service method and formats the response as JSON text content.case 'track_multiple_callsigns': const multiplePositions = await this.aprsService.getMultiplePositions( args.callsigns as string[], args.apiKey as string ); return { content: [ { type: 'text', text: JSON.stringify(multiplePositions, null, 2), }, ], };
- index.ts:172-229 (helper)Core implementation of tracking multiple callsigns: validates input, constructs API request to APRS.fi with comma-separated callsigns, fetches and parses position data, handles errors.async getMultiplePositions(callsigns: string[], apiKey?: string): Promise<APRSPosition[]> { const keyToUse = apiKey || this.apiKey; if (!keyToUse) { throw new APRSError('APRS API key not provided. Use /set-api-key command or provide apiKey parameter.'); } if (!callsigns?.length) { return []; } const cleanCallsigns = callsigns .map(c => c.trim().toUpperCase()) .filter(c => c.length > 0); if (cleanCallsigns.length === 0) { return []; } const params = new URLSearchParams({ name: cleanCallsigns.join(','), what: 'loc', apikey: keyToUse, format: 'json' }); try { const response = await fetch(`${this.baseUrl}?${params}`); if (!response.ok) { throw new APRSError( `APRS API request failed: ${response.status} ${response.statusText}`, response.status ); } const data: APRSResponse = await response.json(); if (data.result !== 'ok') { throw new APRSError(`APRS API error: ${data.result}`); } return data.entries.map(entry => ({ ...entry, timestamp: entry.timestamp * 1000, })); } catch (error) { if (error instanceof APRSError) { throw error; } if (error instanceof TypeError && error.message.includes('fetch')) { throw new APRSError('Network error: Unable to connect to APRS.fi API. Check your internet connection.'); } throw new APRSError(`Unexpected error: ${error instanceof Error ? error.message : 'Unknown error'}`); } }
- index.ts:330-349 (registration)Tool registration in ListToolsRequestSchema handler, defining name, description, and input schema.name: 'track_multiple_callsigns', description: 'Track multiple callsigns at once', inputSchema: { type: 'object', properties: { callsigns: { type: 'array', items: { type: 'string', }, description: 'Array of callsigns to track', }, apiKey: { type: 'string', description: 'APRS.fi API key (optional if set via /set-api-key)', }, }, required: ['callsigns'], }, },
- index.ts:332-348 (schema)Input schema defining required 'callsigns' array and optional 'apiKey' string.inputSchema: { type: 'object', properties: { callsigns: { type: 'array', items: { type: 'string', }, description: 'Array of callsigns to track', }, apiKey: { type: 'string', description: 'APRS.fi API key (optional if set via /set-api-key)', }, }, required: ['callsigns'], },