Skip to content
MCP server

Perfboard Designer

Lay out perfboard and stripboard circuits from a description and get an editor link

Install
Pricing
Free
Platforms
Web, CLI, API
Runs
Locally or Remotely
Version
0.1.0
Listing updated
2 days ago

About Perfboard Designer

Perfboard Designer is a free MCP server for design and media. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.perfboarddesigner.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.perfboarddesigner.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • PERFBOARD_EDITOR_URLWhere board links open, e.g. http://localhost:3000/app/ for your own copy of the editor. Defaults to https://perfboarddesigner.com/app/.
  • PERFBOARD_PROJECTS_URLWhere short links store projects, or off for no short links. Defaults to https://projects.perfboarddesigner.com.
  • PERFBOARD_IMAGE_URLWhere board picture links point, or off for none. Defaults to https://mcp.perfboarddesigner.com/render.svg.

Tools this server provides (7)

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

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

What it does

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

Pricing

Free

Free, no sign-up

Prices change. Check perfboarddesigner.com before you buy.

Perfboard Designer 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 to Perfboard Designer

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media