Report kicad-mcp backend availability, capabilities, and KiCad version.

Use this first to see what is possible in the current environment: headless analysis/export (kicad-cli), schematic reads (S-expr), and live board editing (IPC, needs a running KiCad).

List KiCad projects discoverable under the configured search paths.

Info for a project (.kicad_pro path or its directory): associated files.

Create a new, minimal KiCad project under directory (within roots).

Summarize a board: copper layers, thickness, nets, footprints, extents.

Ordered physical stackup (dielectric + copper layers with thickness).

List schematic components (reference, value, lib_id, footprint).

List nets with their fan-out (node count), from the exported netlist.

Show every pin (ref + pin number/function) connected to a given net.

Run Electrical Rules Check on the schematic; return normalized findings.

Run Design Rules Check on the board; return normalized findings.

Plot gerbers + drill files for the board into a directory.

Export the schematic Bill of Materials as CSV.

Export the schematic netlist (KiCad s-expression format).

Export a STEP 3D model of the board.

Render a 3D PNG of the board from a side (top/bottom/left/right/front/back).

Bundle a complete fab package (gerbers + drill + BOM + CPL) into a zip.

Audit a board against the full Hartley/Phil's Lab rule catalog.

Returns findings grouped by severity with rule IDs, one-line physics rationales, and citations, plus a markdown summary.

Audit one rule family: stackup, grounding, return_path, decoupling, dfm.

Provide facts the files cannot contain (rise times, clocks, target impedances, connector-facing nets, fab house) to sharpen the review.

Status of the board open in the running KiCad (via IPC): item counts, layers, KiCad version. Requires the GUI with the API enabled.

List footprints on the live board with position/rotation/layer.

Move a footprint to (x, y) in mm on the live board. Single undo step.

Set a footprint's rotation in degrees on the live board. Single undo step.

Copy a placed footprint to a new reference + position (KiCad 9 IPC cannot place from a library, so cloning an on-board part is the supported 'add a part'). Give x_mm/y_mm for an absolute spot, else it offsets.

List netclasses on the live board with their track/clearance/via/diff- pair constraints and member nets.

Add a copper zone on a layer from a polygon of [x, y] mm points, optionally assigned to a net (e.g. GND). Single undo step.

Refill all copper zones on the live board.

Save the live board to disk — required before render_board / run_drc can see live edits (they read the file).

Route a trace along [x, y] mm waypoints on a layer, optionally on a net. Multi-segment, single undo step.

Add a via at (x, y) mm. Defaults to the standard 0.7/0.3 mm geometry.

Route a differential pair: P and N run parallel to the centerline waypoints, offset by (width+gap)/2 each side. Single undo step.

[EXPERIMENTAL] Set a property (Value, Footprint, ...) on an existing schematic symbol. Requires KICAD_MCP_ALLOW_SCHEMATIC_WRITE=1 and the file closed in KiCad. Returns the post-edit ERC report.

[EXPERIMENTAL] Clone a placed symbol with a new reference, offset by (dx, dy) mm. Fresh UUIDs; the new part's pins start unconnected. Requires KICAD_MCP_ALLOW_SCHEMATIC_WRITE=1 and the file closed in KiCad.

Search installed KiCad symbol libraries; returns Lib:Symbol ids.

Search installed KiCad footprint libraries; returns Lib:Footprint ids.

Search a local JLCPCB parts DB by MPN/description. Needs KICAD_MCP_JLCPCB_DB set to a jlcparts-style SQLite database.

Poll a background task (autoroute, batch export). Returns the result once status is 'done'.

List background tasks and their statuses (newest first).

Drop finished background tasks from the queue.

Start a fab-package export in the background; poll it with get_task_status. Use for large boards that may exceed the request timeout.

Autoroute a Specctra .dsn with Freerouting (background task → task_id). Needs KICAD_MCP_FREEROUTING_JAR and Java. Note: KiCad 9 cannot export DSN headlessly, so export the .dsn from the KiCad GUI first.

Show past review/DRC runs for a project (counts over time). Filter by kind: 'review' or 'drc'.

List tool categories with a description and tool count. Start here to navigate the tool surface.

List the tools in a category with their one-line descriptions.

Search tools by name or description substring.

Dispatch to any tool by name with an arguments object. Convenience for tools reached via the categories above.