# copperflow

> copperflow is an open-source MCP server for electronics. Open-source PCB design program that an AI agent can drive through MCP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Windows, macOS, Linux, Web
- **Website:** https://copperflow.kurpeeren.com
- **Repository:** https://github.com/kurpeeren/copperflow
- **MCP Registry name:** io.github.kurpeeren/copperflow
- **Categories:** [electronics](https://ai-powered.com/categories/electronics)
- **Listing updated:** 2026-11-20

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add copperflow -- npx -y copperflow
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Easyeda Pro MCP](https://ai-powered.com/mcp/easyeda-pro-mcp): Easyeda Pro MCP is an open-source MCP server for electronics.
- [Openroad MCP](https://ai-powered.com/mcp/openroad-mcp-2): Openroad MCP is an open-source MCP server for electronics.
- [kicad-splitplane](https://ai-powered.com/mcp/kicad-splitplane): kicad-splitplane is an open-source MCP server for electronics.
- [Source Parts](https://ai-powered.com/mcp/source-parts): Source Parts is an MCP server for electronics.

---
Source: https://ai-powered.com/mcp/copperflow
