VoltPlan Wiring Diagrams

io.github.YUZU-HubPublished by GitHub account YUZU-Hubv0.5.0Updated Nov 20, 2026

Generate 12V/24V/48V wiring diagrams and size wires, fuses, batteries, solar, and inverters.

The publisher's own server: Diagram

VerifiedStreamable HTTPWeb executableDeveloper ToolsData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Gives an assistant 12V/24V/48V electrical-system expertise: sizing wires, fuses, batteries, solar and inverters, and generating wiring diagrams for boats…

What you can do
  • Calculate power budgets, battery bank size and series/parallel configuration, solar panel wattage, charging time, inverter size, and wire gauge with fuse recommendation
  • Generate a complete wiring diagram as an image or SVG, with a link that opens the system in the VoltPlan editor
  • List component types and example configurations to prepare a diagram request
  • Find real products in VoltPlan's curated catalogue matching a spec, closest rating first
  • Build a bill of materials for the same system, with cables, fuses, terminals and tools
When to use it
Useful when planning or refitting a camper, van, boat or off-grid power system and you want the sizing math and a schematic produced from a plain-language prompt instead of doing it by hand.
Requirements
Either the hosted remote endpoint or a local process via npx (Node.js). Self-hosting uses VOLTPLAN_API_URL (default and optionally VOLTPLAN_PB_URL, VOLTPLAN_TELEMETRY and PORT. No account or API key is declared. Diagram rendering, catalogue matching and BOM calls go to VoltPlan's API, so network access is needed.
Before you install
Diagram rendering, component matching and BOM building send requests to VoltPlan's servers. Buy links route through VoltPlan and earn it a commission. Anonymous usage events (tool name, coarse inputs, client name) are sent to VoltPlan analytics unless VOLTPLAN_TELEMETRY is off. Catalogue results may deviate from the requested spec, so specs should be checked before buying.

Installation

In SourceWeft

  1. Open VoltPlan Wiring Diagrams in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.YUZU-Hub%2Fwiring-diagram-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "voltplan-wiring-diagrams": {
      "type": "http",
      "url": "https://mcp.voltplan.app/mcp"
    }
  }
}

README

VoltPlan Wiring Diagrams · MCP Server

I refit my boat with Claude as the electrician. Here's the MCP that made it possible.

An MCP server that gives Claude (or any MCP-compatible AI) domain expertise in 12V / 24V / 48V electrical systems — sizing the bank, picking the wire gauge, recommending the fuse, and generating a complete wiring diagram. For boats, campers, vans, and off-grid builds.

[License: MIT] [npm] [MCP] [Hosted]

json
{ "mcpServers": { "wiring-diagram": { "url": "https://mcp.voltplan.app/mcp" } } }

Drop that into your claude_desktop_config.json, restart Claude, ask: "Plan a 400 Ah lithium house bank for a 30 ft sailboat with 2 days of autonomy." Done.


Why this exists

Built while refitting Largo, a 1996 Maxum, in Roermond. The math kept getting in the way of the work — sizing the bank, then the gauge, then the fuse, then redoing all of it after one load changed. So I gave Claude the math. Now it sizes the bank, picks the gauge, and generates the diagram. I'd rather just do the cabling.

The calculations are the same ones any cruiser or vanlifer ends up doing on graph paper at 11pm. This server makes them a one-sentence prompt.

What it does

Eleven tools, all callable by name from any MCP client:

ToolWhat it does
calculate_power_budgetDaily energy draw from a list of loads (Wh, Ah, peak power)
calculate_battery_bankBank size for given consumption + autonomy + DoD
calculate_battery_configSeries/parallel arrangement to hit a target voltage and capacity
calculate_solar_sizePanel wattage to recharge daily, accounting for sun hours and losses
calculate_wire_gaugeAWG / mm² for current and run length, with fuse recommendation
calculate_inverter_sizeInverter wattage for AC loads, with surge headroom and DC current draw
calculate_charging_timeTime from X% to Y% SoC, with bulk and absorption phases
generate_wiring_diagramComplete schematic as an image (PNG, default) or icon-free SVG, auto-fused and protected, plus a link that opens the system in the VoltPlan editor
list_component_typesComponent reference and example configs for diagram building
find_componentsReal products from VoltPlan's curated catalogue that match a spec (category, system voltage, watts, Ah/Wh, pure sine), closest rating first, with product page and buy links
build_bomShopping list for the same system the diagram takes: components with matching catalogue products, cable per gauge with lengths, fuses, fuse holders, terminals and tools, sized like the diagram

