Plan a roof (solar roof check)
plan_roofPlan solar modules on a house's roof from the Bavarian 3D building model, the aerial photo and the laser scan, exactly as Sky Solar's solar roof check page does: modules, kWp, kWh a year with measured weather, shade loss and self-use with and without a battery, each roof face with tilt and direction, the obstacles found, money a year at public rates (own use and feed-in) for a choice of battery sizes (none, or 4 to 20 kWh; any whole kWh in between on request), the municipal subsidy, the price guide ("from" and a recommendation, only inside Sky Solar's service area) and the payback (on the person's own offer price, else on the guide's recommendation), kWh month by month and per face, the worst shade casters, questions about unsure spots for the person and what else to ask them, notes on likely model errors, and a solar roof check link that opens this plan in 3D for the person to check, change and send an enquiry from. On a new plan (house) where the aerial photo speaks against the roof's outline, the AI outline check runs by itself, as on the page: "applied" says what it changed. A link is read as it is; "notes" says when the outline may still be wrong. Give house (from find_house) for a new plan, or link to read and explain a plan the person already has. Pass the person's answers to the questions with answers. Works outside Sky Solar's service area too and says so. An example, not a quote; the only prices are the report's price guide (price_guide: "from" and a recommendation, a rough guide, never an offer), and the payback counts the person's own offer or, without one, that recommendation.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "plan_roof"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ev | No | An electric car is (or will be) charged at home: by default 15,000 km a year, about 2,955 kWh, charged in the evening (edit_roof device sets km, when and how fast). | |
| link | No | A solar roof check link (https://pv.skysolar.de/dachcheck/#d=…), as plan_roof, edit_roof or the solar roof check page gave it. | |
| house | No | The house id from find_house ("musterhaus" is the example house). | |
| answers | No | The person's answers to the last answer's "questions". | |
| geometry | No | true: add a complete geometry snapshot to the answer (the default stays short): for every face and dormer roof its outline, size, usable box and the eave and slope axes (with compass bearings), every module with its face, position in the face's own metres and orientation, the module fields (rows × columns), and the obstacles with their outlines and clearances. Everything in the same metres the edits take. | |
| heat_pump | No | A heat pump heats the house: by default about 4,500 kWh a year, mostly in winter (edit_roof device sets the person's own figure). | |
| offer_eur | No | The total price on an offer the person already has, euros before any subsidy (0 clears it): the payback then counts it. Without one the payback counts the price guide's recommendation (summary.price_guide). Never pass a price of Sky Solar's as an offer. | |
| roof_step | No | How demanding the roof is for the price guide: "simple" (one field, plain tiles), "normal", "complex" (several directions, many small fields, Biberschwanz tiles); "auto" (the default) works it out from the plan. Changes the price guide only. | |
| optimizers | No | The person wants module optimizers: they are in both prices of the price guide. Without them the recommendation adds them anyway where the plan shows shade or several directions. | |
| battery_kwh | No | Battery size, kWh: 0 for none, or a whole number from 4 to 20 (default 8). | |
| backup_power | No | The person wants backup power (Notstrom): it is in both prices of the price guide. | |
| battery_type | No | The battery's type, both DC-coupled hybrid systems: "nv5" (low voltage, the default) charges and discharges at most 5 kW whatever its size; "hv1c" (high voltage) at most 1C, as many kW as it has kWh (10 kWh: 10 kW, 4 kWh: only 4 kW). Only with a battery. It matters at peaks: an e-car charging at more than 5 kW; a household on its own comes out nearly the same with both, with a heat pump too. | |
| consumption_kwh | No | The household's electricity use a year, kWh, without car or heat pump (default 4,500). |