Solar and export summary
octopus_get_solar_summarySummarize solar import and export costs and earnings from Octopus smart meters over a period, including half-hourly rates and net cost; add inverter generation to calculate self-consumption.
Instructions
Combine a home's electricity import and export smart meters (for solar panels or a battery) over a period: kWh imported and exported, what the imports cost and the exports earned at the actual rate for every half-hour (so Agile Outgoing and other time-of-use export tariffs are priced correctly), standing charges and the net cost, by day, week or month. Octopus has no generation data, so to get self-consumption (generation minus export) and self-sufficiency, pass generated_kwh from your inverter app. Readings are usually a day behind. Estimates exclude discounts and credits; your bill is the source of truth.
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_get_solar_summary"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | End: a date (inclusive, the whole day) or date and time (default the end of yesterday) | |
| from | No | Start: a date (YYYY-MM-DD, UK time) or date and time (default 30 days ago) | |
| limit | No | Return at most this many rows, the most recent (default 100) | |
| group_by | No | How to total the half-hours: day (default), week (Monday to Sunday), month or total | |
| generated_kwh | No | What the panels generated in the whole period, in kWh, from your inverter or generation meter. Octopus doesn't have this, so self-consumption is only worked out when you give it | |
| account_number | No | Account number like A-1234ABCD (default OCTOPUS_ACCOUNT, or the only account the API key can see) | |
| export_meter_point | No | The export MPAN, when the account has several (see octopus_get_account) | |
| import_meter_point | No | The import MPAN, when the account has several (see octopus_get_account) |