KiCad Context MCP
Provides a comprehension layer for KiCad EDA projects, allowing AI agents to understand board overview, components, nets, power tree, and check results without editing the design.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@KiCad Context MCP show me the board overview"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
KiCad Context MCP
A read-only MCP server for understanding KiCad projects. Point it at a board and an agent can answer "what is this" and "what's wrong with it" without loading the whole design into context.
Overview
The server reads a KiCad project and exposes it through seven tools. Every tool
returns a compact summary and lets the agent drill down by ID; lists are capped
and paginated, so context stays small even on large boards. Connectivity and
ERC/DRC come from kicad-cli; component metadata comes from the exported
netlist. Built for KiCad 10.
It only reads. There are no tools that edit, place, route, or export.
Related MCP server: KiCad MCP Server
How to install
Requires only KiCad 10+ (for kicad-cli). The plugin ships a self-contained
binary — no Python, uv, or network needed.
Installed as a plugin from this repo's marketplace.
Claude Code:
/plugin marketplace add yigitabi5444/YSM-Kicad-MCP
/plugin install kicad-context@ysmClaude Desktop / web:
Open the Customize menu in the left sidebar → Plugins tab.
Under Personal plugins, click + → Add marketplace → Add from a repository, and enter
yigitabi5444/YSM-Kicad-MCP.Click Browse plugins, find kicad-context, and click Install.
Pass a project path to any tool to use it.
The shipped binary is macOS (Apple Silicon). On another platform, run
bash build.sh to rebuild bin/kicad-context-mcp for your OS.
Exposed tools
Tool | Returns |
| Title, sheets, key ICs, power rails, connectors, part counts. Start here. |
| Paginated components, nets, or sheets matching a query. |
| One part: value, footprint, datasheet, fields, pin → net map. |
| Pins on a net, grouped by component, paginated. |
| Pins connected to a given pin, bounded by depth (max 3). |
| Regulators and the rails they feed. |
| ERC or DRC results: counts by severity, then a capped detail list. |
Changelog
0.1.0
Initial release. Seven read-only tools, KiCad 10.
License
MIT, see LICENSE. KiCad itself is GPLv3 and is a separate install the server calls out to; it is not bundled here.
Available Tools
7 toolsboard_overviewA
Orientation call. What is this board: title, sheets/function blocks, key ICs, power rails, connectors, and part counts. Make this first.
Inputs: project.
checksB
Run ERC (schematic) or DRC (board) and return counts by severity, then a capped detail list. Filter by severity to expand a class.
Inputs: page, type, project, severity.
componentB
Describe one component: value, footprint, datasheet, fields, and its pin -> net map. Use net() on a pin's net to expand connectivity.
Inputs: ref (required), project.
findA
Search the board. kind = component | net | sheet. Returns a paginated list of matching IDs + one-line labels to feed into other tools.
Inputs: query (required), kind, page, project.
netB
List the pins on a net, grouped by component. Paginates large nets.
Inputs: name (required), page, project.
power_treeA
Regulators and the rails they feed. Heuristic (library/value match). Pass a rail name to filter. Use net() on a rail for its full fanout.
Inputs: rail, project.
traceB
Walk connectivity from a pin outward, bounded by depth (max 3). One hop = crossing a net or passing through a component. Large nets are reported but not fully expanded, to stay bounded.
Inputs: pin (required), ref (required), depth, project.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly defined, non-overlapping purpose: board_overview for high-level summary, checks for validation, component for detailed component info, find for searching, net for net pin lists, power_tree for power distribution, and trace for connectivity walking. No two tools appear to perform the same function.
Tool names are mostly lowercase with underscores for compound names, but they mix verb forms (find, checks, trace) with noun forms (component, net, power_tree). This inconsistency makes it slightly less predictable, though still readable.
With 7 tools, the server covers essential aspects of KiCad board analysis—overview, search, component details, nets, power, connectivity, and checks—without being overwhelming. The count feels well-scoped for the domain.
The tool set provides comprehensive coverage for understanding a KiCad board: starting from overview, searching for elements, drilling into components and nets, examining power distribution, and tracing connectivity. Minor gaps like direct listing of all nets or sheets are addressed via the find tool.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Read-only MCP server exposing a user ORANO library to their own AI agent.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
MCP server for generating rough-draft project plans from natural-language prompts.
Related MCP Servers
- AlicenseBqualityBmaintenanceAn MCP server that enables AI assistants to analyze schematics, inspect PCBs, trace connections, validate designs, and generate embedded code for KiCad projects.39188MIT
- FlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that exposes KiCad PCB design automation tools to AI assistants and other MCP clients.-
- AlicenseNot gradedqualityDmaintenanceAn MCP server that gives AI agents end-to-end control of KiCad 9+ for rule checks, manufacturing exports, production-readiness certification, and live PCB editor control.MIT
- AlicenseNot gradedqualityCmaintenanceAn MCP server for controlling KiCad EDA software, enabling schematics, PCB design, manufacturing outputs, design checks, and library management through any MCP-compatible AI assistant.MIT