For MCP developers

Connect Sähköhaku to an AI assistant

Sähköhaku exposes one public MCP tool for discovering electricity comparison services and suppliers in Finland.

Endpoint

https://sahkohaku.com/mcp

Transport: Streamable HTTP. No authentication is required. The service supports the current stateless protocol in the MCP SDK and compatible earlier clients.

Tool: find_electricity_offers

The tool looks up household contracts reported to Finland's Energy Authority for the supplied postal code. It estimates first-year energy cost for simple fixed-price plans and shows the supplier margin and monthly fee for spot plans. Hybrid, time-of-use, and promotional plans may be omitted from the numeric ranking because they need more detailed consumption data.

{
  "annual_consumption": { "exact_kwh": 12000 },
  "postal_code": "60100",
  "contract_type": "fixed",
  "contract_end_date": "2026-12-19",
  "current_price_cents_per_kwh": 9.29,
  "current_monthly_base_fee_eur": 3.99
}

Annual consumption and a Finnish postal code are required. To compare the energy charge on a current contract, also provide its c/kWh rate and monthly fee. Annual estimates exclude distribution and electricity tax; prices retain their supplied VAT basis; future spot prices are not predicted. Products link to the suppliers' reported terms. For a complete market comparison, open the Energy Authority's comparison service.

Response status

ok: market data was retrieved.
needs_input: annual consumption or postal code is missing.
invalid_input: an input value is out of bounds or inconsistent.
data_unavailable: Energy Authority market data could not be retrieved.
no_match: no compatible partner was found.

Scope

The tool returns matching products and links to the selected suppliers. The consumer comparison is on the Finnish homepage.

Privacy and limits

Inputs are not stored in a Sähköhaku database; the service has no database or user accounts. MCP requests are limited to 16 KiB. Rate limits are 30 MCP requests and 60 redirects per minute using a hashed IP-based key. Invalid partner IDs never accept a user-provided destination URL. Unknown tool fields are rejected.

Do not send names, full addresses, or other unnecessary personal information.

Run locally

See the repository README for setup, the local Worker example, and test commands.