Skip to content
MCP server

copperflow

Open-source PCB design program that an AI agent can drive through MCP

Runs locally
Install

copperflow is an open-source MCP server for electronics. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, API, Windows
Runs
Locally
Version
0.5.4
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add copperflow -- npx -y copperflow

Add to claude_desktop_config.json

{
  "mcpServers": {
    "copperflow": {
      "command": "npx",
      "args": [
        "-y",
        "copperflow"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "copperflow": {
      "command": "npx",
      "args": [
        "-y",
        "copperflow"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "copperflow": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "copperflow"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "copperflow": {
      "command": "npx",
      "args": [
        "-y",
        "copperflow"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "copperflow": {
      "command": "npx",
      "args": [
        "-y",
        "copperflow"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

About copperflow

The README says copperflow is a PCB design program that an agent and a person work on together. The agent places, routes, checks and exports a board through MCP, with or without an editor window open, and you edit the same circuit files in the visual editor. Each change the agent makes is recorded as one undo step, and you can lock parts so the agent cannot move them.

A circuit is written as TSX files with elements such as board, resistor and trace. Schematic and PCB views, electrical and placement rule checks against a JLCPCB two-layer profile, autorouting, copper pours and mounting holes are all handled by copperflow's own engine. Fabrication output includes Gerbers, drill files, a bill of materials and a STEP model.

It runs locally with no account, and the site says nothing is uploaded. The project is at version 0.5 and the site describes it as early, so expect rough edges. It is aimed at hobbyists and engineers who want an agent to draft small boards and then refine them by hand.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

check_circuit
Runs copperflow's own electrical and placement rule checks.
autoplace
Places unplaced or unlocked parts by their connections.
autoroute
Routes unrouted connections and reports any it cannot route.
export_fabrication
Writes Gerber, drill, BOM and STEP fabrication files; refused when the circuit has errors.
export_html
Writes the design as one offline web page.
render
Produces a PNG of the board or a schematic page.

What it does

Headless MCP design tools
The agent can place, route, check and export a board through an MCP server without a window open.
Shared editor and files
A visual schematic and PCB editor works on the same TSX circuit files the agent edits.
Undoable agent changes
Every agent change is stored as one history entry that can be undone.
Locks and notes for the agent
Placed parts can be locked against agent edits, and on-canvas notes are read as instructions.
Rule checks and autorouting
Electrical and placement checks, plus an autorouter, run against a fabrication profile.
Fabrication and 3D export
Produces Gerbers, drills, BOM, STEP and a GLB 3D model for ordering a board.

Good for

  • Drafting a small two-layer board, such as a CAN bus node, from a plain-language description
  • Generating Gerber, drill and BOM files for a JLCPCB order
  • Letting an agent do placement and routing while keeping hand control over chosen parts
  • Reviewing a board's schematic and 3D view in a browser before ordering

Pricing

Open source

Free and open source under Apache 2.0; no paid plan mentioned.

Prices change. Check copperflow.kurpeeren.com before you buy.

copperflow FAQ

Do I need the desktop app to use copperflow?

No. The MCP server runs headless from npm with Node.js 22 or newer, and the desktop app is an alternative for Windows, macOS and Linux.

Is copperflow open source?

The website says it is open source under the Apache 2.0 licence.

Does copperflow upload my designs anywhere?

The website says there is no account and nothing is uploaded; the project is a folder on your own disk.

Are the apps code-signed?

Not yet. The website says the apps are not signed by a developer certificate, and gives steps for running them anyway.

Is copperflow free?

Yes. copperflow is open source, so you can use and self-host it for free.

How do I add copperflow to Claude Code?

Run this command in your terminal: claude mcp add copperflow -- npx -y copperflow

What are the best alternatives to copperflow?

The closest alternatives to copperflow are Easyeda Pro MCP, Openroad MCP, kicad-splitplane and Source Parts.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers