Atlas / MCP servers / productofamerica / mcp-server-kicad

mcp-server-kicadSAFE

Name: mcp-server-kicad
Author: productofamerica

mcp/productofamerica/mcp-server-kicad

MCP server by productofamerica · ai · claude · claude code · Audited 2026-10-10

KiCad MCP server: 100+ Model Context Protocol tools that let an AI assistant do schematic capture and PCB layout. Place parts, route traces, run ERC and DRC, export Gerbers, BOM, and 3D models.

Verdict

SAFE

Grade

Trust score

89 /100

Exposed tools

109 60r · 37w · 12d

Transport

stdio

License

MIT

Stars

Overview

From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.

Let an AI assistant edit real KiCad projects without corrupting them.

109 MCP tools covering schematic capture, PCB layout, symbol and footprint libraries, ERC and DRC, and manufacturing exports. No screenshots, no copy-paste, no hand-edited s-expressions: the model calls tools, KiCad files change on disk.

[](https://pypi.org/project/mcp-server-kicad/) [](https://pypi.org/project/mcp-server-kicad/) [](https://www.kicad.org/) [](https://github.com/ProductOfAmerica/mcp-server-kicad/actions/workflows/ci.yml) [](LICENSE)

Quick start • What you get • Configuration • Tool reference • Requirements • Contributing

What it looks like

"Add a 100 nF decoupling cap on U1's VCC pin, then check ERC."

get_pin_positions            locate U1's VCC and GND pins
auto_place_decoupling_cap    place C3 and wire both pins to their nets
run_erc                      report what the change broke

"Now push the netlist to the board and route it."

update_pcb_from_schematic    sync footprints and pad nets onto the PCB
autoroute

Read from source at commit 71dc34ad36d4OBSERVED · 2026-10-10

Connect

Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.

claude-code (pypi)

claude mcp add mcp-server-kicad -- uvx mcp-server-kicad==0.20.1

Exposed tools (109)

60 read · 37 write · 12 destructive. Blast radius: 12 tools can delete or overwrite — an agent that can be talked into calling a tool can be talked into calling this one.

Tool	Risk	Description
`add_copper_zone`	write	Create an unfilled copper zone: a ground plane, power plane, or any
`add_global_label`	write	Add a global net label (visible across all sheets).
`add_hierarchical_label`	write	Add a hierarchical label to a sub-sheet schematic.
`add_hierarchical_sheet`	write	Add a hierarchical sheet to a parent schematic with matching labels in the child.
`add_junctions`	write	Add multiple junctions. Each point dict has keys: x, y.
`add_keepout_zone`	write	Create a keep-out zone that restricts placement of specified items.
`add_label`	write	Add a net label at a position.
`add_lib_symbol`	write	Load a symbol definition from a .kicad_sym library into the schematic.
`add_pcb_line`	write	Add a graphic line to the PCB (edge cuts, silkscreen, etc.).
`add_pcb_text`	write	Add text to the PCB (silkscreen, fab layer, etc.).
`add_power_symbol`	write	Place a power symbol (VCC, GND, +3V3, etc.).
`add_sheet_pin`	write	Add a pin to an existing hierarchical sheet block.
`add_symbol`	write	Add a new symbol definition to a .kicad_sym library.
`add_text`	write	Add a text annotation to the schematic.
`add_thermal_vias`	write	Add a grid of thermal vias under a footprint pad.
`add_trace`	write	Add a trace segment between two points.
`add_via`	write	Add a via at a position.
`add_wires`	write	Add multiple wires at once. Each wire dict has keys: x1, y1, x2, y2.
`annotate_schematic`	read	Auto-assign reference designators to unannotated components.
`auto_place_decoupling_cap`	read	Place a decoupling capacitor and wire it to power/ground nets.
`autoroute_pcb`	read	Autoroute PCB traces using the Freerouting autorouter.
`check_placement`	read	Check if placing/moving a footprint to (x, y) would violate constraints.
`connect_pins`	read	Connect two component pins with Manhattan (L-shaped) wire routing.
`create_project`	write	Create a KiCad 9 project (.kicad_pro + .kicad_prl + .kicad_sch).
`create_schematic`	write	Create a valid empty KiCad 9 schematic file.
`create_sym_lib_table`	write	Create a sym-lib-table file in the given directory.
`create_symbol_library`	write	Create a valid empty KiCad 9 symbol library.
`duplicate_sheet`	read	Duplicate a hierarchical sheet, copying the child file with new UUIDs.
`export_3d`	read	Export PCB 3D model or render 3D view to image.
`export_bom`	read	Export Bill of Materials (BOM) as CSV.
`export_footprint_svg`	read	Export footprint to SVG.
`export_gerbers`	read	Export Gerber files for manufacturing.
`export_hierarchical_netlist`	read	Export a netlist from the root schematic, including hierarchy info.
`export_ipc2581`	read	Export PCB in IPC-2581 format for manufacturing data exchange.
`export_netlist`	read	Export a schematic netlist.
`export_pcb`	read	Export PCB to PDF, SVG, or DXF format.
`export_positions`	read	Export component position file (pick and place).
`export_schematic`	read	Export schematic to PDF, SVG, or DXF format.
`export_symbol_svg`	read	Export symbol library to SVG images.
`fill_zones`	read	Fill all copper zones on the board using pcbnew
`flatten_hierarchy`	read	Flatten a hierarchical schematic into a single sheet.
`get_board_info`	read	Get board summary: footprint count, trace count, net count, thickness.
`get_footprint_bounds`	read	Get the board-coordinate bounding box of a placed footprint.
`get_footprint_info`	read	Get pad and outline details for a footprint .kicad_mod file.
`get_footprint_pads`	read	Get pad info for a placed footprint on the PCB.
`get_net_connections`	read	Find all component pins connected to a net label.
`get_pin_positions`	read	Get absolute pin positions for a placed component (accounts for rotation/mirror).
`get_schematic_summary`	read	Get schematic page info and item counts.
`get_sheet_info`	read	Get detailed info about a hierarchical sheet including pin/label matching.
`get_symbol_info`	read	Get detailed pin and property info for a symbol in a library.
`get_symbol_instances`	read	List all symbol instances from a root schematic
`get_symbol_pins`	read	Get pin info for a symbol in the schematic
`get_version`	read	Get KiCad version information including build details and library versions.
`is_root_schematic`	read	Check if a schematic is the root or a sub-sheet.
`list_cross_sheet_nets`	read	List all nets that cross sheet boundaries (hierarchical pins and global labels).
`list_hierarchy`	read	List the full sheet hierarchy starting from a root schematic.
`list_lib_footprints`	read	List all footprints in a .pretty library directory.
`list_lib_symbols`	read	List all symbols in a .kicad_sym library file.
`list_pcb_footprints`	read	List all footprints on the PCB.
`list_pcb_graphic_items`	read	List all graphic items (lines, text, etc.) on the PCB.
`list_pcb_layers`	read	List all layers defined in the PCB stackup: copper, silkscreen,
`list_pcb_nets`	read	List all named nets on the PCB.
`list_pcb_traces`	read	List all trace segments and vias on the PCB.
`list_pcb_zones`	read	List all zones (copper and keepout) on the PCB.
`list_schematic_bus_entries`	read	List all bus entries in the schematic.
`list_schematic_components`	read	List all placed components in the schematic.
`list_schematic_global_labels`	read	List all global labels in the schematic.
`list_schematic_hierarchical_labels`	read	List all hierarchical labels in the schematic.
`list_schematic_junctions`	read	List all junctions in the schematic.
`list_schematic_labels`	read	List all net labels in the schematic.
`list_schematic_no_connects`	read	List all no-connect flags in the schematic.
`list_schematic_sheets`	read	List all hierarchical sheets in the schematic.
`list_schematic_wires`	read	List all wire segments in the schematic.
`list_unconnected_pins`	read	List unconnected pins by running ERC and filtering results.
`modify_hierarchical_label`	write	Modify an existing hierarchical label.
`modify_hierarchical_sheet`	write	Modify properties of an existing hierarchical sheet block.
`move_component`	write	Move a placed component to a new position.
`move_footprint`	write	Move a footprint to a new position.
`move_hierarchical_sheet`	write	Move a hierarchical sheet block to a new position, including all pins.
`no_connect_pin`	read	Place a no-connect flag on a component pin.
`place_component`	read	Place a schematic symbol: resistor, capacitor, inductor, diode, LED,
`place_footprint`	read	Place a footprint on the PCB.
`remove_component`	destructive	Remove a component by reference designator.
`remove_dangling_tracks`	destructive	Detect and remove trace segments with unconnected endpoints.
`remove_footprint`	destructive	Remove a footprint by reference designator.
`remove_hierarchical_label`	destructive	Remove a hierarchical label by name or UUID.
`remove_hierarchical_sheet`	destructive	Remove a hierarchical sheet block from a parent schematic.
`remove_junction`	destructive	Remove a junction at the given coordinates.
`remove_label`	destructive	Remove net label(s) or global label(s) by text, optionally filtered by position.
`remove_no_connect`	destructive	Remove no-connect flag(s) from a component pin.
`remove_sheet_pin`	destructive	Remove a pin from a hierarchical sheet block.
`remove_text`	destructive	Remove text annotation(s) by content, optionally filtered by position.
`remove_traces`	destructive	Remove trace segments matching the given filters. Does not remove vias.
`remove_wire`	destructive	Remove a wire segment by its endpoint coordinates.
`reorder_sheet_pages`	write	Reorder hierarchical sheets by specifying the desired UUID order.
`run_drc`	write	Run Design Rules Check (DRC) on a PCB.
`run_erc`	write	Run Electrical Rules Check (ERC) on a schematic.
`run_jobset`	write	Run a KiCad jobset file.
`set_component_property`	write	Set any property on a placed component, or rename it. Creates the
`set_net_class`	write	Create or update a net class with design rules and assign nets.
`set_page_size`	write	Set the schematic page/sheet size.
`set_trace_width`	write	Change the width of existing traces matching the given filters.
`trace_hierarchical_net`	read	Trace a net across the hierarchy, following hierarchical pins and labels.
`update_pcb_from_schematic`	write	Update the PCB from the schematic (headless Tools -> Update PCB from Schematic).
`upgrade_footprint_lib`	read	Upgrade a footprint library to current KiCad format.
`upgrade_symbol_lib`	read	Upgrade a symbol library to current KiCad format.
`validate_board`	read	Validate all footprint placements against keep-out zones and board edge.
`validate_hierarchy`	read	Validate hierarchical schematic for common issues.
`wire_pins_to_net`	write	Put each listed pin on the net named label_text, or refuse and write nothing.

Trust audit

SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.

Layer	What it checks	Result
L0	Provenance & inventory	PASS
L1	Static analysis of the code	PASS
L2	Instruction surface (what it tells the agent)	PASS
L3	Class-specific surface	WARN
L4	Behavioural (sandbox)	SKIPPED

What the source does

Filesystem: declared (4 observation(s))
Network: declared (7 observation(s))
Shell: none-observed
Dependencies: pinned
Secrets in source: none-found

Findings (7)

MEDIUMFilesystem / path · mcp.destructive_tools · CWE-22, CWE-59

remove_component, remove_dangling_tracks, remove_footprint, remove_hierarchical_label, remove_hierarchical_sheet, remove_junction, remove_label, remove_no_connect, remove_sheet_pin, remove_text, remov

Why it matters. 12 tool(s) can delete or overwrite

Fix. prefer a read-only mode or scoped tokens; the page states the blast radius

LOWInventory / provenance · inv.hidden_file · CWE-1104

.coderabbit.yaml

.coderabbit.yaml

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWInventory / provenance · inv.hidden_file · CWE-1104

.pre-commit-config.yaml

.pre-commit-config.yaml

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWInventory / provenance · inv.hidden_file · CWE-1104

mcpb/.mcpbignore

.mcpbignore

Why it matters. hidden member outside the usual dotfiles

Fix. review its purpose

LOWObfuscation / stealth · obf.decode_call · CWE-506, CWE-94

tests/test_netlist_import.py:682

documents = Path(base64.b64decode(out.stdout.strip()).decode("utf-8"))

LOWObfuscation / stealth · obf.decode_then_exec · CWE-506, CWE-94

tests/test_netlist_import.py:682

b64decode( ... subprocess.

Why it matters. decodes a payload and executes it

INFOPrompt injection · prompt.authority_framing · CWE-94, CWE-1427

agents/code-reviewer.md:10

You are a Senior Code Reviewer for the mcp-server-kicad project, a Python MCP

Gates applied: no_behavioural_pass.

Audited 2026-10-10 · audit v0.4.1 · source sha 71dc34ad36d4full audit observations/trust-audit/mcp-server/productofamerica__mcp-server-kicad.json · Report an issue / request a re-scan

Audit history

Every audit this server has had. A grade with a past is a grade somebody is still checking.

Date	Source	Verdict	Grade	Score	Change
2026-10-10	`71dc34ad36d4`	SAFE	B	89	first audit

Questions

What is the mcp-server-kicad MCP server?

KiCad MCP server: 100+ Model Context Protocol tools that let an AI assistant do schematic capture and PCB layout. Place parts, route traces, run ERC and DRC, export Gerbers, BOM, and 3D models.

What tools does mcp-server-kicad expose?

109 in total: 60 read-only, 37 that write, and 12 that can delete or overwrite (remove_component, remove_dangling_tracks, remove_footprint, remove_hierarchical_label, remove_hierarchical_sheet). Every one is listed on this page with its risk.

Is mcp-server-kicad safe to connect to an agent?

The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B. Separately from the audit: 12 of its tools can destroy data, so scope the token you give it to what you actually need.

What credentials does mcp-server-kicad need?

No credential environment variables were found in its source, so it appears to need none.

How does mcp-server-kicad run?

It speaks stdio, so it runs as a local process your client starts. It is published on PyPI as mcp-server-kicad.

How current is this page?

The grade is for one exact copy of the source (71dc34ad36d4), read on 2026-10-10. The repository is watched and re-audited when it changes.

Source	ProductOfAmerica/mcp-server-kicad
PyPI	`mcp-server-kicad`
Transports	stdio
License	MIT
Activity	pushed 0d ago