Wattpath solar energy-balance estimate
size_solarUse when you need solar energy arithmetic from supplied assumptions; see Data APIs. Off-grid PV energy-balance estimate based on Wattpath by Nomad Energy Club. Supply daily loads, peak sun hours, PV losses, and optional battery assumptions. No location/weather lookup, electrical design, surge or installation certification. $0.02 per calculation; no stored inputs. Price: 0.02 USDC. Minimal input example: {"loads":[{"watts":100,"hours_per_day":5,"quantity":1,"kind":"dc"}],"peak_sun_hours":4,"pv_loss_fraction":0.2,"panel_watts":200,"battery":{"voltage":12,"usable_fraction":0.8,"autonomy_days":2}}. Illustrative output excerpt: {"daily_energy_wh":{"battery_side":400},"pv":{"minimum_nameplate_watts":125,"rounded_up_watts":125},"assumptions":{"energy_balance_only":true,"weather_or_location_lookup":false}}. Illustrative output excerpt, not a live result, signature, approval or guarantee. Freshness/data/availability checks still apply. How to pay (MCP): First use the existing shared allowance of 3 eligible calls per IP per UTC day, without payment metadata. This is shared with eligible HTTP trials, not a new allowance. Use an x402-capable MCP client. A generic MCP connector without payment support cannot complete a paid continuation. On payment required, STOP. Inspect the exact accepts amount, asset, network and payTo; obtain explicit wallet/budget approval before continuing. Only after approval, let the configured x402 MCP client attach its signed payload in _meta["x402/payment"] and retry the same tools/call arguments. Never send a separate USDC transfer or paste keys into tool arguments. Never silently fall back from free access to payment. If a signed attempt has an unknown outcome, inspect that authorization/transaction; do not create another automatically.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"loads": "<loads>",
"peak_sun_hours": "<peak_sun_hours>",
"pv_loss_fraction": "<pv_loss_fraction>"
},
"name": "size_solar"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loads | Yes | Required. Array of 1–50 load objects describing watts, hours_per_day, quantity and ac/dc kind. Example: [{"watts":60,"hours_per_day":4,"quantity":1,"kind":"dc"}]. | |
| battery | No | Optional. Battery assumptions object. Example: {"voltage":12,"usable_fraction":0.8,"autonomy_days":2}. Omit to skip battery sizing. | |
| panel_watts | No | Optional. Individual panel rated power number in watts, 1–2000. Example: 400. Supply to estimate panel count. | |
| peak_sun_hours | Yes | Required. Equivalent daily full-sun hours number, 0.01–24 for a usable estimate. Example: 4.5. Supply your own site assumption; no weather lookup. | |
| pv_loss_fraction | Yes | Required. PV loss fraction number, 0–0.95, not a percentage. Example: 0.2 means 20% loss. | |
| inverter_efficiency | No | Optional. Inverter efficiency fraction number, 0.1–1. Example: 0.9 means 90%. Required when any load has kind ac; otherwise optional. |