VoltPlan Wiring Diagrams

Working · 2.6 s

io.github.YUZU-Hub/wiring-diagram-mcpv0.2.2

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

Utilities

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://mcp.voltplan.app/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

calculate_battery_bank

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.

systemVoltagenumber, required

Target system voltage in volts (e.g. 12, 24, 48)

singleBatteryAhnumber, required

Capacity of a single battery in amp-hours (e.g. 100, 200)

dailyConsumptionWhnumber, required

Daily energy consumption in watt-hours (from calculate_power_budget)

singleBatteryVoltagenumber, required

Voltage of a single battery (e.g. 12.8 for LiFePO4, 12 for lead-acid)

daysOfAutonomynumber

Days the system should run without any charging (default: 2)

depthOfDischargePercentnumber

Usable percentage of battery capacity. LiFePO4: 80-90%, AGM: 50%, Gel: 50% (default: 80)

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (9)

calculate_battery_bank

Argument	Type	Description
systemVoltage*	number	Target system voltage in volts (e.g. 12, 24, 48)
daysOfAutonomy	number	Days the system should run without any charging (default: 2)
singleBatteryAh*	number	Capacity of a single battery in amp-hours (e.g. 100, 200)
dailyConsumptionWh*	number	Daily energy consumption in watt-hours (from calculate_power_budget)
singleBatteryVoltage*	number	Voltage of a single battery (e.g. 12.8 for LiFePO4, 12 for lead-acid)
depthOfDischargePercent	number	Usable percentage of battery capacity. LiFePO4: 80-90%, AGM: 50%, Gel: 50% (default: 80)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "dailyConsumptionWh",
    "systemVoltage",
    "singleBatteryAh",
    "singleBatteryVoltage"
  ],
  "properties": {
    "systemVoltage": {
      "type": "number",
      "description": "Target system voltage in volts (e.g. 12, 24, 48)"
    },
    "daysOfAutonomy": {
      "type": "number",
      "default": 2,
      "description": "Days the system should run without any charging (default: 2)"
    },
    "singleBatteryAh": {
      "type": "number",
      "description": "Capacity of a single battery in amp-hours (e.g. 100, 200)"
    },
    "dailyConsumptionWh": {
      "type": "number",
      "description": "Daily energy consumption in watt-hours (from calculate_power_budget)"
    },
    "singleBatteryVoltage": {
      "type": "number",
      "description": "Voltage of a single battery (e.g. 12.8 for LiFePO4, 12 for lead-acid)"
    },
    "depthOfDischargePercent": {
      "type": "number",
      "default": 80,
      "description": "Usable percentage of battery capacity. LiFePO4: 80-90%, AGM: 50%, Gel: 50% (default: 80)"
    }
  },
  "additionalProperties": false
}

calculate_battery_config

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.

Argument	Type	Description
targetVoltage*	number	Desired system voltage (e.g. 12, 24, 48)
singleBatteryAh*	number	Capacity of one battery in amp-hours
targetCapacityAh*	number	Desired total capacity in amp-hours
singleBatteryVoltage*	number	Nominal voltage of one battery (e.g. 12.8 for LiFePO4, 12 for lead-acid, 3.2 for LiFePO4 cells)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "targetVoltage",
    "targetCapacityAh",
    "singleBatteryVoltage",
    "singleBatteryAh"
  ],
  "properties": {
    "targetVoltage": {
      "type": "number",
      "description": "Desired system voltage (e.g. 12, 24, 48)"
    },
    "singleBatteryAh": {
      "type": "number",
      "description": "Capacity of one battery in amp-hours"
    },
    "targetCapacityAh": {
      "type": "number",
      "description": "Desired total capacity in amp-hours"
    },
    "singleBatteryVoltage": {
      "type": "number",
      "description": "Nominal voltage of one battery (e.g. 12.8 for LiFePO4, 12 for lead-acid, 3.2 for LiFePO4 cells)"
    }
  },
  "additionalProperties": false
}

calculate_charging_time

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.

