Paid Solar PV Design Calculations API via x402. Unpaid tool calls return 402.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Size battery energy and inverter continuous/surge power needed to back up critical loads for a target autonomy with DoD and efficiency derates. Price $0.03 USDC. POST /api/v1/solar-design/battery-backup-sizing. An unpaid call returns the x402 payment terms and does not run.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http solar-design https://www.brainiac.software/mcp/solar-design
Size battery energy and inverter continuous/surge power needed to back up critical loads for a target autonomy with DoD and efficiency derates. Price $0.03 USDC. POST /api/v1/solar-design/battery-backup-sizing. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| loads* | array | |
| autonomyHours* | number | |
| inverterMargin | number | |
| depthOfDischarge* | number | |
| simultaneousStart | boolean | |
| temperatureDerate | number | |
| dischargeEfficiency* | number | |
| pvRechargeKwhPerDay | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"loads",
"autonomyHours",
"depthOfDischarge",
"dischargeEfficiency"
],
"properties": {
"loads": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"powerKw",
"hoursPerDay"
],
"properties": {
"name": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"powerKw": {
"type": "number",
"exclusiveMinimum": 0
},
"surgeKw": {
"type": "number",
"exclusiveMinimum": 0
},
"dutyFactor": {
"type": "number",
"default": 1,
"maximum": 1,
"exclusiveMinimum": 0
},
"hoursPerDay": {
"type": "number",
"maximum": 24,
"exclusiveMinimum": 0
}
}
},
"maxItems": 200,
"minItems": 1
},
"autonomyHours": {
"type": "number",
"exclusiveMinimum": 0
},
"inverterMargin": {
"type": "number",
"default": 1.25,
"exclusiveMinimum": 0
},
"depthOfDischarge": {
"type": "number",
"maximum": 1,
"exclusiveMinimum": 0
},
"simultaneousStart": {
"type": "boolean",
"default": false
},
"temperatureDerate": {
"type": "number",
"default": 1,
"maximum": 1,
"exclusiveMinimum": 0
},
"dischargeEfficiency": {
"type": "number",
"maximum": 1,
"exclusiveMinimum": 0
},
"pvRechargeKwhPerDay": {
"type": "number",
"default": 0,
"minimum": 0
}
}
}Compute the DC/AC ratio and optionally estimate AC energy and clipping from a caller DC power series with constant efficiency or a PVWatts inverter curve. Price $0.03 USDC. POST /api/v1/solar-design/dc-ac-ratio-check. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| acRatingKw* | number | |
| useCecCurve | boolean | |
| dcNameplateKw* | number | |
| intervalHours | number | |
| ratioWarnAbove | number | |
| dcPowerSeriesKw | array | |
| inverterEfficiency | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"dcNameplateKw",
"acRatingKw"
],
"properties": {
"acRatingKw": {
"type": "number",
"exclusiveMinimum": 0
},
"useCecCurve": {
"type": "boolean",
"default": false
},
"dcNameplateKw": {
"type": "number",
"exclusiveMinimum": 0
},
"intervalHours": {
"type": "number",
"default": 1,
"exclusiveMinimum": 0
},
"ratioWarnAbove": {
"type": "number",
"default": 1.3,
"exclusiveMinimum": 0
},
"dcPowerSeriesKw": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 105408
},
"inverterEfficiency": {
"type": "number",
"default": 0.96,
"maximum": 1,
"exclusiveMinimum": 0
}
}
}Estimate AC energy from caller POA irradiance and temperatures using the PVWatts v5 DC and inverter models with a transparent loss stack. Price $0.04 USDC. POST /api/v1/solar-design/energy-yield-estimate. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| monthly | array | |
| records | array | |
| gammaPdc* | number | |
| acRatingW* | number | |
| dcNameplateW* | number | |
| intervalHours | number | |
| lossesPercent | number | |
| temperatureModel | object | |
| inverterNominalEfficiency | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"dcNameplateW",
"gammaPdc",
"acRatingW"
],
"properties": {
"monthly": {
"type": "array",
"items": {
"type": "object",
"required": [
"poaKwhPerM2",
"avgAmbientTemp"
],
"properties": {
"poaKwhPerM2": {
"type": "number",
"minimum": 0
},
"avgAmbientTemp": {
"type": "number"
}
}
},
"maxItems": 12,
"minItems": 12
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"time",
"poa"
],
"properties": {
"poa": {
"type": "number",
"minimum": 0
},
"time": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"cellTemp": {
"type": "number"
},
"windSpeed": {
"type": "number",
"default": 1,
"minimum": 0
},
"ambientTemp": {
"type": "number"
}
}
},
"maxItems": 105408,
"minItems": 1
},
"gammaPdc": {
"type": "number"
},
"acRatingW": {
"type": "number",
"exclusiveMinimum": 0
},
"dcNameplateW": {
"type": "number",
"exclusiveMinimum": 0
},
"intervalHours": {
"type": "number",
"default": 1,
"exclusiveMinimum": 0
},
"lossesPercent": {
"type": "number",
"default": 14.08,
"maximum": 100,
"minimum": 0
},
"temperatureModel": {
"type": "object",
"required": [
"type"
],
"properties": {
"uc": {
"type": "number",
"default": 29,
"exclusiveMinimum": 0
},
"uv": {
"type": "number",
"default": 0,
"minimum": 0
},
"type": {
"type": "string",
"const": "pvsyst"
},
"alphaAbsorption": {
"type": "number",
"default": 0.9,
"maximum": 1,
"exclusiveMinimum": 0
},
"moduleEfficiency": {
"type": "number",
"default": 0.1,
"maximum": 1,
"exclusiveMinimum": 0
}
}
},
"inverterNominalEfficiency": {
"type": "number",
"default": 0.96,
"maximum": 1,
"exclusiveMinimum": 0
}
}
}Compute simple payback, NPV, IRR and LCOE from capex, incentives, year-1 energy, degradation, O&M and price escalation. Price $0.03 USDC. POST /api/v1/solar-design/financial-payback. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| capex* | number | |
| years* | integer | |
| omPerYear | number | |
| degradation | number | |
| discountRate* | number | |
| omEscalation | number | |
| year1EnergyKwh* | number | |
| energyEscalation | number | |
| energyValuePerKwh* | number | |
| upfrontIncentives | number |
Estimate beam and isotropic sky-diffuse losses caused by a caller far-field horizon profile against sun positions and beam POA. Price $0.03 USDC. POST /api/v1/solar-design/horizon-shading-loss. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| times | array | |
| beamPoa | array | |
| horizon* | array | |
| records | array | |
| latitude | number | |
| elevation | number | |
| longitude | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"horizon"
],
"properties": {
"times": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 105408
},
"beamPoa": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 105408
},
"horizon": {
"type": "array",
"items": {
"type": "object",
"required": [
"azimuth",
"elevation"
],
"properties": {
"azimuth": {
"type": "number",
"maximum": 360,
"minimum": 0
},
"elevation": {
"type": "number",
"maximum": 90,
"minimum": 0
}
}
},
"maxItems": 360,
"minItems": 4
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"sunElevation",
"sunAzimuth",
"beamPoa"
],
"properties": {
"beamPoa": {
"type": "number",
"minimum": 0
},
"sunAzimuth": {
"type": "number",
"maximum": 360,
"minimum": 0
},
"sunElevation": {
"type": "number"
}
}
},
"maxItems": 105408,
"minItems": 1
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"elevation": {
"type": "number",
"default": 0
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
}
}
}Maximise the number of modules on a roof-face polygon with caller setbacks, orientation, gaps and obstruction polygons. Price $0.04 USDC. POST /api/v1/solar-design/module-layout-fit. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| gap | number | |
| roof* | array | |
| module* | object | |
| setback* | number | |
| gridOffsets | integer | |
| obstructions | array | |
| orientations | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"roof",
"setback",
"module"
],
"properties": {
"gap": {
"type": "number",
"default": 0.02,
"minimum": 0
},
"roof": {
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"maxItems": 200,
"minItems": 3
},
"module": {
"type": "object",
"required": [
"width",
"height"
],
"properties": {
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
}
}
},
"setback": {
"type": "number",
"minimum": 0
},
"gridOffsets": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1
},
"obstructions": {
"type": "array",
"items": {
"type": "object",
"required": [
"polygon"
],
"properties": {
"polygon": {
"type": "array",
"items": {
"type": "array",
"items": [
{
"type": "number"
},
{
"type": "number"
}
],
"maxItems": 2,
"minItems": 2,
"additionalItems": false
},
"maxItems": 100,
"minItems": 3
},
"setback": {
"type": "number",
"default": 0,
"minimum": 0
}
}
},
"default": [],
"maxItems": 50
},
"orientations": {
"type": "array",
"items": {
"enum": [
"portrait",
"landscape"
],
"type": "string"
},
"default": [
"portrait",
"landscape"
],
"maxItems": 2,
"minItems": 1
}
}
}Normalise and compare module datasheet values for efficiency, W/m², temperature-adjusted power, price per watt and warranty retention. Price $0.02 USDC. POST /api/v1/solar-design/module-spec-compare. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| modules* | array | |
| referenceCellTemp | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"modules"
],
"properties": {
"modules": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"pmax"
],
"properties": {
"name": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"noct": {
"type": "number"
},
"pmax": {
"type": "number",
"exclusiveMinimum": 0
},
"price": {
"type": "number",
"exclusiveMinimum": 0
},
"width": {
"type": "number",
"exclusiveMinimum": 0
},
"height": {
"type": "number",
"exclusiveMinimum": 0
},
"pmaxNoct": {
"type": "number"
},
"tempCoeffPmax": {
"type": "number"
},
"warrantyYear25Retention": {
"type": "number",
"maximum": 1,
"minimum": 0
}
}
},
"maxItems": 50,
"minItems": 2
},
"referenceCellTemp": {
"type": "number",
"default": 45
}
}
}Compute PV circuit maximum current and minimum conductor ampacity using NEC 690.8 125% factors for the selected code edition. Price $0.02 USDC. POST /api/v1/solar-design/nec-690-current. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| edition | string | |
| moduleIsc* | number | |
| parallelStrings | integer | |
| continuousFactor | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"moduleIsc"
],
"properties": {
"edition": {
"enum": [
"2017",
"2020",
"2023"
],
"type": "string",
"default": "2023"
},
"moduleIsc": {
"type": "number",
"exclusiveMinimum": 0
},
"parallelStrings": {
"type": "integer",
"default": 1,
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
"continuousFactor": {
"type": "number",
"default": 1.25,
"exclusiveMinimum": 0
}
}
}Parse PVsyst PAN (module) and OND (inverter) text files into nested raw JSON and a normalised datasheet object. Price $0.02 USDC. POST /api/v1/solar-design/pan-ond-parse. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| content* | string | |
| fileType* | string |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"fileType",
"content"
],
"properties": {
"content": {
"type": "string",
"maxLength": 524288,
"minLength": 1
},
"fileType": {
"enum": [
"pan",
"ond"
],
"type": "string"
}
}
}Compute plane-of-array irradiance with isotropic, Hay-Davies or Perez sky models and NREL SPA solar geometry from caller irradiance records. Price $0.04 USDC. POST /api/v1/solar-design/poa-irradiance-transpose. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| tilt* | number | |
| model | string | |
| albedo | number | |
| deltaT | number | |
| azimuth* | number | |
| records* | array | |
| latitude* | number | |
| elevation | number | |
| longitude* | number | |
| pressurePa | number | |
Compute row height, shadow gap, row pitch and ground coverage ratio that avoid row-to-row shading at a design sun position. Price $0.02 USDC. POST /api/v1/solar-design/row-spacing. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| sun | object | |
| tilt* | number | |
| latitude | number | |
| elevation | number | |
| longitude | number | |
| designTimes | array | |
| groundSlope | number | |
| arrayAzimuth | number | |
| moduleSlopeLength* | number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"moduleSlopeLength",
"tilt"
],
"properties": {
"sun": {
"type": "object",
"required": [
"elevation",
"azimuth"
],
"properties": {
"azimuth": {
"type": "number",
"maximum": 360,
"minimum": 0
},
"elevation": {
"type": "number"
}
}
},
"tilt": {
"type": "number",
"maximum": 90,
"minimum": 0
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"elevation": {
"type": "number",
"default": 0
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"designTimes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"maxItems": 48
},
"groundSlope": {
"type": "number",
"default": 0
},
"arrayAzimuth": {
"type": "number",
"default": 180,
"maximum": 360,
"minimum": 0
},
"moduleSlopeLength": {
"type": "number",
"exclusiveMinimum": 0
}
}
}Compute minimum and maximum modules per series string and maximum parallel strings per MPPT from module temperature coefficients, site temperatures and inverter DC limits. Price $0.03 USDC. POST /api/v1/solar-design/string-sizing. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| site* | object | |
| module* | object | |
| inverter* | object |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"module",
"site",
"inverter"
],
"properties": {
"site": {
"type": "object",
"required": [
"recordLowAmbient",
"maxCellTemp"
],
"properties": {
"maxCellTemp": {
"type": "number"
},
"recordLowAmbient": {
"type": "number"
}
}
},
"module": {
"type": "object",
"required": [
"voc",
"vmp",
"isc",
"tempCoeffVoc",
"tempCoeffVocUnit",
"tempCoeffVmp",
"tempCoeffVmpUnit",
"tempCoeffIsc",
"tempCoeffIscUnit"
],
"properties": {
"imp": {
"type": "number",
"exclusiveMinimum": 0
},
"isc": {
"type": "number",
"exclusiveMinimum": 0
},
"vmp": {
"type": "number",
"exclusiveMinimum": 0
},
"voc": {
"type": "number",
"exclusiveMinimum": 0
},
"bifacialGain": {
"type": "number",
"default": 0,
"maximum": 0.5,
"minimum": 0
},
"tempCoeffIsc": {
"type": "number"
},
"tempCoeffVmp": {
"type": "number"
},
"tempCoeffVoc": {
"type": "number"
},
"tempCoeffIscUnit": {
"enum": [
"A_per_C",
"fraction_per_C",
"percent_per_C"
],
"type": "string"
},
"tempCoeffVmpUnit": {
"enum": [
"V_per_C",
"fraction_per_C",
"percent_per_C"
],
"type": "string"
},
"tempCoeffVocUnit": {
"enum": [
"V_per_C",
"fraction_per_C",
"percent_per_C",
"A_per_C"
],
"type": "string"
}
}
},
"inverter": {
"type": "object",
"required": [
"maxDcVoltage",
"mpptMin",
"mpptMax"
],
"properties": {
"mpptMax": {
"type": "number",
"exclusiveMinimum": 0
},
"mpptMin": {
"type": "number",
"exclusiveMinimum": 0
},
"maxDcVoltage": {
"type": "number",
"exclusiveMinimum": 0
},
"maxIscPerMppt": {
"anyOf": [
{
"type": "number",
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"maxInputCurrentPerMppt": {
"type": "number",
"exclusiveMinimum": 0
}
}
}
}
}Combine individual loss percentages into a total system loss using PVWatts multiplicative derating, with optional defaults for missing categories. Price $0.01 USDC. POST /api/v1/solar-design/system-loss-stack. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| losses | object | |
| useDefaultsForMissing | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"losses": {
"type": "object",
"default": {},
"propertyNames": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"additionalProperties": {
"type": "number",
"maximum": 100,
"minimum": 0
}
},
"useDefaultsForMissing": {
"type": "boolean",
"default": true
}
}
}Compute bill savings from caller interval generation and load under a time-of-use tariff with export credit, net metering or no export value. Price $0.03 USDC. POST /api/v1/solar-design/tariff-savings. An unpaid call returns the x402 payment terms and does not run.
| Argument | Type | Description |
|---|---|---|
| loadKwh* | array | |
| exportMode | string | |
| exportPrice | number | |
| importPrice* | array | |
| demandCharge | any | |
| fixedCharges | number | |
| generationKwh* | array | |
| intervalHours | number | |
| billingPeriods | array |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"loadKwh",
"generationKwh",
"importPrice"
],
"properties": {
"loadKwh": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 105408,
"minItems": 1
},
"exportMode": {
"enum": [
"export_rate",
"net_metering_kwh",
"none"
],
"type": "string",
"default": "export_rate"
},
"exportPrice": {
"type": "number",
"default": 0,
"minimum": 0
},
"importPrice": {
"type": "array",
"items": {
"type": "number"
},
"maxItems": 105408,
"minItems": 1
},
"demandCharge": {
"anyOf": [
{
"type": "object",
"required": [
"pricePerKw"
],
"properties": {
"window": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"maxItems": 105408,
"minItems": 1
},
"pricePerKw": {
"type": "number",
"minimum": 0
}
}
},
{
"type": "null"
}
]
},
"fixedCharges": {
"type": "number",
"default": 0,
"minimum": 0
},
"generationKwh": {
"type": "array",
"items": {
"type": "number",
"minimum": 0
},
"maxItems": 105408,
"minItems": 1
},
"intervalHours": {
"type": "number",
"default": 1,
"exclusiveMinimum": 0
},
"billingPeriods": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.
No readOnlyHint / destructiveHint annotations, so clients can't tell a read from a write without asking.
Fix: Add annotations to each tool, e.g. { readOnlyHint: true } for tools that only read.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"capex",
"year1EnergyKwh",
"energyValuePerKwh",
"years",
"discountRate"
],
"properties": {
"capex": {
"type": "number",
"exclusiveMinimum": 0
},
"years": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"omPerYear": {
"type": "number",
"default": 0,
"minimum": 0
},
"degradation": {
"type": "number",
"default": 0.005,
"maximum": 1,
"minimum": -0.5
},
"discountRate": {
"type": "number",
"maximum": 1,
"minimum": -0.5
},
"omEscalation": {
"type": "number",
"default": 0.02,
"maximum": 1,
"minimum": -0.5
},
"year1EnergyKwh": {
"type": "number",
"exclusiveMinimum": 0
},
"energyEscalation": {
"type": "number",
"default": 0.02,
"maximum": 1,
"minimum": -0.5
},
"energyValuePerKwh": {
"type": "number"
},
"upfrontIncentives": {
"type": "number",
"default": 0,
"minimum": 0
}
}
}| temperatureC |
| number |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"latitude",
"longitude",
"tilt",
"azimuth",
"records"
],
"properties": {
"tilt": {
"type": "number",
"maximum": 90,
"minimum": 0
},
"model": {
"enum": [
"isotropic",
"haydavies",
"perez"
],
"type": "string",
"default": "perez"
},
"albedo": {
"type": "number",
"default": 0.2,
"maximum": 1,
"minimum": 0
},
"deltaT": {
"type": "number",
"default": 67
},
"azimuth": {
"type": "number",
"maximum": 360,
"minimum": 0
},
"records": {
"type": "array",
"items": {
"type": "object",
"required": [
"time",
"ghi",
"dni",
"dhi"
],
"properties": {
"dhi": {
"type": "number",
"minimum": 0
},
"dni": {
"type": "number",
"minimum": 0
},
"ghi": {
"type": "number",
"minimum": 0
},
"time": {
"type": "string",
"maxLength": 64,
"minLength": 1
}
}
},
"maxItems": 105408,
"minItems": 1
},
"latitude": {
"type": "number",
"maximum": 90,
"minimum": -90
},
"elevation": {
"type": "number",
"default": 0
},
"longitude": {
"type": "number",
"maximum": 180,
"minimum": -180
},
"pressurePa": {
"type": "number",
"default": 101325,
"exclusiveMinimum": 0
},
"temperatureC": {
"type": "number",
"default": 12
}
}
}