tariff_unit_rates
Pack: octopus-energy · Endpoint: https://gateway.pipeworx.io/octopus-energy/mcp
Time-series of electricity unit rates for a specific tariff — for Agile this is the half-hourly wholesale-tracked pricing. Returns {count, results:[{value_exc_vat, value_inc_vat, valid_from, valid_to, payment_method}]} in p/kWh, newest first. Set kind=“standing_charges” for the p/day standing charge instead. Defaults to the most recent rates; pass period_from/period_to to bound a window.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
productCode | string | yes | Product code, e.g. “AGILE-24-10-01”. |
tariffCode | string | yes | Tariff code from product_details, e.g. “E-1R-AGILE-24-10-01-C” (the trailing letter is the GSP region). |
kind | string | no | Which series to fetch. Default “standard_unit_rates”. |
period_from | string | no | ISO-8601 start, e.g. “2026-06-01T00:00Z”. |
period_to | string | no | ISO-8601 end, e.g. “2026-06-02T00:00Z”. |
page_size | number | no | Results per page (default 100, max 1500). |
Example call
curl -X POST https://gateway.pipeworx.io/octopus-energy/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"tariff_unit_rates","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"octopus-energy": {
"url": "https://gateway.pipeworx.io/octopus-energy/mcp"
}
}
}See Getting Started for client-specific install steps.