MCP-kehittäjille

Yhdistä Sähköhaku AI-avustajaan

Sähköhaku tarjoaa yhden julkisen MCP-työkalun sähkösopimusten vertailupalvelujen ja sähkömyyjien löytämiseen Suomessa.

Endpoint

https://sahkohaku.com/mcp

Transport: Streamable HTTP. Autentikointia ei vaadita. Palvelu tukee MCP SDK:n nykyistä stateless-protokollaa sekä yhteensopivia aiempia asiakkaita.

Työkalu: find_electricity_offers

Työkalu hakee postinumeron perusteella Energiavirastolle ilmoitetut kotitalouksien sopimukset. Se laskee yksinkertaisille kiinteähintaisille sopimuksille arvioidun ensimmäisen vuoden energiamaksun ja näyttää pörssisopimuksen marginaalin sekä kuukausimaksun. Hybridi-, aika- ja tarjoushintojen vertailuun tarvitaan tarkemmat kulutustiedot, joten niitä ei välttämättä näytetä laskennallisessa järjestyksessä.

{
  "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
}

Vuosikulutus ja suomalainen postinumero tarvitaan. Nykyisen sopimuksen energiamaksun vertailuun anna myös sen snt/kWh-hinta ja kuukausimaksu. Vuosihinta-arvio ei sisällä siirtoa eikä sähköveroa. Hinnat käytetään lähteen tai käyttäjän ilmoittamassa ALV-käsittelyssä, eikä ALV:tä lisätä tai poisteta. Pörssisähkön tulevaa hintaa ei ennusteta. Markkinatuloksen tuotteet linkittävät myyjien ilmoittamiin ehtoihin; koko markkinan vertailuun voit avata myös Energiaviraston vertailupalvelun.

Vastauksen status

ok: markkinatiedot haettiin.
needs_input: vuosikulutus tai postinumero puuttuu.
invalid_input: syöte sisältää arvorajan tai keskinäisen johdonmukaisuuden virheen.
data_unavailable: Energiaviraston markkinadataa ei saatu haettua.
no_match: sopivaa kumppania ei löytynyt.

Rajaukset

Työkalu palauttaa kulutukselle sopivat tuotteet ja linkit sallittujen sähköyhtiöiden sivuille. Kuluttajille tarkoitettu vertailu löytyy etusivulta.

Tietosuoja ja rajoitukset

Syötteitä ei tallenneta Sähköhaun tietokantaan, eikä tietokantaa tai käyttäjätilejä ole. MCP-pyynnön kokoraja on 16 KiB. Rate limit: 30 MCP-pyyntöä ja 60 redirectiä minuutissa per IP-hajautetun avaimen perusteella. Virheelliset partneritunnisteet eivät koskaan hyväksy käyttäjän antamaa kohde-URL:ää. Tuntemattomat työkalukentät hylätään.

Älä lähetä nimeä, tarkkaa osoitetta tai muita tarpeettomia henkilötietoja.

Paikallinen käyttö

Katso asennus, paikallinen Worker-esimerkki ja testikomennot repositorion README-tiedostosta.