MCP-kehittäjille

Yhdistä Sähköhaku AI-avustajaan

Sähköhaku tarjoaa yhden julkisen MCP-työkalun sähkösopimusten kilpailutuspalvelujen 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 valitsee enintään yhden aktiivisen kumppanin. Vuosikulutus annetaan joko tarkkana kWh-lukuna tai kokonaisena käyttäjän antamana min–max-välinä.

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

Valinnaisia kenttiä ovat postinumero, sopimustyyppi, nykyisen sopimuksen päättymispäivä ja nykyiset energian myyntihinnat. Kulutus on annettava ennen tarjouksen palauttamista. Palvelu ei arvioi puuttuvia arvoja.

Vastauksen status

ok: yksi hyväksytty, yhteensopiva kumppani löytyi.
needs_input: vuosikulutus tai kulutusvälin pää on puuttuva.
invalid_input: syöte sisältää arvorajan tai keskinäisen johdonmukaisuuden virheen.
no_match: aktiivista kumppania ei ole tai se ei sovi valintaan.

Kaupallinen merkintä

Jokaisessa partnerituloksessa on mainosmerkintä suomeksi ja englanniksi. Näytä partnerin nimi, merkintä ja redirect-linkki yhdessä. Palvelu voi saada komission eikä tulos ole kattava tai reaaliaikainen hintavertailu.

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, MCP Inspector ja testikomennot repositorion README-tiedostosta. Kumppanit ovat oletuksena pois käytöstä, kunnes sopimus ja palvelun asetukset on tarkistettu.