kicad-mcp-pro
by oaslananka
MCP server for KiCad, connecting AI agents to schematic and PCB workflows, ERC/DRC validation, DFM checks, BOM analysis, and manufacturing preparation—with controlled edits and human-gated release workflows.
115stars
19forks
Python
Added 4/30/2026
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
AI Agentsai-agentbomclaudedfmdrcedaeda-automationelectronicsercgerber-exportkicadkicad-pluginllmmanufacturingmcp-servermodel-context-protocolpcb-designpythonschematicsimulation
Installation
# Add to your Claude Code skills
git clone https://github.com/oaslananka/kicad-mcp-proGetting Started
Guides for using ai agents skills like kicad-mcp-pro.
- Caveman: Cut Claude Token Use by 65%How agent-side prompt compression works, when to use it, and when not to.
- What is an AI Skills Marketplace?Definitions, how marketplaces work, and how to choose between them in 2026.
- Getting Started with AI SkillsFirst-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
Security ReportWarning
Last scanned: 5/30/2026
{
"issues": [
{
"type": "clone-failed",
"message": "Could not clone repository",
"severity": "medium"
}
],
"status": "WARNING",
"scannedAt": "2026-05-30T16:30:47.666Z",
"npmAuditRan": false,
"pipAuditRan": false
}Compare with similar skills
See how kicad-mcp-pro compares with popular alternatives.
KiCad MCP Pro is a Model Context Protocol server for KiCad EDA workflows. It exposes tools, resources, and prompts for schematic, PCB, validation, DFM, and manufacturing export automation.
The server now starts with the bounded default profile: 24 read-only review tools instead of the complete expert catalog. Use build with write mode for controlled edits, release with manufacturing mode for human-gated handoff, or expert/full only for advanced trusted clients. Current catalog counts and context-size estimates come from docs/evidence/progressive-disclosure-profile-snapshot.json; see docs/agents/progressive-disclosure.md.
Telemetry and error reporting are disabled by default. Opt-in OpenTelemetry
configuration is documented in
docs/configuration.md, and privacy rules
are documented in docs/privacy.md.
Scope and honesty
KiCad MCP Pro is a professional first-pass design and review assistant, not an
automated sign-off authority. ERC/DRC and the export pipeline drive KiCad's own
engines. The signal-integrity, power-integrity, EMC, and thermal tools are
first-order, closed-form estimates (typically ~5–10% accuracy) — fast first-pass
review, not a substitute for a 2D/3D field solver, EM/FEA simulation, or formal
sign-off. Live component sourcing uses the JLCPCB public catalog by default; Nexar,
DigiKey, and Mouser are available only when their API credentials are configured. What
fraction of KiCad's programmatic surface the server drives is tracked openly in the
capability-parity matrix. Raw tool count and
capability coverage are inventory metrics, not the headline product-quality measure. End-to-end
task outcome, mutation recovery, corruption, required DRC execution, and manufacturing
reproducibility are the outcome KPIs. The committed
native-live example evidence
intentionally reports insufficient_evidence; representative-corpus target attainment remains
separate until the qualification work in #730 is complete.
Project identity
| Field | Value |
|---|---|
| Canonical repository | oaslananka/kicad-mcp-pro |
| PyPI package | kicad-mcp-pro |
| npm wrapper | kicad-mcp-pro |
| MCP Registry name | io.github.oaslananka/kicad-mcp-pro |
| Version | 3.35.2 |
| OSS maturity report | docs/repo-maturity-report.md |
| OpenSSF evidence | docs/openssf-evidence.md |
Quick Start
Desktop App
Download the latest installer from the
GitHub releases page.
The Tauri desktop app starts the Python dashboard server automatically and opens
the GUI at http://127.0.0.1:3334/ui. Desktop releases launch the matching exact
backend version and verify its desktop compatibility handshake before use; see
Installation.
CLI
uvx kicad-mcp-pro init
uvx kicad-mcp-pro tray
uvx kicad-mcp-pro dashboard --open
uvx kicad-mcp-pro --transport streamable-http --port 3334
Web Dashboard
uvx kicad-mcp-pro dashboard --host 127.0.0.1 --port 3334 --open
# http://127.0.0.1:3334/ui
Documentation
The documentation is organized from setup to operation:
- Installation
- Client configuration
- Runtime configuration
- Tool reference
- Workflows
- Release process
- Security and privacy
- KiCad capability parity — how much of KiCad's programmatic surface this server drives
- Error code catalog — stable error codes, retry classes, and recovery
- Work-order audit — current status of the hardening work order
The kicad_capability_parity() tool reports, per workflow domain, what fraction of
KiCad's programmatically reachable surface this server can drive (currently 76.6%),
keeping genuine gaps distinct from gui-only-no-api items that KiCad exposes no
headless API for.
The published documentation site is available at https://oaslananka.github.io/kicad-mcp-pro/.
Transports
KiCad MCP Pro supports stdio and Streamable HTTP. Streamable HTTP is served at
/mcp by default and can be moved with KICAD_MCP_MOUNT_PATH.
uvx kicad-mcp-pro --transport streamable-http --host 127.0.0.1 --port 3334
Streamable HTTP clients must send:
Accept: application/json, text/event-streamContent-Type: application/jsonMCP-Protocol-Version: 2025-11-25after initializationMCP-Session-Idon follow-up requests whenKICAD_MCP_STATEFUL_HTTP=1
By default Streamable HTTP is stateless, so ChatGPT-style connectors can
initialize and call tools/list without a session-header injection proxy. Set
KICAD_MCP_STATEFUL_HTTP=1 to require session IDs after initialize.
The deprecated HTTP+SSE fallback routes are disabled by default. Set
KICAD_MCP_LEGACY_SSE=1 only for older clients that cannot use Streamable HTTP.
Install
Published packages:
uvx kicad-mcp-pro --help
npx kicad-mcp-pro --help
Fresh source checkout on supported Linux hosts:
./scripts/bootstrap-dev.sh
source .dev-env.sh
pnpm run dev:doctor -- --ci
The repository bootstrap installs checksum-pinned Python, uv/uvx, Node.js,
pnpm, Task, and Rust tooling into ignored checkout-local roots and performs
frozen dependency installation. It does not modify global tool directories.
See the reproducible bootstrap guide
for --core-only, --check, cleanup, upgrade, and KiCad capability modes.
Package metadata
The canonical metadata inputs are pyproject.toml for package version and repository identity, and compatibility.yaml for KiCad and MCP support policy. server.json is the generated registry manifest. pnpm run metadata:sync renders the public surfaces, and pnpm run metadata:check verifies them in CI and release validation.
Usage
Use kicad-mcp-pro --help to inspect CLI commands and
docs/client-configuration.md to configure an
MCP client. The generated tool catalog is available in
docs/tools-reference.generated.md.
Agent plugin and skills
This repository owns the pro
Frequently Asked Questions
What is kicad-mcp-pro?
kicad-mcp-pro is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by oaslananka. MCP server for KiCad, connecting AI agents to schematic and PCB workflows, ERC/DRC validation, DFM checks, BOM analysis, and manufacturing preparation—with controlled edits and human-gated release workflows. It has 115 GitHub stars.
Is kicad-mcp-pro safe to use?
kicad-mcp-pro returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.
How do I install kicad-mcp-pro?
Clone the repository with "git clone https://github.com/oaslananka/kicad-mcp-pro" and add it to your Claude Code skills directory (see the Installation section above).
What programming language is kicad-mcp-pro written in?
kicad-mcp-pro is primarily written in Python. It is open-source under oaslananka on GitHub, so you can review or fork the full source.
Are there alternatives to kicad-mcp-pro?
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh kicad-mcp-pro against similar tools.
Comments (0)
to leave a comment.
No comments yet. Be the first to share your thoughts!
Related Skills
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
275,610
41,136
JavaScript
AI Agentsai-agentsanthropic
Skills for Real Engineers. Straight from my .agents directory.
250,518
21,171
Shell
AI Agents
An agentic skills framework & software development methodology that works.
234,966
20,863
Shell
AI Agentsaibrainstorming
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
206,785
61,028
TypeScript
MCP Serversaiapis