{"openapi":"3.1.0","info":{"title":"VoltPlan API","version":"0.2.1","description":"VoltPlan's programmatic interface is the wiring-diagram MCP (Model Context Protocol) server, exposed over Streamable HTTP. It generates 12V/24V/48V wiring diagrams and performs wire gauge, fuse, battery bank, inverter, solar, and charging-time calculations. No API key or account is required.","contact":{"name":"VoltPlan","url":"https://voltplan.app/developers","email":"support@voltplan.app"},"license":{"name":"MIT","url":"https://github.com/YUZU-Hub/wiring-diagram-mcp/blob/main/LICENSE"}},"externalDocs":{"description":"MCP server source, tool parameter schemas, and changelog","url":"https://github.com/YUZU-Hub/wiring-diagram-mcp"},"servers":[{"url":"https://voltplan.app/.well-known/mcp","description":"VoltPlan-hosted proxy to the live MCP endpoint"},{"url":"https://mcp.voltplan.app/mcp","description":"Canonical MCP Streamable HTTP endpoint"}],"paths":{"/":{"post":{"operationId":"callMcp","summary":"Send an MCP JSON-RPC message (initialize, tools/list, tools/call, ...)","description":"Streamable HTTP transport: send one JSON-RPC 2.0 request per call. Start with `initialize`, then `tools/list` to enumerate tools, then `tools/call` with `{ name, arguments }` to run one. The response is `application/json` or `text/event-stream` depending on the `Accept` header sent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcRequest"},"examples":{"initialize":{"value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"example-client","version":"0.0.1"}}}},"callTool":{"value":{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"calculate_wire_gauge","arguments":{}}}}}}}},"parameters":[{"name":"Mcp-Session-Id","in":"header","required":false,"description":"Session id returned by `initialize`; required on every call after that.","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON-RPC result or SSE stream of JSON-RPC messages","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JsonRpcResponse"}},"text/event-stream":{"schema":{"type":"string"}}}}}},"get":{"operationId":"openMcpStream","summary":"Open the server-initiated SSE stream for an existing session","parameters":[{"name":"Mcp-Session-Id","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"text/event-stream of server-initiated JSON-RPC messages"}}},"delete":{"operationId":"closeMcpSession","summary":"Terminate an MCP session","parameters":[{"name":"Mcp-Session-Id","in":"header","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Session closed"}}}}},"components":{"schemas":{"JsonRpcRequest":{"type":"object","required":["jsonrpc","method"],"properties":{"jsonrpc":{"const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"method":{"type":"string","enum":["initialize","tools/list","tools/call"]},"params":{"type":"object","additionalProperties":true}}},"JsonRpcResponse":{"type":"object","properties":{"jsonrpc":{"const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"integer"}]},"result":{"type":"object","additionalProperties":true},"error":{"type":"object","properties":{"code":{"type":"integer"},"message":{"type":"string"}}}}}}},"x-mcp-tools":[{"name":"generate_wiring_diagram","description":"Generate a complete 12V/24V/48V wiring diagram from a list of components (batteries, loads, chargers, solar panels, inverters). Returns PNG or SVG."},{"name":"calculate_wire_gauge","description":"Calculate the correct wire gauge (AWG and mm²), voltage drop, and fuse size for a DC circuit given voltage, current, and cable length."},{"name":"calculate_battery_bank","description":"Size a battery bank for a given daily energy demand, days of autonomy, and depth of discharge."},{"name":"calculate_battery_config","description":"Work out a series/parallel configuration of individual cells or batteries for a target system voltage and capacity."},{"name":"calculate_charging_time","description":"Estimate battery charging time from a given charger or solar array."},{"name":"calculate_inverter_size","description":"Recommend an inverter size based on AC load profile, surge requirements, and system voltage."},{"name":"calculate_power_budget","description":"Build a 24h power budget from loads to size batteries, solar, and wiring."},{"name":"calculate_solar_size","description":"Size a solar array based on daily energy needs, location / sun hours, and system voltage."},{"name":"list_component_types","description":"List the component types VoltPlan knows about (batteries, chargers, loads, inverters, panels, etc.)."}]}