Home battery payback estimate
calculate_paybackYearly saving and simple payback time of a home battery in the UK, from the user's own figures. Same model as the calculator on batterypayback.co.uk. Rates in pence per kWh.
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": {
"annual_use_kwh": "<annual_use_kwh>",
"battery_usable_kwh": "<battery_usable_kwh>",
"battery_price_gbp": "<battery_price_gbp>",
"peak_rate_p": "<peak_rate_p>"
},
"name": "calculate_payback"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| loan_rate | No | Optional yearly loan interest rate, 0-0.5 (charged monthly). | |
| loan_years | No | Optional loan term in years (with loan_rate). | |
| peak_rate_p | Yes | Normal or peak unit rate, p/kWh. | |
| cheap_rate_p | No | Cheap-hours rate, p/kWh. Omit for a single-rate tariff. | |
| daytime_share | No | Share of use between 8am and 4pm, 0-1. Default: the measured London profile (about 0.34, Low Carbon London smart meters). | |
| export_rate_p | No | Export (SEG) rate, p/kWh. Default 0. | |
| annual_use_kwh | Yes | ||
| charge_power_kw | No | Optional battery charging power, kW. With cheap_window_hours it caps grid charging at power x hours a night. | |
| charge_from_grid | No | Fill the battery at the cheap rate. Default true. | |
| battery_price_gbp | Yes | Installed price. | |
| cheap_hours_share | No | Share of use already in cheap-rate hours, 0-1. Default 0. | |
| battery_usable_kwh | Yes | ||
| cheap_window_hours | No | Optional length of the cheap-rate window, hours. | |
| solar_kwh_per_year | No | Yearly solar generation. 0 = no panels. | |
| round_trip_efficiency | No | 0-1, from the datasheet. Default 0.9 (assumption). | |
| yearly_saving_decline | No | Optional yearly reduction of the saving, 0-0.2. | |
| shiftable_evening_share | No | Optional share (0-1) of evening use the household moves to cheap hours itself, without a battery. The saving is then only what the battery adds on top. |