Log inSubmit server
H

Heypcb MCP

Design, inspect, verify, and export KiCad PCB projects through HeyPCB tools in compatible AI clients.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Heypcb MCP

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

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "heypcb-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@heypcb/mcp"
      ]
    }
  }
}

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

Automated check passed— started and listed 72 tools correctly (3d ago).

Overview

heypcb-mcp MCP server connects AI agents to HeyPCB for PCB design, KiCad project synchronization, board checks, and fabrication exports. Agents can either ask HeyPCB to build a board or control parts, circuits, placement, routing, and verification through granular tools. The local Node.js package runs over stdio and adds folder-based KiCad workflows, while HeyPCB also provides a hosted Streamable HTTP endpoint. Reach for it when an agent needs to create or modify real KiCad boards, run DRC/ERC and fabrication checks, or save production files.

Use cases

  • Build a USB-C powered KiCad board from a natural-language specification
  • Add an LDO, connect it to an MCU, and route the resulting board
  • Upload a KiCad project and run full board verification
  • Save Gerbers, BOM, CPL, and STEP files into a project folder
  • Inspect placement, nets, open connections, and board history

Key features

  • High-level PCB generation and board inspection
  • Parts, circuit blocks, nets, placement, and routing tools
  • KiCad project folder synchronization
  • Local KiCad DRC/ERC and fabrication exports
  • Board history, conflict handling, and file backups
  • Gerber, BOM, CPL, and STEP output

Tools72

What Heypcb MCP lets your agent do. Expand a tool for its parameters.

Verified live~5.6k 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 3d ago

Recent health check succeeded.

What it can do

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

Can delete or modify data · 6Makes network requests · 4Read-only tools · 66
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age12 days
Maintainers1

Observed 2026-10-25 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 8d ago via OSV.dev · @heypcb/mcp (npm)

Adoption & maintenance

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

GitHub stars26Stargazers on the source repository.
npm downloads526Package downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed72Callable tools this server registers over MCP.

How Heypcb MCP works

What heypcb-mcp does

heypcb-mcp exposes HeyPCB’s PCB engineering capabilities to MCP-compatible agents. It supports two design styles: an agent can request a complete board through high-level operations such as build_board, get_board, check_board, and export, or it can construct the design step by step with parts, circuit blocks, connections, board rules, placement, copper features, and routing controls.

The package also works with KiCad projects stored on the local computer. It can bind a project folder to a HeyPCB project, upload a separate copy, synchronize edits, run local KiCad checks, and write fabrication outputs into a chosen directory.

How it works

The hosted service is available at https://api.heypcb.ai/mcp over Streamable HTTP and uses OAuth sign-in in a browser. The local package is started with npx -y @heypcb/mcp and communicates over stdio. It forwards HeyPCB tools to the remote service and adds file-oriented operations that need access to the computer.

When a local folder is opened, the first sync creates a HeyPCB project and records the association in .heypcb/workspace.json. Later calls upload local changes before running and bring changed design files back afterward. Previous files are backed up under .heypcb/backup/<revision>/. If both KiCad and HeyPCB changed a file, the incoming version is written as a .heypcb-new file until the agent chooses whether to keep the local or HeyPCB version. .heypcbignore can exclude files from uploads.

Setup and configuration

The local package requires Node.js 18 or newer. Install nothing separately for the main server; run it with npx. Authenticate either with npx @heypcb/mcp login, which stores credentials for the computer, or set a personal HEYPCB_API_KEY. The server can also report the signed-in account with status and remove the sign-in with logout.

HEYPCB_MCP_URL changes the remote MCP endpoint, and HEYPCB_API_BASE controls the API host used for sign-in and local operations. Both have defaults. The hosted endpoint can be added directly to clients that support Streamable HTTP; the local command can be configured as a stdio MCP server.

Local DRC, ERC, and export operations additionally require KiCad 8 or newer, with kicad-cli available on PATH or in KiCad’s standard installation directory.

Tools and capabilities

  • Build complete boards or inspect existing board state.
  • Search and retrieve parts, add parts and circuit blocks, connect nets, and read netlists.
  • Set outlines and design rules, move or lock parts, define placement rules, and add ground pours.
  • Inspect parts and nets, preview layers and highlighted connections, and check placement.
  • Manage copper with pours, keepouts, via stitching, and net rip-up operations.
  • Run board verification; findings identify the tool call associated with a fix.
  • Review board history, restore earlier states, and redo changes.
  • Open or upload KiCad projects, synchronize edits, and restore backed-up local files.
  • Save or locally generate Gerbers, drill files, BOMs, pick-and-place files, KiCad projects, and STEP output.

The local install_parts operation refuses before writing because the required parts-assets API is not available. HeyPCB parts are not yet installed into a project’s own libraries through the local workflow.

Read the full README View source on GitHub

Reviews

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

Frequently Asked Questions about Heypcb MCP

heypcb-mcp is an MCP server that connects AI agents to HeyPCB for PCB and KiCad design. Its main tools build and inspect boards, search and place parts, connect circuits, check DRC/ERC and fabrication readiness, manage layout, and export files such as Gerbers, BOMs, CPL, and STEP.

Run `npx -y @heypcb/mcp` when configuring a local stdio MCP server. The package requires Node.js 18 or newer. You can authenticate with `npx @heypcb/mcp login` or provide `HEYPCB_API_KEY`; alternatively, use the hosted endpoint at `https://api.heypcb.ai/mcp` without installing the package.

Yes, heypcb-mcp works with Cursor. Add the local `npx -y @heypcb/mcp` command to Cursor’s MCP configuration, or use the provided Cursor installation link and hosted Streamable HTTP endpoint.

Ask the agent to call `open_kicad_project` with the project folder. The first call uploads and binds the folder to a HeyPCB project, while later calls synchronize changes and keep backups. KiCad 8 or newer is additionally needed for local DRC, ERC, and export operations.

Related MCP servers

All in Architecture & Design All alternatives
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 PreviewHeypcb MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/heypcb-mcp?style=directory)](https://allmcps.com/mcp/heypcb-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/heypcb-mcp"><img src="https://allmcps.com/api/badge/heypcb-mcp?style=directory" alt="Heypcb MCP on AllMCPs" /></a>