thealeph_traceroute_mapper
Enrich traceroute data with network intelligence including ASN, PTR records, and geographic locations to analyze network paths.
Instructions
Enrich traceroute hops with network intelligence including ASN, PTR records, and geographic locations
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| traceroute | Yes | Traceroute output as a string | |
| mode | No | Traceroute format mode | string |
Implementation Reference
- src/tools.js:200-219 (registration)Tool registration in getToolDefinitions(), including name, description, and input schema definition.{ name: 'thealeph_traceroute_mapper', description: 'Enrich traceroute hops with network intelligence including ASN, PTR records, and geographic locations', inputSchema: { type: 'object', properties: { traceroute: { type: 'string', description: 'Traceroute output as a string' }, mode: { type: 'string', description: 'Traceroute format mode', enum: ['string', 'RIPE'], default: 'string' } }, required: ['traceroute'] } }
- src/tools.js:252-253 (registration)Registration/dispatch in the executeTool switch statement.case 'thealeph_traceroute_mapper': return this.tracerouteMapper(params);
- src/tools.js:600-628 (handler)Primary tool handler: processes input parameters, invokes API client, and formats enriched traceroute hops output.async tracerouteMapper(params) { try { const { traceroute, mode = 'string' } = params; const result = await this.client.mapTraceroute(traceroute, mode); let response = `🛤️ Traceroute Mapping Results (${mode} mode)\n\n`; if (Array.isArray(result)) { result.forEach((hop, idx) => { response += `**Hop ${idx + 1}:**\n`; if (hop.ip) response += ` - IP: ${hop.ip}\n`; if (hop.asn) response += ` - ASN: ${hop.asn}\n`; if (hop.ptr) response += ` - PTR: ${hop.ptr}\n`; if (hop.location) { response += ` - Location: ${JSON.stringify(hop.location)}\n`; } response += '\n'; }); } else { response += JSON.stringify(result, null, 2); } return response; } catch (error) { return `❌ Traceroute mapping failed: ${error.message}`; } }
- src/client.js:167-171 (helper)API client helper method that sends POST request to The Aleph API's /api/traceroute_mapper endpoint with traceroute data.async mapTraceroute(traceroute, mode = 'string') { return this.makeRequest('POST', '/api/traceroute_mapper', { data: { traceroute, mode } }); }