trace_hierarchical_connection
Trace a component's connections across every sheet in a KiCad schematic hierarchy by reading the root netlist, with an optional pin filter.
Instructions
Trace the connections of a component across the full schematic hierarchy.
The tool reads the netlist that kicad-cli writes now: it has each component of each sheet path, at each level of the hierarchy, with the reference of that path (a sheet that the hierarchy uses two times gives two references). The netlist has no power symbols and no symbol with no library symbol. The tool needs kicad-cli.
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": {
"file_path": "<file_path>",
"reference": "<reference>"
},
"name": "trace_hierarchical_connection"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | A .kicad_sch file of the project (the root schematic or a sub-sheet: the tool uses the netlist of the root schematic). | |
| reference | Yes | The reference of the component, for example "U1". | |
| pin_number | No | Optional pin number. Empty: all pins. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |