Plan a charging or heating schedule
octopus_plan_schedulePlan when to charge a home battery, car, or heat pump by spreading required energy across cheap half-hours in a tariff period. Returns start/stop times and compares cost with starting now.
Instructions
Plan when to charge a home battery or car, or run a heat pump, so that a given amount of energy goes in as cheaply as possible on a time-of-use tariff such as Cosy, Flux, Go, Intelligent Go or Agile. Unlike octopus_find_cheapest_slots, which finds one continuous block, this spreads the energy over the cheapest half-hours the device's power allows, across every cheap window in the period, and merges them into start and stop times. Also lists the tariff's price windows over the period (for example Cosy's three cheap windows and its peak) and compares the cost with starting straight away. It only plans; it doesn't change any device. Only uses published prices. Choose the tariff by tariff_code, by product_code with region or postcode, or leave them out for the account's current tariff.
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": {
"energy_kwh": "<energy_kwh>",
"power_kw": "<power_kw>"
},
"name": "octopus_plan_schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | When it must be done by: a date and time, or a date (inclusive; default as far ahead as prices are published) | |
| from | No | Earliest start: a date and time, or now (default now) | |
| fuel | No | electricity (default) or gas | |
| region | No | With product_code: the region letter A to P (see octopus_find_region) | |
| postcode | No | With product_code, instead of region: a UK postcode, used to look up the region | |
| power_kw | Yes | The most the device draws, in kW: the battery's charge rate, the heat pump's input power or the car charger's rating (7 for most home chargers) | |
| direction | No | With the account's tariff: import (default) or export | |
| energy_kwh | Yes | Energy to put in over the period, in kWh: for example 9 to charge a 10 kWh battery from 10% to full, or a heat pump's expected electricity use for the day | |
| tariff_code | No | A tariff code like E-1R-AGILE-24-10-01-C (from octopus_get_product or octopus_get_account) | |
| product_code | No | Instead of tariff_code: a product code like AGILE-24-10-01 (see octopus_list_products), with region or postcode | |
| account_number | No | With none of the above, the account's current tariff is used: account number like A-1234ABCD (default OCTOPUS_ACCOUNT or the only account) |