Tako MCP

🚀 tako-mcp

The MCP server for the GraphQL API of Octopus Energy Japan.

This server allows you to obtain electricity usage, cost estimates, contract information, and tariff plans via the MCP tool. It can be utilized for energy usage analysis with LLMs such as Claude.

✨ Features

• Obtain electricity consumption and cost estimates in 30 - minute intervals.
• Retrieve account and contract information (including products and basic charges).
• Search for area information by postal code.
• Privacy - focused: Personal information such as addresses is excluded from tool responses.

📦 Installation

Prerequisites

• Node.js 22+
• An Octopus Energy Japan account (email and password)

💻 Usage Examples

Basic Usage

By default, it operates with stdio transport.

OCTOPUS_EMAIL=you@example.com OCTOPUS_PASSWORD=your-password OCTOPUS_ACCOUNT_NUMBER=A-AAAA1111 npx tako-mcp

Advanced Usage (HTTP Mode)

You can switch to Streamable HTTP transport with the --http flag.

OCTOPUS_EMAIL=you@example.com OCTOPUS_PASSWORD=your-password OCTOPUS_ACCOUNT_NUMBER=A-AAAA1111 npx tako-mcp --http

If PORT is not specified, an available port will be automatically selected.

Environment Variables

📚 Documentation

MCP Tool List

Client Configuration

Claude Desktop / Claude Code

{
  "mcpServers": {
    "tako-mcp": {
      "command": "npx",
      "args": ["-y", "tako-mcp"],
      "env": {
        "OCTOPUS_EMAIL": "you@example.com",
        "OCTOPUS_PASSWORD": "your-password",
        "OCTOPUS_ACCOUNT_NUMBER": "A-AAAA1111"
      }
    }
  }
}

HTTP Mode

{
  "mcpServers": {
    "tako-mcp": {
      "type": "http",
      "url": "http://localhost:<port>/mcp"
    }
  }
}

🔧 Technical Details

Development

npm install
npm run dev        # Start with tsx
npm run build      # Bundle with tsup
npm run typecheck  # Type checking
npm run check      # Lint & format (Biome)

📄 License

MIT