Argument	Type	Description
batteryVoltage*	number	Battery bank voltage (e.g. 12, 24, 48)
chargePowerWatts*	number	Charger output power in watts
batteryCapacityAh*	number	Total battery bank capacity in amp-hours
chargeCurrentAmps	number	Maximum charge current in amps (if limited by the charger or battery BMS). If omitted, calculated from power and voltage.
targetStateOfChargePercent	number	Target state of charge in percent (default: 100)
currentStateOfChargePercent*	number	Current state of charge in percent (e.g. 20 for 20%)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "batteryCapacityAh",
    "batteryVoltage",
    "currentStateOfChargePercent",
    "chargePowerWatts"
  ],
  "properties": {
    "batteryVoltage": {
      "type": "number",
      "description": "Battery bank voltage (e.g. 12, 24, 48)"
    },
    "chargePowerWatts": {
      "type": "number",
      "description": "Charger output power in watts"
    },
    "batteryCapacityAh": {
      "type": "number",
      "description": "Total battery bank capacity in amp-hours"
    },
    "chargeCurrentAmps": {
      "type": "number",
      "description": "Maximum charge current in amps (if limited by the charger or battery BMS). If omitted, calculated from power and voltage."
    },
    "targetStateOfChargePercent": {
      "type": "number",
      "default": 100,
      "description": "Target state of charge in percent (default: 100)"
    },
    "currentStateOfChargePercent": {
      "type": "number",
      "description": "Current state of charge in percent (e.g. 20 for 20%)"
    }
  },
  "additionalProperties": false
}

calculate_inverter_size

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.

Argument	Type	Description
loads*	array	List of AC loads that will run through the inverter
systemVoltage*	number	DC system voltage (e.g. 12, 24, 48)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "systemVoltage",
    "loads"
  ],
  "properties": {
    "loads": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "continuousWatts"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the AC load (e.g. \"Microwave\", \"Coffee Machine\")"
          },
          "quantity": {
            "type": "number",
            "default": 1,
            "description": "Number of identical units (default: 1)"
          },
          "surgeWatts": {
            "type": "number",
            "description": "Startup surge power in watts (for motors, compressors). If omitted, assumed equal to continuous watts."
          },
          "continuousWatts": {
            "type": "number",
            "description": "Continuous power draw in watts"
          }
        },
        "additionalProperties": false
      },
      "description": "List of AC loads that will run through the inverter"
    },
    "systemVoltage": {
      "type": "number",
      "description": "DC system voltage (e.g. 12, 24, 48)"
    }
  },
  "additionalProperties": false
}

calculate_power_budget

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.

Argument	Type	Description
loads*	array	List of electrical loads to include in the budget
systemVoltage*	number	System voltage in volts (e.g. 12, 24, 48)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "systemVoltage",
    "loads"
  ],
  "properties": {
    "loads": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "powerWatts",
          "hoursPerDay"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Name of the load (e.g. \"LED Lights\")"
          },
          "quantity": {
            "type": "number",
            "default": 1,
            "description": "Number of identical units (default: 1)"
          },
          "powerWatts": {
            "type": "number",
            "description": "Power consumption of a single unit in watts"
          },
          "hoursPerDay": {
            "type": "number",
            "description": "Average hours of use per day"
          }
        },
        "additionalProperties": false
      },
      "description": "List of electrical loads to include in the budget"
    },
    "systemVoltage": {
      "type": "number",
      "description": "System voltage in volts (e.g. 12, 24, 48)"
    }
  },
  "additionalProperties": false
}

calculate_solar_size

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.

Argument	Type	Description
peakSunHours*	number	Average daily peak sun hours for the location. Examples: Northern Europe winter 1-2h, summer 4-6h. Southern US 5-6h. Equatorial regions 5-7h.
systemEfficiency	number	Overall system efficiency factor (default: 0.85). Accounts for MPPT losses, wiring losses, temperature derating, and panel soiling.
dailyConsumptionWh*	number	Daily energy consumption in watt-hours (from calculate_power_budget)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "dailyConsumptionWh",
    "peakSunHours"
  ],
  "properties": {
    "peakSunHours": {
      "type": "number",
      "description": "Average daily peak sun hours for the location. Examples: Northern Europe winter 1-2h, summer 4-6h. Southern US 5-6h. Equatorial regions 5-7h."
    },
    "systemEfficiency": {
      "type": "number",
      "default": 0.85,
      "description": "Overall system efficiency factor (default: 0.85). Accounts for MPPT losses, wiring losses, temperature derating, and panel soiling."
    },
    "dailyConsumptionWh": {
      "type": "number",
      "description": "Daily energy consumption in watt-hours (from calculate_power_budget)"
    }
  },
  "additionalProperties": false
}

