The local server
For a project that lives on your disk, next to KiCad. The local server answers your assistant's questions about it (parts, nets, check results, routing, a picture) and writes nothing. It needs no account and your files stay where they are.
| Local server (this page) | Hosted server | |
|---|---|---|
| Works on | A KiCad project folder on your disk | Projects stored in your Crossprobe account |
| Can | Read: answer questions, review, draw a picture | Read, build a board from requirements, change a design |
| Writes | Nothing | New revisions in your account |
| Needs | Node.js 20 or later | An account and an access token |
| Cost | Free | One board build a day free; more with a plan |
To have a board built, or to have your assistant change a design, use the hosted server.
Install
The server is the npm package @crossprobe/mcp (Apache-2.0). There is nothing to install by hand: your MCP client starts it with npx, which downloads it the first time and keeps it cached. You need Node.js 20 or later. To check that it runs:
npx -y @crossprobe/mcp --version
The server is read-only from version 0.2.0.
Connect your assistant
The server takes one argument: the KiCad project, as its folder or its .kicad_pro file. Without one, it uses the folder it was started in. You can also leave it out and tell the assistant which project to open.
Claude Code
In a terminal, in your project's folder:
claude mcp add crossprobe-local -- npx -y @crossprobe/mcp .
Start claude in that folder, and /mcp shows the server and its tools.
Claude Desktop
Open Settings › Developer › Edit Config and add the server to claude_desktop_config.json. Give the project as a full path. Then restart Claude Desktop.
{
"mcpServers": {
"crossprobe-local": {
"command": "npx",
"args": ["-y", "@crossprobe/mcp", "/Users/you/kicad/my-board"]
}
}
}
Cursor and other MCP clients
The same command works everywhere. In Cursor, put the JSON above in .cursor/mcp.json in your workspace (or in ~/.cursor/mcp.json for all workspaces). Other clients take a command and arguments in their MCP settings.
What to ask
Ask about the design in your own words. The assistant looks things up with the tools before it answers. For example:
- "Which ICs have no decoupling capacitor on their supply pins?"
- "What's connected to the I²C bus, and does it have pull-ups?"
- "Triage the DRC results: which ones matter?"
- "Does every connector pin have a net, or a no-connect flag?"
For a full review, use the server's design_review prompt (in Claude Code: /mcp__crossprobe-local__design_review). The assistant says what to change and where; you make the changes in KiCad or in the Crossprobe editor.
The server reads the project again whenever a file changed, so after you save in KiCad, the next answer is about the design as it is now.
Its tools
open_project, get_overview, list_components, get_component, list_nets, get_net, get_checks, check_requirements, check_compatibility, get_board_routing, render_design, and report_finding with list_findings to collect review findings during a session. Tools and edits says what each one returns.
What leaves your computer
The server itself sends nothing anywhere: it reads your project from disk and answers your MCP client. The client's model sees what the tools return when it asks, for example a part's pins, a net, or a list of check results. It never gets your files as a whole. Where that model runs is up to your client and its settings.
If something doesn't work
- The server doesn't start, or "npx: command not found". MCP clients don't always see your shell's
PATH. Use the full path to npx as the command:which npx(macOS and Linux) orwhere npx(Windows) prints it. - "No KiCad project (.kicad_pro) in …". The folder given has no project within three levels. Give the project's folder or its
.kicad_pro, or ask the assistant to open it. - Answers don't match what I see in KiCad. The server reads saved files. Save in KiCad, then ask again.
- The assistant says the server only reads. It does. Store the project in your account and use the hosted server to build or change a design.