network_traceroute_stream
Streams a real-time traceroute to a target host, emitting each hop as it is discovered via Server-Sent Events.
Instructions
Traceroute (Live SSE Stream). Streams a network path trace to a target host hop-by-hop in real time as Server-Sent Events (Content-Type text/event-stream), emitting one JSON event per hop as it is discovered. Sends outbound traceroute probes over the network — preferably via a registered remote worker, with a local-fallback path — so results reflect live network state and vary between calls. CAPTCHA-gated and rate-limited (anonymous 3/min, 20/hour, 60/day). Use network_ping for a single round-trip measurement; use this when you need the full router-by-router path. Each SSE frame carries a JSON object whose "type" is one of start, hop, timeout, info, error, or complete.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"target": "<target>"
},
"name": "network_traceroute_stream"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | Destination hostname or IP address to trace (validated; private, loopback, and reserved ranges are blocked). | |
| maxHops | No | Maximum TTL / hop count before giving up (traceroute -m). The worker clamps it to 1-64. | |
| timeout | No | Per-hop probe wait in seconds (traceroute -w). The worker clamps it to 1-15. | |
| packetSize | No | Probe packet size in bytes reported in the start event; the local fallback and worker traceroute do not apply it. | |
| worker_id | No | Optional registered healthy worker peer ID. Omit to use the default master-server behavior. |