`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

Arguments

{
  "productCode": "AGILE-24-10-01",
  "tariffCode": "E-1R-AGILE-24-10-01-C"
}

curl

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":{"productCode":"AGILE-24-10-01","tariffCode":"E-1R-AGILE-24-10-01-C"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('tariff_unit_rates', {
  "productCode": "AGILE-24-10-01",
  "tariffCode": "E-1R-AGILE-24-10-01-C"
});

More examples

{
  "productCode": "AGILE-24-10-01",
  "tariffCode": "E-1R-AGILE-24-10-01-C",
  "kind": "standing_charges",
  "period_from": "2026-06-01T00:00Z",
  "period_to": "2026-06-02T00:00Z"
}

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.

tariff_unit_rates