Find the greenest times
octopus_find_greener_slotsFind lower-carbon electricity times over the next 48 hours, compare tariff prices, and choose continuous blocks or half-hour slots for planned usage.
Instructions
Find the lowest-carbon times to use electricity in your region over the next 48 hours, from the official regional carbon intensity forecast of NESO (Great Britain's electricity system operator, api.carbonintensity.org.uk), alongside your tariff's prices: the greenest continuous block of a given length, runner-up blocks, the greenest half-hours, the cheapest block for comparison, and the intensity now. Intensity is grams of CO2 per kWh of electricity generated in the region (a forecast), with NESO's index from very low to very high. The region comes from the tariff, or from region or postcode on their own (then without prices). Choose the tariff by tariff_code, by product_code with region or postcode, or leave them out for the account's current tariff. Northern Ireland isn't covered.
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": "octopus_find_greener_slots"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | Latest end: a date and time, or a date (inclusive; default as far as the forecast goes, about 48 hours ahead) | |
| kwh | No | Energy the job will use, in kWh, to estimate its emissions (and cost, when prices are known) in each block | |
| from | No | Earliest start: a date and time, or now (default now) | |
| fuel | No | electricity (default) or gas | |
| slots | No | Also list this many of the lowest-carbon individual half-hours (default 6; 0 for none) | |
| 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 | |
| direction | No | With the account's tariff: import (default) or export | |
| 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) | |
| duration_hours | No | Length of the continuous block to find, in hours, in steps of 0.5 (default 2) |