Skip to main content
Glama
Sign In
oegb-kraken-mcp

oegb-kraken-mcp

by marcospaegle
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

oegb-kraken-mcp

A read-only MCP server for the Octopus Energy Kraken REST API (https://api.oegb-kraken.energy/v1, docs). It lets AI agents look up tariffs, half-hourly prices, account details and smart-meter consumption. It only sends GET requests.

Tools

Tool

What it does

API key

list_products

List products (Agile, Go, Flexible…)

no

get_product

Product details and regional tariff codes

no

get_tariff_rates

Unit rates, day/night rates, standing charges

no

get_account

Account, meter points (MPAN/MPRN), meter serials, tariff agreements

yes

get_consumption

Electricity/gas consumption, optionally grouped by day/week/month/quarter

yes

Related MCP server: shelly-api-mcp

API key

Account and consumption data need your personal API key. Find it in your Octopus account under Personal details → API access. Set it as OCTOPUS_API_KEY. The key stays on your machine and is sent only to the Kraken API.

Install

Requires Node.js 18+.

Claude Code

claude mcp add oegb-kraken -e OCTOPUS_API_KEY=sk_live_xxx -- npx -y oegb-kraken-mcp

Claude Desktop (claude_desktop_config.json) and other MCP clients:

{
  "mcpServers": {
    "oegb-kraken": {
      "command": "npx",
      "args": ["-y", "oegb-kraken-mcp"],
      "env": { "OCTOPUS_API_KEY": "sk_live_xxx" }
    }
  }
}

The products and prices tools work without a key. Leave env out if you only need those.

Optional: OCTOPUS_API_BASE_URL overrides the API base URL (default https://api.oegb-kraken.energy/v1).

Example prompts

  • "What are the Agile prices for region C tonight?"

  • "How much electricity did I use per day last week on account A-1234ABCD?"

Development

npm install
npm run build
npx @modelcontextprotocol/inspector node dist/index.js

This repo's .mcp.json runs the local build in Claude Code, using OCTOPUS_API_KEY from your shell.

Publish with npm publish. prepublishOnly builds first, and only dist/ is shipped.

Available Tools

5 tools
get_accountGet account detailsA
Read-onlyIdempotent

Get an Octopus Energy account by account number (e.g. A-1234ABCD). Needs OCTOPUS_API_KEY. Returns properties with electricity meter points (MPAN, meter serial numbers) and gas meter points (MPRN, serials), plus tariff agreements (tariff_code, valid_from/valid_to). Use these with get_consumption and get_tariff_rates.

Inputs: account_number (required).

get_consumptionGet meter consumptionA
Read-onlyIdempotent

Get smart-meter consumption for an electricity meter (MPAN + serial) or gas meter (MPRN + serial). Needs OCTOPUS_API_KEY. Half-hourly by default. Electricity is in kWh. Gas is in kWh for SMETS1 and m³ for SMETS2. Use group_by to aggregate, and order_by=period for oldest first (default is newest first). Get the identifiers from get_account.

Inputs: fuel (required), meter_point (required), serial_number (required), page, +5 more.

get_productGet product detailsA
Read-onlyIdempotent

Get one product and its tariffs by product code (e.g. AGILE-FLEX-22-11-25). Public. The response lists tariff codes per region (single_register_electricity_tariffs, dual_register_electricity_tariffs, single_register_gas_tariffs), keyed by GSP region like _A ... _P. Use those tariff codes with get_tariff_rates.

Inputs: product_code (required), tariffs_active_at.

get_tariff_ratesGet tariff rates or standing chargesA
Read-onlyIdempotent

Get unit rates or standing charges for a tariff, e.g. half-hourly Agile prices. Public. Prices are in pence, with value_exc_vat and value_inc_vat. Use day-unit-rates / night-unit-rates only for Economy 7 (E-2R-...) tariffs. Results are newest first. Narrow with period_from / period_to.

Inputs: fuel (required), rate_type (required), tariff_code (required), product_code (required), +4 more.

list_productsList energy productsA
Read-onlyIdempotent

List Octopus Energy products (tariff families such as Agile, Go, Flexible). Public, no API key needed. Returns product codes to use with get_product.

Inputs: page, brand, is_green, is_prepay, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A4.2/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct resource/action: product listing, product lookup, tariff rates, consumption, and account lookup. The descriptions explicitly cross-reference which tool feeds which (e.g. product codes to get_product, tariff codes to get_tariff_rates), leaving no meaningful overlap. An agent can select the right tool from the name alone.

    Naming Consistency5/5

    All names follow a clean snake_case verb_noun pattern: list_products, get_product, get_consumption, get_tariff_rates, get_account. The lone 'list' prefix is semantically appropriate for a collection endpoint, not an inconsistency.

    Tool Count5/5

    Five tools is well-scoped for a read-only Octopus Energy API surface: discovery, product detail, rates, account, and consumption. No tool feels redundant or extraneous, and nothing essential is obviously missing at this scope.

    Completeness4/5

    The lifecycle for reading products, tariffs, accounts, and consumption is covered with clear chaining via identifiers. Minor gaps exist: no standalone get_tariff metadata tool, no account listing/search to discover account numbers, and no meter-point lookup—though these are workaroundable and likely outside the intended read-only scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • Octopus Energy MCP Server

      darronz
      A
      license
      A
      quality
      D
      maintenance
      Enables retrieval of electricity and gas consumption data from Octopus Energy accounts through their API, with support for date range filtering, pagination, and grouping by time periods.
      2
      1
      ISC

    • shelly-api-mcp

      adambenhassen
      F
      license
      Not graded
      quality
      C
      maintenance
      Provides read-only access to Shelly Cloud energy data, including live power, lifetime energy, and historical consumption with cost, enabling AI agents to monitor electricity usage without device control.
      1
      -

    • mcp-octopus-energy

      pipeworx-io
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query UK energy tariffs and products via the Octopus Energy public API.
      619 npm
      MIT

    • Octopus Deploy Official MCP

      Ananya0553
      A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI assistants to inspect, query, and diagnose deployments, releases, runbooks, tasks, tenants, and infrastructure inside an Octopus instance through its APIs. Supports read-only and write-gated modes, toolset selection, and structured REST access for both interactive use and automation.
      501 npm
      MIT