KiCad MCP Pro Server logo

KiCad MCP Pro Server

Connects MCP clients to KiCad for project inspection, schematic and PCB review, validation, DFM checks, and manufacturing workflows.

Install KiCad MCP Pro Server

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "kicad-mcp-pro-server": {
      "command": "uvx",
      "args": [
        "kicad-mcp-pro"
      ],
      "env": {
        "KICAD_MCP_MOUNT_PATH": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Install not yet sandbox-tested— the server itself is confirmed live (we called its tools/list endpoint). The stdio install command is a separate, ongoing check.

Overview

KiCad MCP Pro Server connects MCP-capable agents to KiCad projects through stdio or Streamable HTTP. It exposes project setup and inspection, schematic and PCB analysis, visual QA, DRC/ERC, DFM, BOM pricing, and release-readiness tools. Several checks operate directly on local KiCad files, while validation tools can use KiCad’s own engines and report structured findings. Reach for it when an agent needs to review or coordinate an electronics design workflow, with human gates retained for release decisions.

Use cases

  • Inspect an active KiCad project before an agent edits or reviews it
  • Run schematic and PCB readability checks from local project geometry
  • Validate symbols, footprints, pins, references, and manufacturing rules
  • Drive a staged Planner-to-Release design workflow
  • Generate BOM pricing and summarize release readiness

Key features

  • KiCad project path and connection management
  • Schematic and PCB structural inspection
  • Headless visual QA for boards and schematics
  • DRC, ERC, DFM, and project quality gates
  • Component contract and footprint-reference validation
  • BOM summaries with unit and extended pricing

Tools24

What KiCad MCP Pro Server lets your agent do. Expand a tool for its parameters.

Verified live~2.1k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

5/5 checks healthy over the last 33d

What it can do

From the 24 tools this server returned when we ran it; 24 declare their own safety hints.

Can delete or modify data · 1Read-only tools · 23
Network at startup2 connections
Files written at startupNone

Observed 2026-10-19 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · kicad-mcp-pro (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars145Stargazers on the source repository.
Last commitTodayMost recent push to the default branch.
Tools exposed24Callable tools this server registers over MCP.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How KiCad MCP Pro Server works

What KiCad MCP Pro Server does

KiCad MCP Pro Server gives MCP clients an interface for working with KiCad EDA projects. Its catalog covers project paths and status, schematic inspection, PCB summaries, design rules, stackup data, component-contract checks, validation, DFM review, and manufacturing-oriented quality gates.

The server is designed for first-pass design and review assistance. It can inspect local project files, organize a staged design workflow, and return structured results that an agent can use for follow-up actions. The available workflow model uses Planner, Builder, Verifier, Fixer, and Release phases, including quality gates and human-gate indicators.

How it works

Start by selecting the active KiCad project directory and its file paths with kicad_set_project, then inspect the configuration with kicad_get_project_info. kicad_get_version reports KiCad version and connection status, while kicad_get_server_info provides server and capability diagnostics.

Read-only analysis can run directly against KiCad project files. PCB visual QA checks board geometry for off-board footprints, silkscreen reference collisions, and overlapping footprint bodies. Schematic visual QA examines sheet geometry for label overlaps, off-sheet objects, dense label fanout, and title-block gaps. Bounding-box and connectivity tools help an agent understand schematic layout before further work.

Validation tools cover DRC, ERC, combined design readiness, project-wide quality gates, footprint-to-symbol parity, and manufacturer-aware DFM review. The project_design_workflow and project_get_next_action tools provide state-machine guidance for progressing through a design run.

Setup and configuration

The CLI can be launched with uvx kicad-mcp-pro init, or started through the dashboard with uvx kicad-mcp-pro dashboard --open. For MCP over Streamable HTTP, run uvx kicad-mcp-pro --transport streamable-http --port 3334; the endpoint is /mcp by default. The dashboard can also be opened explicitly with uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open.

The server supports both stdio and Streamable HTTP transports. The HTTP mount path can be changed with KICAD_MCP_MOUNT_PATH. Its default profile exposes a bounded set of read-only review tools; build, release, expert, and full profiles provide broader operation modes, with write or manufacturing modes intended for controlled use.

Tools and capabilities

  • Discover tool categories and maturity-filtered tool names.
  • Set and inspect the active KiCad project.
  • Summarize PCB geometry, stackup, and design rules.
  • List schematic symbols, estimate occupied areas, and inspect connectivity.
  • Run PCB and schematic visual/readability QA without rendering.
  • Check symbol, footprint, pin, courtyard, fabrication, silkscreen, and model contracts.
  • Generate BOM summaries with unit and extended pricing.
  • Run DRC, ERC, combined readiness checks, project quality gates, and DFM reviews.
  • Compare schematic references with PCB footprints.

Limitations and notes

PCB visual QA is an early geometry review and does not replace KiCad’s authoritative DRC sign-off. Signal-integrity, power-integrity, EMC, and thermal analysis use first-order closed-form estimates rather than field solvers, FEA, or formal approval processes.

Schematic bounding boxes are heuristic estimates because exact extents are not exposed through the file API. Component-contract checks use local project files and treat datasheet evidence and 3D-model presence as advisory. Release workflows can flag human gates, so an agent should not treat every automated result as manufacturing approval.

Telemetry and error reporting are disabled by default. Live component sourcing uses the JLCPCB public catalog by default; Nexar, DigiKey, and Mouser access requires configured API credentials.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about KiCad MCP Pro Server

KiCad MCP Pro Server is an MCP server that connects AI agents to KiCad EDA projects through stdio or Streamable HTTP. Its main tools manage project paths, inspect schematics and PCBs, run visual QA, execute DRC/ERC and DFM checks, validate component contracts, generate BOM pricing, and guide staged design workflows.

Run it with `uvx kicad-mcp-pro init`, or start the dashboard with `uvx kicad-mcp-pro dashboard --open`. The project also provides desktop releases and supports launching the MCP service over stdio or Streamable HTTP.

Start the service with `uvx kicad-mcp-pro --transport streamable-http --port 3334`. Streamable HTTP is served at `/mcp` by default, and the mount path can be changed with `KICAD_MCP_MOUNT_PATH`.

Yes. Its PCB and schematic visual QA tools analyze KiCad file geometry without rendering. They report findings such as off-board footprints, silkscreen collisions, overlapping objects, off-sheet labels, and dense label areas.

Yes. Cursor can use it as an MCP server through its standard stdio or Streamable HTTP support. The server also works with other MCP-capable clients when configured for one of its supported transports.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKiCad MCP Pro Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/kicad-mcp-pro-server?style=directory)](https://allmcps.com/mcp/kicad-mcp-pro-server)
HTML Embed
<a href="https://allmcps.com/mcp/kicad-mcp-pro-server"><img src="https://allmcps.com/api/badge/kicad-mcp-pro-server?style=directory" alt="KiCad MCP Pro Server on AllMCPs" /></a>