# KiCad Copilot (npm · kicad-copilot-mcp)

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

- Trust score: 78/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-13

## Components

- npm · `kicad-copilot-mcp`: 78/100 (this document), [markdown](https://verifymcp.io/servers/biosshot-kicad-copilot/kicad-copilot-mcp.md), [page](https://verifymcp.io/servers/biosshot-kicad-copilot/kicad-copilot-mcp)

## Channel facts

- Registry: `npm`
- Package: `kicad-copilot-mcp`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-13.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 144 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to biosshot/kicad-copilot).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 80/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Tool/resource definitions use about 1662 tokens (~72/item across 23 items; 22 tools + 1 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 83/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 49% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add biosshot-kicad-copilot -- npx -y kicad-copilot-mcp
```

### Codex

```bash
codex mcp add biosshot-kicad-copilot -- npx -y kicad-copilot-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "biosshot-kicad-copilot": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kicad-copilot-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add biosshot-kicad-copilot --command npx --arg -y --arg kicad-copilot-mcp
```

### Hermes

```yaml
mcp_servers:
  biosshot-kicad-copilot:
    command: "npx"
    args: ["-y", "kicad-copilot-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "biosshot-kicad-copilot": {
      "command": "npx",
      "args": [
        "-y",
        "kicad-copilot-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-11 (score 78, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-08-09 (score 77)

First indexed and scored.

## MCP tools (22)

### `component_search` (~31 tokens)

Search Component

Search a component by exact part_uuid or MPN.

Input parameters:

- `MPN`
- `part_uuid`

### `search_reused_block` (~82 tokens)

Search Reused Block

Search reusable circuit blocks by function. For circuit workflow docs, read: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `limit` (integer): Number of results per page.
- `page` (integer): Current results page.
- `query` (string, required): Query example: "3.3V power regulator"

### `beautify_schematic` (~92 tokens)

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: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `blocks` (object, required): Component groups keyed by block name.
- `path` (string, required): Existing target .kicad_sch path.

### `extract_circuit` (~193 tokens)

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: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `add_components` (array, required): Components to add
- `add_reused_blocks` (array, required): reuded blocks to add
- `external_connect` (required): Use only when you need to connect to a pin of an external component that you have not modified and that does not have a signal_name
- `external_rm_connect` (required): Use only if you need to remove/break the connection from an external component's pin. Remember to remove external_rm_connect first and then add external_connect.
- `path` (string, required): Existing target .kicad_sch path.
- `rm_components` (required): Components to remove from the circuit

### `get_schematic` (~75 tokens)

Get KiCad Schematic

Get exactly one KiCad .kicad_sch file as a compact component and net list. For circuit workflow docs, read the local docs folder: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `path` (string, required): Target .kicad_sch file path.

### `create_doc` (~54 tokens)

Create KiCad Document

Create a KiCad project, schematic, hierarchical page, or empty PCB without overwriting files. Agent instructions: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `doc` (required)

### `get_project_info` (~61 tokens)

Get KiCad Project Info

Build KiCad project and hierarchical schematic trees from a file or directory path. Agent instructions: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `path` (string, required): Path to a KiCad file or directory.

### `list_checkpoints` (~78 tokens)

List KiCad Checkpoints

List file checkpoints saved by KiCad Copilot. Agent instructions: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `limit` (integer): Maximum checkpoints per page.
- `page` (integer): Page number, starting from 1.
- `path` (string, required): Target KiCad file path.

### `save_checkpoint` (~62 tokens)

Save KiCad Checkpoint

Save an exact checkpoint of one KiCad file. Agent instructions: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `description` (string): Short checkpoint description.
- `path` (string, required): Target KiCad file path.

### `restore_checkpoint` (~64 tokens)

Restore KiCad Checkpoint

Restore one exact file checkpoint by id. Agent instructions: /workdir/node_modules/kicad-copilot-mcp/docs/SKILL.md

Input parameters:

- `id` (string, required): Checkpoint id from list_checkpoints.
- `path` (string, required): Target KiCad file path.

### `set_pcb_stack_layers` (~73 tokens)

Set PCB Stack Layers

Set the PCB copper layer count while preserving F.Cu and B.Cu. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `copper_layer_count` (required)
- `path` (string, required): Target .kicad_pcb path.

### `import_pcb_changes` (~75 tokens)

Import PCB Changes

Synchronize one KiCad PCB from its associated schematic. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `path` (string, required): Target .kicad_pcb path.
- `schematic_path`: Optional root .kicad_sch override.

### `get_pcb_component_sizes` (~72 tokens)

Get PCB Component Sizes

Return server placement footprint sizes and compact board estimate. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `designators`
- `include_all`
- `path` (string, required): Target .kicad_pcb path.

### `make_pcb_layout` (~85 tokens)

Make PCB Layout

Create placement without changing the PCB and return PNG/SVG preview paths. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `file` (string, required): JavaScript PCB layout DSL file path.
- `path` (string, required): Target .kicad_pcb path.
- `wait_ms` (number)

### `wait_pcb_layout` (~44 tokens)

Wait PCB Layout

Wait for an active make_pcb_layout operation and return its PNG/SVG preview paths.

Input parameters:

- `operation_id` (string, required)
- `wait_ms` (number)

### `cancel_pcb_layout` (~29 tokens)

Cancel PCB Layout

Request cancellation of an active make_pcb_layout operation.

Input parameters:

- `operation_id` (string, required)

### `assemble_pcb_layout` (~67 tokens)

Assemble PCB Layout

Apply a stored placement to one KiCad PCB. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `layout_id` (string, required)
- `path` (string, required): Target .kicad_pcb path.

### `auto_route_pcb` (~127 tokens)

Auto Route PCB

Route a KiCad PCB with the bundled local WASM router and apply it atomically. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `ignore_nets` (array)
- `path` (string, required): Target .kicad_pcb path.
- `pour_gnd` (boolean)
- `route_layers` (array)
- `routing_effect_priority` (string)
- `stitch_gnd` (boolean)
- `timeout_sec` (integer)
- `wait_ms` (integer)

### `wait_auto_route` (~35 tokens)

Wait Auto Route

Wait for a running local PCB auto-route operation.

Input parameters:

- `operation_id` (string, required)
- `wait_ms` (integer)

### `cancel_auto_route` (~26 tokens)

Cancel Auto Route

Cancel a running local PCB auto-route operation.

Input parameters:

- `operation_id` (string, required)

### `clear_pcb_routing` (~82 tokens)

Clear PCB Routing

Delete PCB tracks, track arcs, and vias while preserving placement, zones, and outline. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `ignore_nets`
- `only_nets`
- `path` (string, required): Target .kicad_pcb path.

### `pour_pcb_layers` (~130 tokens)

Pour PCB Layers

Create managed full-board copper zones and optional stitching vias. PCB instructions: /workdir/node_modules/kicad-copilot-mcp/docs/pcb-layout/instructions.md

Input parameters:

- `edge_margin_mm` (number)
- `layers` (array, required)
- `max_vias` (integer)
- `net` (string, required)
- `path` (string, required): Target .kicad_pcb path.
- `stitch_grid_mm` (number)
- `stitch_vias` (boolean)
- `via_diameter_mm` (number)
- `via_drill_mm` (number)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/biosshot-kicad-copilot/kicad-copilot-mcp#diagnostics

## Score history

- 2026-08-13: 78
- 2026-08-12: 78
- 2026-08-11: 78
- 2026-08-10: 77
- 2026-08-09: 77

## Links

- npm package: https://www.npmjs.com/package/kicad-copilot-mcp
- Socket report: https://socket.dev/npm/package/kicad-copilot-mcp
- Repository: https://github.com/biosshot/kicad-copilot
- Changelog RSS feed: https://verifymcp.io/servers/biosshot-kicad-copilot/kicad-copilot-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/biosshot-kicad-copilot/kicad-copilot-mcp.json
- HTML version of this page: https://verifymcp.io/servers/biosshot-kicad-copilot/kicad-copilot-mcp