# kicad-splitplane

> kicad-splitplane is an open-source MCP server for electronics. Splits a KiCad power layer into one continuous copper zone per supply net. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, Linux, macOS, Windows, CLI, API, VS Code, Self-hosted
- **Website:** https://people.ee.ethz.ch/~atuzlak/kicad-splitplane.html
- **Repository:** https://github.com/atuzlak/kicad-splitplane
- **MCP Registry name:** io.github.atuzlak/kicad-splitplane
- **Categories:** [electronics](https://ai-powered.com/categories/electronics)
- **Listing updated:** 2026-11-19

## About

Instead of drawing copper pour outlines by hand, this tool works out where each supply's zone should go, based on where the vias sit. It joins each net's vias with routed paths, then divides the rest of the layer around them so every net stays in one piece.

It runs in three ways: as a plugin inside the KiCad PCB editor with a preview before anything is written, from the command line with a PNG preview and JSON output, or through an MCP server so an AI assistant can run the split and explain its warnings. The original board file is never overwritten; results go to a new board.

The tool suits PCB designers working on 4-layer boards where an inner plane is shared by several supplies such as 5V, 3.3V and 1.8V. The README notes that the zones still need to be filled and checked with the Design Rules Checker in KiCad afterwards.

## Features

- **Per-net zone splitting:** Creates one zone per selected supply net on a chosen copper layer, keeping every via of that net inside its zone.
- **Connected zone regions:** Routes paths between each net's vias first, so no zone breaks into isolated islands.
- **Trapped via warnings:** Flags vias fenced in by other nets and suggests a position to move them to.
- **Smoothed 45° outlines:** Straightens zone borders into 0°, 45° and 90° segments where this does not cut pads.
- **KiCad plugin preview:** Shows a preview in the PCB editor and writes the zones as one undo step.
- **Command line and JSON output:** Runs from Python 3.9+ without KiCad installed and can print results as JSON for scripts.
- **MCP server for agents:** Exposes list_power_nets and split_plane tools to AI assistants over stdio.

## Good for

- Splitting a shared inner power plane between several supply rails on a 4-layer board
- Previewing a plane split before the power vias are placed, using SMD pads as stand-ins
- Checking a board for trapped vias and necks narrower than a set width
- Letting an AI assistant run a plane split on a KiCad board and explain the warnings

## Install

### Claude Code (Terminal)

```sh
claude mcp add kicad-splitplane -- uvx kicad-splitplane-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kicad-splitplane": {
      "command": "uvx",
      "args": [
        "kicad-splitplane-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kicad-splitplane": {
      "command": "uvx",
      "args": [
        "kicad-splitplane-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "kicad-splitplane": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "kicad-splitplane-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kicad-splitplane": {
      "command": "uvx",
      "args": [
        "kicad-splitplane-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kicad-splitplane": {
      "command": "uvx",
      "args": [
        "kicad-splitplane-mcp"
      ]
    }
  }
}
```

## Tools

- `list_power_nets`: Lists the supply-like nets and copper layers of a board, with via and pad counts.
- `split_plane`: Splits a chosen copper layer between the given nets and writes a new board file.

## FAQ

### Which KiCad version does the plugin need?

The plugin needs KiCad 9 or newer on Windows, macOS or Linux. The command line works with KiCad 7 to 10 files.

### Does the MCP server fill zones or run DRC?

No. The README says the agent cannot fill zones or run DRC; the user opens the new board in KiCad, presses B and runs the Design Rules Checker.

### Does kicad-splitplane change my original board file?

No. The split is written to a new board file next to the original, and the input is never overwritten.

### How do I install the plugin?

Search for kicad-splitplane in KiCad's Plugin and Content Manager under Plugins and press Install, then Apply Pending Changes. Offline, a zip from the GitHub releases can be installed with Install from File.

### Is kicad-splitplane free?

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

### How do I add kicad-splitplane to Claude Code?

Run this command in your terminal: claude mcp add kicad-splitplane -- uvx kicad-splitplane-mcp

### What are the best alternatives to kicad-splitplane?

The closest alternatives to kicad-splitplane are copperflow and Easyeda Pro MCP.

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

- [copperflow](https://ai-powered.com/mcp/copperflow): copperflow is an open-source MCP server for electronics.
- [Easyeda Pro MCP](https://ai-powered.com/mcp/easyeda-pro-mcp): Easyeda Pro MCP is an open-source MCP server for electronics.

---
Source: https://ai-powered.com/mcp/kicad-splitplane
