add_global_label
Add a global label to a component pin in a KiCad schematic, connecting nets by name across all project sheets.
Instructions
Add a global label on a pin of a component.
A global label connects the nets with its name in all sheets of the project.
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>",
"pin": "<pin>",
"label_name": "<label_name>"
},
"name": "add_global_label"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | ||
| y | No | ||
| pin | Yes | The pin number. | |
| shape | No | The electrical type of the label: "input" (default), "output", "bidirectional", "tri_state" or "passive". ERC uses it. | input |
| file_path | Yes | The .kicad_sch file. | |
| reference | Yes | The reference of the component, for example "U1". | |
| label_name | Yes | The name of the net. | |
| snap_to_grid | No | Only for x and y. True: move the label to the nearest point of the connection grid of the project (default 1.27 mm), except on a connection point of the sheet (a pin, a wire, a label). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |