{"openapi":"3.1.0","info":{"title":"Volt API","version":"0.1.0","description":"A fully local home electrical reference and calculator toolkit: wire gauge guidance, circuit load and voltage drop calculators, GFCI/AFCI outlet explainers, breaker-tripping troubleshooting, LED brightness equivalents, extension cord safety, a glossary, and a safety checklist. Educational reference only, not a substitute for a licensed electrician.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://volt.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/volt/docs"},"termsOfService":"https://connectorbay.com/volt/terms"},"servers":[{"url":"https://volt.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/volt/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/wire_gauge_guide":{"post":{"operationId":"wire_gauge_guide","summary":"Commonly-cited AWG copper wire gauge for common U.S. household circuit types: 15A general lighting/outlets","description":"Commonly-cited AWG copper wire gauge for common U.S. household circuit types: 15A general lighting/outlets\n    (14 AWG), 20A kitchen/bath/small-appliance (12 AWG), 30A dryer (10 AWG), 40A/50A range/oven (8/6 AWG). Use for\n    \"what gauge wire for a 20 amp circuit\", \"what wire size does a dryer need\". A licensed electrician must\n    confirm the exact gauge and circuit for any real installation — local code always governs.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amperage_or_circuit_type":{"description":"An amperage ('15', '20A') or a circuit type ('general lighting', 'kitchen', 'dryer', 'range').","examples":["20","dryer","kitchen"],"title":"Amperage Or Circuit Type","type":"string"}},"required":["amperage_or_circuit_type"],"title":"wire_gauge_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/circuit_load_calculator":{"post":{"operationId":"circuit_load_calculator","summary":"Computes amps = total watts / voltage, and checks that figure against common residential breaker sizes","description":"Computes amps = total watts / voltage, and checks that figure against common residential breaker sizes\n    (15/20/30/40/50A) using the commonly-cited 80%-continuous-load convention (e.g. a 15A circuit generally\n    should not be loaded above 12A for a continuous — 3+ hour — load). Use for \"how many amps is 1800 watts\",\n    \"will a 1500W heater and an 800W appliance fit on a 15 amp circuit\". Real math; not a full NEC load\n    calculation and not a substitute for a licensed electrician's design.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"watts":{"anyOf":[{"type":"number"},{"items":{"type":"number"},"type":"array"}],"description":"A single total wattage, or a list of individual device wattages to sum (e.g. [1500, 800, 200]).","examples":[1800,[1500,800,200]],"title":"Watts"},"voltage":{"default":120,"description":"Circuit voltage — typically 120 (standard outlets) or 240 (large appliances).","maximum":600,"minimum":1,"title":"Voltage","type":"number"}},"required":["watts"],"title":"circuit_load_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/outlet_type_guide":{"post":{"operationId":"outlet_type_guide","summary":"What standard, GFCI, and AFCI outlets/breakers do, and where each is commonly required by code (GFCI near","description":"What standard, GFCI, and AFCI outlets/breakers do, and where each is commonly required by code (GFCI near\n    water — kitchens, bathrooms, garages, outdoors, laundry; AFCI in bedrooms and most other habitable rooms in\n    modern code). Use for \"does my bathroom need a GFCI\", \"what's the difference between GFCI and AFCI\". General\n    and commonly-required guidance only — always confirm against your local code edition and amendments.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"standard, gfci, afci, or combination/dual-function.","examples":["gfci","afci"],"title":"Name","type":"string"}},"required":["name"],"title":"outlet_type_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/breaker_tripping_troubleshooter":{"post":{"operationId":"breaker_tripping_troubleshooter","summary":"A likely cause and a safe next step for a breaker-tripping symptom — trips immediately (likely short","description":"A likely cause and a safe next step for a breaker-tripping symptom — trips immediately (likely short\n    circuit), trips under load (likely overload), won't reset (active fault or worn breaker), or a GFCI that\n    trips repeatedly (ground fault, nuisance trip, or failing device). Use for \"why does my breaker keep\n    tripping\". Always call a licensed electrician if unsure or if it keeps happening — do not keep resetting a\n    breaker that keeps tripping.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"symptom":{"description":"trips immediately, trips under load, won't reset, or GFCI trips repeatedly.","examples":["trips immediately","won't reset","gfci trips repeatedly"],"title":"Symptom","type":"string"}},"required":["symptom"],"title":"breaker_tripping_troubleshooterArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/light_bulb_equivalents":{"post":{"operationId":"light_bulb_equivalents","summary":"Incandescent-watt-equivalent brightness reference for LED bulbs — lumens for common incandescent wattages","description":"Incandescent-watt-equivalent brightness reference for LED bulbs — lumens for common incandescent wattages\n    (15-150W) and the approximate LED wattage that produces the same light output. Use for \"what LED watt\n    replaces a 60 watt bulb\", \"how many lumens is a 100 watt bulb\". Figures are commonly-cited approximations;\n    check the actual lumens rating printed on the LED packaging.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"An incandescent wattage ('60W'), a lumens figure ('800 lumens'), or omit for the full table.","examples":["60W","800 lumens"],"title":"Item"}},"title":"light_bulb_equivalentsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/home_electrical_glossary":{"post":{"operationId":"home_electrical_glossary","summary":"Plain-language definitions of core home-electrical terms: amperage, voltage, wattage, resistance, circuit,","description":"Plain-language definitions of core home-electrical terms: amperage, voltage, wattage, resistance, circuit,\n    breaker, fuse, GFCI, AFCI, grounding, short circuit, ground fault, overload, service panel. Use for \"what\n    does GFCI mean\", \"what's the difference between a breaker and a fuse\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","examples":["GFCI","grounding"],"title":"Term"}},"title":"home_electrical_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/extension_cord_safety_guide":{"post":{"operationId":"extension_cord_safety_guide","summary":"Gauge and length guidance for an indoor light-duty, medium-duty, or heavy-duty/outdoor/appliance extension","description":"Gauge and length guidance for an indoor light-duty, medium-duty, or heavy-duty/outdoor/appliance extension\n    cord use case, plus general safety practices (never daisy-chain, don't run under rugs, use outdoor-rated\n    cords outside, inspect before use). Use for \"what gauge extension cord do I need for a space heater\n    outside\". Extension cords are temporary wiring, not a permanent fix — a spot that regularly needs one likely\n    needs a real outlet, which is electrician/permit work.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"use_case":{"description":"e.g. 'indoor light duty', 'power tools', 'outdoor heavy duty', 'space heater'.","examples":["outdoor heavy duty","power tools"],"title":"Use Case","type":"string"}},"required":["use_case"],"title":"extension_cord_safety_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/voltage_drop_calculator":{"post":{"operationId":"voltage_drop_calculator","summary":"An approximate voltage-drop-over-distance estimate for a copper conductor, using a simplified published","description":"An approximate voltage-drop-over-distance estimate for a copper conductor, using a simplified published\n    method: round-trip resistance (from a standard AWG resistance-per-length table) multiplied by current. Use\n    for \"voltage drop over 100 feet of 12 gauge wire at 15 amps\". This is a reference approximation, NOT a\n    code-compliance voltage-drop calculation — it ignores conduit fill, temperature, and other real-world\n    factors a licensed electrician's calculation would include.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"amps":{"description":"Current the circuit will carry, in amps.","exclusiveMinimum":0,"maximum":400,"title":"Amps","type":"number"},"wire_gauge":{"description":"AWG copper wire size: 14, 12, 10, 8, 6, or 4.","examples":["12","10 AWG"],"title":"Wire Gauge","type":"string"},"length_ft":{"description":"One-way distance from the source (panel) to the load, in feet.","exclusiveMinimum":0,"maximum":10000,"title":"Length Ft","type":"number"},"voltage":{"default":120,"description":"Source voltage — typically 120 or 240.","exclusiveMinimum":0,"maximum":600,"title":"Voltage","type":"number"}},"required":["amps","wire_gauge","length_ft"],"title":"voltage_drop_calculatorArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/electrical_safety_checklist":{"post":{"operationId":"electrical_safety_checklist","summary":"A general home electrical safety self-check list: no overloaded outlets/power strips, warm outlet covers","description":"A general home electrical safety self-check list: no overloaded outlets/power strips, warm outlet covers\n    or a burning smell, the GFCI test-button routine, damaged cords, panel access, and more. Use for \"electrical\n    safety checklist for my house\". Covers visual/self checks only — recommend a licensed electrician inspection\n    for anything beyond that.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"electrical_safety_checklistArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}