# Perfboard Designer

> Perfboard Designer is a free MCP server for design and media. Lay out perfboard and stripboard circuits from a description and get an editor link. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** Web, CLI, API
- **Website:** https://perfboarddesigner.com/mcp-server/
- **Repository:** https://github.com/maurerkrisztian/perfboard-designer/tree/HEAD/mcp
- **MCP Registry name:** com.perfboarddesigner/mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-15

## About

The assistant looks up parts in a catalogue of 175 components, places them on a perfboard or stripboard of the size you pick, routes wires, checks the connections and returns a share link that opens the finished board in the Perfboard Designer editor, where you can inspect and adjust it. You can also paste an existing board link and ask for changes, such as adding a power LED with a resistor and checking nothing is left unconnected.

Projects are held in memory under a projectId, so an agent sends a project once and then applies small edits as a list of operations that succeed or fail together. The project file stays the source of truth and can be read back at any time. Parts outside the catalogue can be defined with custom pins or a dual-row chip.

It runs as a hosted Streamable HTTP endpoint with no account or key, or locally over stdio with Node.js 22 or newer. Environment variables let you point links at your own copy of the editor or turn off short links and board pictures.

## Features

- **Part lookup:** Search a 175-part catalogue by name, pin count or keyword.
- **Atomic project edits:** Apply a list of operations all or none.
- **Share links:** Opens the board in the Perfboard Designer editor.
- **Stripboard support:** Place circuits and cut strips under chips.
- **Custom parts:** Define parts with their own pins or a dual-row chip.
- **Hosted or local:** Use the remote endpoint or run it over stdio.

## Good for

- Lay out a 555 LED blinker on a small perfboard
- Fit a circuit onto a 30 by 20 stripboard
- Add a component to an existing board and check wiring
- Generate a starting layout to refine by hand in the editor

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.perfboarddesigner.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.perfboarddesigner.com/mcp
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.perfboarddesigner.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.perfboarddesigner.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.perfboarddesigner.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.perfboarddesigner.com/mcp"
    }
  }
}
```

## Tools

- `list_parts`: Lists placeable parts, optionally filtered by keyword
- `get_part`: Full details for named parts, including pins and polarity
- `new_project`: Starts an in-memory project and returns a projectId
- `edit_project`: Changes a project with a list of operations, all or none
- `get_project`: Returns the project file
- `make_share_link`: Creates a link that opens the board in the editor
- `render_board`: Draws the board as a picture

## FAQ

### Do I need an account?

No. The hosted server at mcp.perfboarddesigner.com/mcp needs no account or API key.

### Can I run it locally?

Yes, with npx -y perfboard-designer-mcp over stdio; Node.js 22 or newer is required.

### How many parts can it place?

The README says the catalogue holds 175 parts, and agents can add custom parts.

### Which clients are covered?

The website gives setup steps for Claude, ChatGPT, Cursor, VS Code, Windsurf, Gemini CLI and Codex CLI.

### Is Perfboard Designer free?

Yes. Perfboard Designer is free to use.

### How do I add Perfboard Designer to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.perfboarddesigner.com/mcp

### What are the best alternatives to Perfboard Designer?

The closest alternatives to Perfboard Designer are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/perfboard-designer