calculate_wire_gauge

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

Argument	Type	Description
power	number	Load power in watts. Will be converted to current using the voltage. Provide either current or power.
current	number	Load current in amps. Provide either current or power.
voltage*	number	System voltage in volts (e.g. 12, 24, 48)
isRoundTrip	boolean	Account for both positive and negative conductor (default: true). Set to false for chassis-ground returns.
cableLengthM*	number	One-way cable length in meters
temperatureCelsius	number	Ambient temperature in °C (default: 20°C). Affects copper resistance.
maxVoltageDropPercent	number	Maximum acceptable voltage drop in percent (default: 3%)

Input schema (JSON)

generate_wiring_diagram

Generate an electrical wiring diagram for campers, boats, or off-grid setups. Returns a complete schematic with batteries, chargers, protection components, and loads. Protection components (shunt, main switch, low-voltage cutoff) are auto-generated when both batteries and loads are provided.

Argument	Type	Description
loads	array	Electrical loads / consumers
format	string	Output format: svg (recommended, renders inline) or png (base64-encoded image, may not display in all clients)
chargers	array	Chargers with their power sources
batteries	array	Batteries in the system
systemName*	string	Name of the electrical system (e.g. "My Camper Van")

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "systemName"
  ],
  "properties": {
    "loads": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "power",
          "voltage",
          "current"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Load name (e.g. \"LED Lights\")"
          },
          "power": {
            "type": "number",
            "description": "Power consumption in watts"
          },
          "current": {
            "type": "number",
            "description": "Current draw in amps"
          },
          "voltage": {
            "type": "number",
            "description": "Operating voltage"
          }
        },
        "additionalProperties": false
      },
      "description": "Electrical loads / consumers"
    },
    "format": {
      "enum": [
        "svg",
        "png"
      ],
      "type": "string",
      "default": "svg",
      "description": "Output format: svg (recommended, renders inline) or png (base64-encoded image, may not display in all clients)"
    },
    "chargers": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "inputVoltage",
          "outputVoltage",
          "power"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Charger name (e.g. \"MPPT Solar Charger\")"
          },
          "power": {
            "type": "number",
            "description": "Power rating in watts"
          },
          "sourceType": {
            "enum": [
              "shore",
              "solar",
              "wind",
              "generator",
              "alternator"
            ],
            "type": "string",
            "description": "Type of power source feeding this charger"
          },
          "inputVoltage": {
            "type": "number",
            "description": "Input voltage. For shore/generator (AC) chargers use the regional mains voltage: 230 V in Europe, UK, Australia, most of Asia and Africa; 120 V in North America and Japan. For solar/wind use the panel or turbine output voltage. For alternator use the vehicle system voltage (typically 14 V)."
          },
          "outputVoltage": {
            "type": "number",
            "description": "Output voltage"
          }
        },
        "additionalProperties": false
      },
      "description": "Chargers with their power sources"
    },
    "batteries": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "voltage",
          "capacityAh",
          "energyWh"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Battery name (e.g. \"LiFePO4 100Ah\")"
          },
          "voltage": {
            "type": "number",
            "description": "Nominal voltage (e.g. 12)"
          },
          "energyWh": {
            "type": "number",
            "description": "Energy in watt-hours"
          },
          "capacityAh": {
            "type": "number",
            "description": "Capacity in amp-hours"
          }
        },
        "additionalProperties": false
      },
      "description": "Batteries in the system"
    },
    "systemName": {
      "type": "string",
      "description": "Name of the electrical system (e.g. \"My Camper Van\")"
    }
  },
  "additionalProperties": false
}

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.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}