KiCad Copilot MCP server

by biosshot·io.github.biosshot/kicad-copilot·v0.1.0·13 stars

No reviews yet

File-oriented MCP server for KiCad schematics, PCB placement, routing, and pours.

B80/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B80/100

full report

Adoption

Growing

13 stars41 downloads/wk

Reviews

Write one

Nobody has reviewed KiCad Copilot yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

KiCad Copilot tools (22, 6 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

assemble_pcb_layout
Apply a stored placement to one KiCad PCB. PCB instructions: …
auto_route_pcb
Route a KiCad PCB with the bundled local WASM router and apply it atomically. PCB instructions: …
beautify_schematic
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: …
cancel_auto_routewrite action
Cancel a running local PCB auto-route operation.
cancel_pcb_layoutwrite action
Request cancellation of an active make_pcb_layout operation.
clear_pcb_routingwrite action
Delete PCB tracks, track arcs, and vias while preserving placement, zones, and outline. PCB instructions: …
component_search
Search a component by exact part_uuid or MPN.
create_docwrite action
Create a KiCad project, schematic, hierarchical page, or empty PCB without overwriting files. Agent instructions: …
extract_circuit
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: …
get_pcb_component_sizes
Return server placement footprint sizes and compact board estimate. PCB instructions: …
get_project_info
Build KiCad project and hierarchical schematic trees from a file or directory path. Agent instructions: …
get_schematic
Get exactly one KiCad .kicad_sch file as a compact component and net list. For circuit workflow docs, read the local docs folder: …
import_pcb_changes
Synchronize one KiCad PCB from its associated schematic. PCB instructions: …
list_checkpoints
List file checkpoints saved by KiCad Copilot. Agent instructions: …
make_pcb_layoutwrite action
Create placement without changing the PCB and return PNG/SVG preview paths. PCB instructions: …
pour_pcb_layerswrite action
Create managed full-board copper zones and optional stitching vias. PCB instructions: …
restore_checkpoint
Restore one exact file checkpoint by id. Agent instructions: …
save_checkpoint
Save an exact checkpoint of one KiCad file. Agent instructions: …
search_reused_block
Search reusable circuit blocks by function. For circuit workflow docs, read: …
set_pcb_stack_layers
Set the PCB copper layer count while preserving F.Cu and B.Cu. PCB instructions: …
wait_auto_route
Wait for a running local PCB auto-route operation.
wait_pcb_layout
Wait for an active make_pcb_layout operation and return its PNG/SVG preview paths.

Public scan report

scanner v0.1.9 · 2026-09-23 · same rubric, same numbers if you re-run it

1 medium

Code scan22 source files scanned20/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitylocal package, no credentials required12/15
Maintenancelast push 32 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Findings (1)

mediumeval / new Function usedexec.eval

dist/index.js: …ode, sch); const makeValidate = new Function(`${names_1.default.self}`, `${names_1.de…

Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How KiCad Copilot compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 80/100; higher than 60% of 48,255 servers
Tools: 22; the typical server has 7
Tools that change things: 27%; typical: 0%. Fewer write tools means less an agent can break
GitHub stars: 13; more than 89% of 28,688 servers
Downloads a week: 41; more than 33% of 12,191 servers with a package

What its tools let an agent do: 13 read · 4 create · 3 change · 2 delete

Install KiCad Copilot in Claude Code, Cursor or VS Code

Runs npx -y kicad-copilot-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add kicad-copilot -- npx -y kicad-copilot-mcp

Add to Cursor

What the publisher says

From the KiCad Copilot repository's README, as published. We do not edit it. Read it on GitHub

KiCad Copilot

AI-powered MCP server for KiCad. Create and modify schematics from natural language, search real components, work with hierarchical projects, generate PCB placement, route boards locally, and create simple copper pours directly through an AI agent.

KiCad Copilot is the KiCad counterpart to EasyEDA Copilot. It provides the same core circuit-generation and PCB automation capabilities—and goes further with file-oriented hierarchical projects, recoverable checkpoints, native kicad-cli integration, and fully local PCB routing.

Integrated analysis: KiCad Copilot downloads a pinned, verified kicad-happy v2.2.0 release on first use of analyzeschematic or analyzepcb. The MCP tools return compact, token-efficient actionable findings and focused design data.

What it does

KiCad Copilot gives AI agents a high-level, file-oriented interface to KiCad:

Generate and modify schematics: add, remove, replace, and connect real components without editing every KiCad object individually.
Rebuild schematic blocks: reorganize selected components while preserving their electrical connections.
Search components and reusable blocks: resolve components by MPN or part UUID and insert proven functional circuits.
Work with KiCad projects: inspect project trees and create projects, standalone schematics, hierarchical sheets, and PCB files.
Preserve recoverable checkpoints: save, list, and restore exact versions of individual KiCad files.
Synchronize schematic and PCB: explicitly import schematic changes into the associated board.
Generate PCB placement: describe board constraints in a compact JavaScript DSL, review PNG/SVG previews, and apply the approved result.
Route locally: use eda-copilot-router with its managed KRT backend without sending routing work to an external service.
Create copper pours: add simple full-board zones with optional stitching vias.
Use native KiCad tooling: discover kicad-cli for ERC, DRC, previews, exports, manufacturing files, and other native operations.

KiCad Copilot works directly with saved .kicadpro, .kicadsch, and .kicad_pcb files. It does not require KiCad IPC or a plugin installed inside KiCad.

Examples

These projects were generated and iterated through KiCad Copilot. The complete KiCad source files are available in the examples directory.

ATmega328P development board

A hierarchical ATmega328P design with the MCU core, clock, reset, decoupling, USB-UART power, Nano-compatible headers, and debug connections split across functional sheets.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

KiCad Copilot: common questions

Is KiCad Copilot MCP server safe?: Mostly: it is graded B (80/100). Read the KiCad Copilot safety report
How do I install KiCad Copilot?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does KiCad Copilot need an API key?: Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is KiCad Copilot maintained?: The last commit was 73 days ago (2026-08-23). The latest release is v0.1.0.
How does KiCad Copilot compare with other MCP servers?: safety score 80/100 (higher than 60% of 48,255 servers); tools 22 (the typical server has 7); tools that change things 27% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.