home / mcp / tako mcp server

Tako MCP Server

Provides 30-minute energy usage estimates, account details, and postal area lookups via MCP for Octopus Energy Japan.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "arrow2nd-tako-mcp": {
      "url": "http://localhost:<port>/mcp",
      "headers": {
        "PORT": "8080",
        "OCTOPUS_EMAIL": "[email protected]",
        "OCTOPUS_PASSWORD": "your-password",
        "OCTOPUS_ACCOUNT_NUMBER": "A-AAAA1111"
      }
    }
  }
}

You can run the Tako MCP Server to access Octopus Energy Japan data through MCP clients. It provides 30-minute electricity consumption and cost estimates, account and contract details, and postal area lookups, helping you analyze energy usage with tools and language models while keeping privacy in mind.

How to use

Use an MCP client to connect to the Tako MCP Server. The server runs in two modes: a local stdio mode that you启动 directly on your machine, and an HTTP mode that exposes a remote endpoint you can query over HTTP. You supply your Octopus Energy Japan credentials and account information, and you can request account details, consumption estimates, and postal area data.

How to install

Prerequisites: Node.js 22 or newer and an Octopus Energy Japan account (email and password). Then install and run the MCP server using the commands below.

Additional sections

Starting with the local stdio configuration, you run the MCP server using npx with your credentials embedded in environment variables. The server defaults to the stdio transport, and you can switch to HTTP mode when you need a remote endpoint.

Development

Development and build steps are provided to install dependencies, run the dev server, build the bundle, and perform checks.

Available tools

get_account_info

Fetches account and contract information, including products and basic charges, while excluding personal address data.

get_electricity_consumption

Retrieves 30-minute interval electricity consumption and cost estimates.

get_postal_areas

Searches area information by postal code.