Demo

Three real prompts, three real outputs.

1. Size a sailboat house bank

"Plan a 400 Ah lithium house bank for a 30 ft sailboat. Loads: 12V fridge 24/7 (60W), LED nav and cabin lights (25W, 4h/day), USB chargers (30W, 2h/day), occasional inverter for a laptop (90W, 3h/day). 2 days of autonomy without solar, LiFePO4 with 80% DoD."

Claude calls calculate_power_budget then calculate_battery_bank:

Total daily energy: 1,870 Wh/day  (155.8 Ah/day at 12V)Peak load:           205 W        (17.1 A)
Required capacity (2 days × 80% DoD):  4,675 Wh / 389.6 AhRecommended bank: 4 × 100 Ah / 12.8 V LiFePO4 in parallel (4P)Total / usable:   400 Ah / 5,120 Wh   →   4,096 Wh usable                  ≈ 2.2 days of autonomy

2. Pick a gauge for an inverter run

"What gauge wire for a 50A inverter run, 3 meters one-way, 12V, marine environment, max 3% drop?"

Claude calls calculate_wire_gauge:

Recommended cable:    16 mm² (6 AWG)   — rated 65 AVoltage drop:         0.34 V (2.80%)   ✓ within targetTotal resistance:     6.7 mΩPower lost as heat:   16.8 WFuse:                 70 A ANL bolt-down, within 18 cm of battery+
Status: OK — wire size meets all requirements.

(Ampacity alone would allow 10 mm² / 8 AWG, but voltage drop drives the choice up at this length.)

3. Generate a full schematic

"Generate a wiring diagram for: 2 × 100W solar → MPPT → 200 Ah LiFePO4 → BMV-712 monitor → main 12V bus → fridge, lights, USB."

Claude calls generate_wiring_diagram and shows the schematic as an image: batteries with terminals, MPPT charger, auto-generated shunt, main switch, low-voltage cutoff, and fused load lines in red/black with computed gauges. Below it comes a link that opens the system in the VoltPlan editor with the battery, the solar panel and the first load already placed, to finish, save and turn into a shopping list.

Loads need only power or current, batteries only capacityAh or energyWh; the server derives the rest, and voltages default to the first battery's.

See examples/ for five fully-worked scenarios — sailboat refit, Sprinter van, off-grid cabin, day sailer, live-aboard — each with the prompt, the expected tool calls, and the resulting numbers.

5-minute setup

Claude Desktop (hosted — easiest)

Edit claude_desktop_config.json (Settings → Developer → Edit Config):

json
{  "mcpServers": {    "wiring-diagram": {      "url": "https://mcp.voltplan.app/mcp"    }  }}

Restart Claude. The hammer icon in the chat input means tools are active.

Claude Desktop (local via npx)

json
{  "mcpServers": {    "wiring-diagram": {      "command": "npx",      "args": ["wiring-diagram-mcp"]    }  }}

Claude Code

bash
# hostedclaude mcp add wiring-diagram --transport http https://mcp.voltplan.app/mcp
# localclaude mcp add wiring-diagram -- npx wiring-diagram-mcp

Cursor

Edit ~/.cursor/mcp.json (or .cursor/mcp.json per-project):

json
{  "mcpServers": {    "wiring-diagram": {      "url": "https://mcp.voltplan.app/mcp"    }  }}

Cline (VS Code)

Open the Cline panel → MCP Servers → Edit MCP Settings, then:

json
{  "mcpServers": {    "wiring-diagram": {      "url": "https://mcp.voltplan.app/mcp"    }  }}

Self-hosted HTTP server

bash
npm installnpm run buildnpm run start:http   # listens on http://localhost:3001/mcp
Env varDefaultPurpose
VOLTPLAN_API_URLhttps://voltplan.appVoltPlan instance for diagram rendering, catalogue matches (find_components) and shopping lists (build_bom)
VOLTPLAN_PB_URLhttps://base.voltplan.appVoltPlan catalogue (public, read-only) for curated cable and fuse links
VOLTPLAN_TELEMETRYonoff disables the usage events described under Telemetry
PORT3001HTTP server port

