{"openapi":"3.1.0","info":{"title":"SolarMath API","version":"0.1.0","description":"A fully local home solar-panel payback and sizing calculator toolkit: a real payback-period calculator (simple and electricity-rate-inflation-adjusted), a 25-year cumulative-savings projection computed as real compound growth, and a rough panel-count system-sizing estimator. Estimates only, not a quote or a substitute for a licensed solar installer.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://solarmath.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/solarmath/docs"},"termsOfService":"https://connectorbay.com/solarmath/terms"},"servers":[{"url":"https://solarmath.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/solarmath/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/solar_payback_calculator":{"post":{"operationId":"solar_payback_calculator","summary":"Computes a real payback period — net system cost (after any tax credit) divided by year-1 annual","description":"Computes a real payback period — net system cost (after any tax credit) divided by year-1 annual\n    savings — plus a year-by-year 25-year (or custom-length) cumulative-savings projection that compounds the\n    electricity rate at rate_inflation_pct/year, and an inflation-adjusted payback point (when cumulative\n    savings actually cross net cost, usually a bit sooner than the simple figure). Use for \"how long until my\n    $20,000 solar system pays for itself with a 30% tax credit\", \"what will I save over 25 years\". Real math\n    from the numbers given plus a documented, overridable rate-inflation assumption — not a quote.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"system_cost":{"description":"Total upfront cost of the solar system, before any tax credit, in dollars.","exclusiveMinimum":0,"title":"System Cost","type":"number"},"annual_production_kwh":{"description":"Expected annual energy production of the system, in kWh.","exclusiveMinimum":0,"title":"Annual Production Kwh","type":"number"},"electricity_rate_per_kwh":{"description":"Your current electricity rate, in dollars per kWh.","exclusiveMinimum":0,"title":"Electricity Rate Per Kwh","type":"number"},"tax_credit_pct":{"default":0.0,"description":"Any available tax credit, as a percent of system cost (e.g. 30 for 30%). Default 0.","maximum":100,"minimum":0,"title":"Tax Credit Pct","type":"number"},"rate_inflation_pct":{"default":3.0,"description":"Assumed average annual electricity-rate increase, as a percent. Default 3.0.","maximum":50,"minimum":0,"title":"Rate Inflation Pct","type":"number"},"projection_years":{"default":25,"description":"How many years to project cumulative savings over. Default 25.","maximum":40,"minimum":1,"title":"Projection Years","type":"integer"}},"required":["system_cost","annual_production_kwh","electricity_rate_per_kwh"],"title":"solar_payback_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/system_size_estimator":{"post":{"operationId":"system_size_estimator","summary":"A rough system-sizing estimate using the standard solar-industry back-of-envelope method: required","description":"A rough system-sizing estimate using the standard solar-industry back-of-envelope method: required\n    system size (kW) = average daily kWh usage / (average peak sun hours x (1 - system-loss %)); panel count\n    = that size in watts / panel wattage, rounded up. Use for \"how many solar panels do I need for 900 kWh a\n    month\". Not a shading/roof/orientation-specific design — a licensed installer's site assessment is needed\n    for an actual system.","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"avg_monthly_usage_kwh":{"description":"Your average monthly electricity usage, in kWh (from a utility bill).","exclusiveMinimum":0,"title":"Avg Monthly Usage Kwh","type":"number"},"avg_sun_hours_per_day":{"default":5.0,"description":"Local average peak sun hours per day (not daylight hours) — commonly 3-6 for most of the U.S. Default 5.0.","exclusiveMinimum":0,"maximum":24,"title":"Avg Sun Hours Per Day","type":"number"},"panel_watt":{"default":400.0,"description":"Wattage of one solar panel. Default 400, a common modern residential panel size.","exclusiveMinimum":0,"maximum":1000,"title":"Panel Watt","type":"number"},"system_loss_pct":{"default":15.0,"description":"Combined inverter/wiring/soiling/temperature system losses, as a percent. Default 15.","maximum":60,"minimum":0,"title":"System Loss Pct","type":"number"}},"required":["avg_monthly_usage_kwh"],"title":"system_size_estimatorArguments","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}}}}