kicad-copilot
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KICAD_CLI_PATH | No | Path to the kicad-cli executable when it is stored outside standard locations. If not set, KiCad Copilot searches PATH and standard KiCad installation locations. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| component_searchA | Search a component by exact part_uuid or MPN. |
| search_reused_blockB | Search reusable circuit blocks by function. For circuit workflow docs, read: /app/docs/SKILL.md |
| beautify_schematicA | Reassemble selected KiCad components into named functional blocks while preserving their electrical connections. Recoverable item errors are returned (max 36). For circuit workflow docs, read: /app/docs/SKILL.md |
| extract_circuitB | Apply circuit changes to a KiCad .kicad_sch file. Every added component must include part_uuid. Recoverable item errors are returned (max 36). For circuit modification docs, read: /app/docs/SKILL.md |
| get_schematicA | Get exactly one KiCad .kicad_sch file as a compact component and net list. For circuit workflow docs, read the local docs folder: /app/docs/SKILL.md |
| create_docA | Create a KiCad project, schematic, hierarchical page, or empty PCB without overwriting files. Agent instructions: /app/docs/SKILL.md |
| get_project_infoB | Build KiCad project and hierarchical schematic trees from a file or directory path. Agent instructions: /app/docs/SKILL.md |
| list_checkpointsB | List file checkpoints saved by KiCad Copilot. Agent instructions: /app/docs/SKILL.md |
| save_checkpointB | Save an exact checkpoint of one KiCad file. Agent instructions: /app/docs/SKILL.md |
| restore_checkpointA | Restore one exact file checkpoint by id. Agent instructions: /app/docs/SKILL.md |
| set_pcb_stack_layersB | Set the PCB copper layer count while preserving F.Cu and B.Cu. PCB instructions: /app/docs/pcb-layout/instructions.md |
| import_pcb_changesC | Synchronize one KiCad PCB from its associated schematic. PCB instructions: /app/docs/pcb-layout/instructions.md |
| get_pcb_component_sizesC | Return server placement footprint sizes and compact board estimate. PCB instructions: /app/docs/pcb-layout/instructions.md |
| make_pcb_layoutA | Create placement without changing the PCB and return PNG/SVG preview paths. PCB instructions: /app/docs/pcb-layout/instructions.md |
| wait_pcb_layoutB | Wait for an active make_pcb_layout operation and return its PNG/SVG preview paths. |
| cancel_pcb_layoutA | Request cancellation of an active make_pcb_layout operation. |
| assemble_pcb_layoutB | Apply a stored placement to one KiCad PCB. PCB instructions: /app/docs/pcb-layout/instructions.md |
| auto_route_pcbC | Route a KiCad PCB with the bundled local WASM router and apply it atomically. PCB instructions: /app/docs/pcb-layout/instructions.md |
| wait_auto_routeB | Wait for a running local PCB auto-route operation. |
| cancel_auto_routeA | Cancel a running local PCB auto-route operation. |
| clear_pcb_routingA | Delete PCB tracks, track arcs, and vias while preserving placement, zones, and outline. PCB instructions: /app/docs/pcb-layout/instructions.md |
| pour_pcb_layersB | Create managed full-board copper zones and optional stitching vias. PCB instructions: /app/docs/pcb-layout/instructions.md |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| kicad_copilot_mcp_skill | Use the locally installed KiCad Copilot MCP agent instructions. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| kicad_copilot_mcp_skill | Path to the locally installed KiCad Copilot MCP agent instructions. |
TDQS
Scored across 22 tools
Each tool targets a distinct operation: schematic editing, project queries, checkpoint management, and PCB layout/routing phases. The wait/cancel pairs for long-running operations are clearly separated from the operations themselves, and no two tools appear to perform the same task.
All tool names follow a consistent verb_noun snake_case pattern (e.g., get_schematic, save_checkpoint, auto_route_pcb). Even compound verbs like auto_route and pour_pcb_layers maintain the convention, and wait_/cancel_ prefixes are systematically used for async operations.
At 22 tools, the count is on the higher end, but the server spans three major subdomains (schematic, project/checkpoints, PCB layout/routing), and each tool addresses a concrete need. The count is slightly above the 'ideal' range but not excessive for this scope.
The toolset covers schematic retrieval and modification, project inspection, checkpointing, and a full PCB workflow from layer setup to routing and copper pour. Minor gaps exist (e.g., no direct manual editing of individual tracks or component placements), but the automated workflow is well-covered and agents can work around these limitations.