Docker

bash
docker build -t wiring-diagram-mcp .docker run -p 3001:3001 wiring-diagram-mcp

Architecture

[Architecture]

Calculations run inside the MCP server and are deterministic. Diagram rendering hits the VoltPlan API and returns a PNG (or SVG) that the AI client shows in the chat, or an interactive viewer in hosts with MCP Apps (see below). find_components and build_bom call VoltPlan's public /api/components/match and /api/diagram/bom endpoints; the shopping list is sized by the same code that renders the diagram. calculate_wire_gauge additionally reads VoltPlan's public catalogue (cached for an hour) to link the recommended cable and fuse to a curated product; without it the links fall back to a store search.

Links and attribution

Buy links go through voltplan.app/api/go with source=mcp, which picks the reader's local Amazon store; VoltPlan earns a commission on purchases (Amazon Associate). Links to voltplan.app pages carry utm_source=mcp.

https://mcp.voltplan.app/mcp-clean serves the same tools without buy links and without pointers to other VoltPlan pages (tool descriptions included). Use it where tool output must not carry promotional content, e.g. Anthropic's connector directory. The diagram's editor link stays, because it opens the generated system for editing. find_components and build_bom return no links at all there: product names, specs, quantities and ratings only. The same holds for the interactive viewer: there it shows a parts list without buy buttons.

Interactive diagram in the chat (MCP Apps)

