Obtain your API key from the Octopus Energy developer dashboard; authenticate using HTTP Basic Auth with the API key as the username and an empty password on all requests.
Retrieve product and tariff information via GET https://api.octopus.energy/v1/products/<PRODUCT_CODE>/electricity-tariffs/<TARIFF_CODE>/standard-unit-rates/ for standard unit rates, or /standing-charges/ for daily standing charges; these endpoints are public and require no authentication.
For Agile or time-of-use tariffs, query the unit rates endpoint with from and to date parameters to retrieve half-hourly price slots in p/kWh for a given period.
To access a customer's consumption data, authenticate with the customer's API key and call GET /v1/electricity-meter-points/<MPAN>/meters/<SERIAL_NUMBER>/consumption/ with page_size and period_from/period_to parameters for half-hourly interval consumption.
Handle pagination using the 'next' URL in the response envelope; Octopus returns data in pages and the most recent data appears on later pages — process pages in order and track the last retrieved timestamp for incremental updates.
Known gotchas
Octopus API consumption data is returned in reverse chronological order by default (most recent first); consumers who assume forward chronological order and do not sort or reverse the results will process data in the wrong sequence.
Agile Octopus prices for the next day are published around 16:00 UK time; querying future slots before publication returns either an empty array or only the current day's slots — schedule next-day price fetches after 16:30 UK local time.
MPAN (meter point) and serial number are both required to identify a specific meter; customers can have multiple meters (import and export) under a single account — enumerate meters carefully and confirm whether you need import, export, or both for your use case.
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp