Trace a mesh path
trace_pathTrace a route through a mesh network, reporting SNR for each repeater hop. Accepts a path of hex bytes or a node name to trace its known out-path; returns timeout if no response.
Instructions
Trace a route through the mesh and report each repeater hop's SNR. Give an explicit path of repeater hops (comma-separated hex bytes, e.g. "23,5f,3a") or a node (a contact name / hex prefix) to trace along its known out-path. A path that doesn't respond returns a timeout.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "trace_path"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | repeater hops as comma-separated hex bytes, e.g. "23,5f,3a" (or a hex string) | |
| node | No | a contact (name or hex prefix) to trace along its known out-path |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| completed | Yes | true when the trace round-trip completed | |
| hopCount | Yes | number of repeaters on the traced path | |
| hops | Yes | each hop's path hash (hex) and SNR in dB, in path order | |
| lastSnr | Yes | SNR of the final hop, in dB |