generate_wiring_diagram declares an MCP Apps view (_meta.ui.resourceUri → ui://wiring-diagram/diagram-viewer-v1.html, spec 2026-01-26). Hosts that support MCP Apps (Claude, ChatGPT, VS Code Copilot, Goose, …) show the diagram as a viewer in the chat instead of a static image:

  • zoom (buttons, Ctrl/⌘ + scroll, pinch, double-click), pan by dragging, fit, full screen where the host offers it;
  • Open in VoltPlan editor (through the host's ui/open-link);
  • Shopping list (Parts list on /mcp-clean): calls build_bom with the same system and shows it as a table below the diagram, with buy buttons on /mcp.

The view gets a light SVG (icons loaded from VoltPlan, the only domain in its CSP resourceDomains) and the shopping list through the tool results' _meta, which the model never sees; the model and hosts without MCP Apps keep getting the PNG and the text. Against a VoltPlan without the ?format=json render mode the viewer shows that PNG instead of the SVG.

The view lives in viewer/ and is bundled into dist/viewer.html by npm run build:viewer (part of npm run build, npm run dev and npm test). Try it locally with the basic-host example of ext-apps: SERVERS='["http://localhost:3001/mcp"]' npx tsx serve.ts.

Telemetry

The server sends anonymous usage events to VoltPlan's cookieless analytics (Umami): connection handshakes and tool calls, with the tool name, a few coarse inputs (system voltage, output format, product category) and the client's product name (e.g. claude-ai, from the MCP clientInfo or the HTTP User-Agent). No prompts, no tool arguments beyond those, no IP-derived identifiers. Events record the endpoint as their page (/mcp or /mcp-clean). Set VOLTPLAN_TELEMETRY=off to disable it.

Examples

Worked scenarios in examples/:

Roadmap

  • AC-side calculations: shore power inlet, breaker panel sizing, isolation transformer
  • More battery chemistries: AGM/Gel sizing curves, lead-carbon
  • Multi-bank topologies: starter + house with combiner / DC-DC charger
  • Wire run optimization: shared trunks, terminal block placement

Related

About

Built by Stefan Lange-Hegermann (yuzuhub.com). Powered by VoltPlan.

Issues, ideas, and pull requests welcome on GitHub.

License

MIT — see LICENSE.

Source: README.md at commit 0d303bf

Tools

11

generate_wiring_diagram

Generate Wiring Diagram

Generate an electrical wiring diagram for campers, boats, or off-grid setups. Returns the schematic as an image (batteries, chargers, protection components, loads) and a link that opens it in the VoltPlan editor to refine, save and turn into a shopping list. Protection components (shunt, main switch, low-voltage cutoff) are auto-generated when both batteries and loads are provided. Show the user the editor link.

ParametersloadsformatchargersbatteriessystemNamerequired

find_components

Find Components

Find real products in VoltPlan's curated component catalogue that match a spec, e.g. a 200 Ah 12 V LiFePO4 battery or a 2000 W pure-sine inverter. Results come closest rating first. The catalogue is small and curated, so results may deviate from the requested spec; check the listed specs. Use it after the calculators (calculate_battery_bank, calculate_solar_size, calculate_inverter_size) have sized the part. Returns product pages and buy links for each product; show them to the user.

ParameterslimitquerycategoryrequiredpureSinecapacityAhcapacityWhpowerWattssystemVoltage

build_bom

Build Shopping List

Build the shopping list (bill of materials) for the same system generate_wiring_diagram takes: components with matching products from VoltPlan's catalogue, cable per gauge with lengths, fuses, fuse holders, terminals and tools, sized with the same rules as the diagram. Returns buy links for every line and a link that opens the system in the VoltPlan editor; show them to the user.

ParametersloadschargersbatteriessystemNamerequired

list_component_types

List Component Types

List all available component types and example configurations for building wiring diagrams. Use this to understand what parameters are needed before calling generate_wiring_diagram.

Takes no parameters.

calculate_wire_gauge

Cable Cross-Section & Resistance Calculator

Calculate the recommended wire gauge / cable cross-section for a DC circuit. Considers both ampacity (current carrying capacity) and voltage drop to recommend the optimal cable size. Also returns total resistance, power loss, and a fuse recommendation. Supports copper conductors from 0.75 mm² (18 AWG) to 240 mm² (300 MCM).

ParameterspowercurrentvoltagerequiredisRoundTripcableLengthMrequiredtemperatureCelsiusmaxVoltageDropPercent

calculate_power_budget

Power Budget / Energy Audit

Calculate total daily energy consumption from a list of electrical loads. Each load specifies its power draw, how many hours per day it runs, and quantity. Returns total daily energy (Wh and Ah), peak power draw, and average power. This is typically the first step in sizing a battery bank and solar system.

ParametersloadsrequiredsystemVoltagerequired

calculate_battery_bank

Battery Bank Sizing Calculator

Calculate the recommended battery bank size based on daily energy consumption. Accounts for days of autonomy (how many days without charging) and depth of discharge. Returns required capacity, number of batteries, and wiring configuration.

ParameterssystemVoltagerequireddaysOfAutonomysingleBatteryAhrequireddailyConsumptionWhrequiredsingleBatteryVoltagerequireddepthOfDischargePercent

calculate_solar_size

Solar Panel Sizing Calculator

Calculate the required solar panel wattage to cover daily energy consumption. Accounts for peak sun hours at the location and system efficiency losses (MPPT conversion, wiring, temperature derating). Returns required wattage and common panel configurations.

ParameterspeakSunHoursrequiredsystemEfficiencydailyConsumptionWhrequired

calculate_charging_time

Charging Time Calculator

Estimate how long it takes to charge a battery bank from a given state of charge to a target level. Accounts for the bulk charging phase (constant current, up to ~80% SoC) and the slower absorption phase (tapering current, 80-100% SoC). Works for any charging source: solar, shore power, alternator.

ParametersbatteryVoltagerequiredchargePowerWattsrequiredbatteryCapacityAhrequiredchargeCurrentAmpstargetStateOfChargePercentcurrentStateOfChargePercentrequired

calculate_inverter_size

Inverter Sizing Calculator

Calculate the recommended inverter size for running AC loads from a DC battery system. Accounts for continuous power, startup surge power (motors typically surge 2-3x), and includes a 25% headroom for the continuous rating. Returns the recommended inverter wattage and the DC current draw at system voltage.

ParametersloadsrequiredsystemVoltagerequired

calculate_battery_config

Battery Configuration Calculator

Determine how to arrange batteries in series and/or parallel to achieve a target voltage and capacity. Returns the number of batteries needed, the wiring configuration (e.g. 2S3P), and step-by-step wiring instructions.

ParameterstargetVoltagerequiredsingleBatteryAhrequiredtargetCapacityAhrequiredsingleBatteryVoltagerequired

Version history

3
  1. v0.5.0LatestNov 19, 2026
  2. v0.3.0Oct 29, 2026
  3. v0.2.2Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Diagram integrations