Suomiatlas MCP-palvelin

MCP (Model Context Protocol) -palvelin, jonka kautta tekoälyavustaja voi kysyä Suomiatlaksen dataa suoraan: "kuinka monta ihmistä asuu Toukolassa?", "paljonko asunto maksaa Töölössä?", "onko ilma puhdasta Vantaalla?". Data kattaa noin 3000 postinumeroaluetta ja 308 kuntaa.

Yhdistä ilman asennusta

Palvelin on käytettävissä osoitteessa https://suomiatlas.com/api/mcp Streamable HTTP -yhteydellä. Claude Codessa riittää yksi komento; muissa asiakasohjelmissa lisää sama osoite HTTP-tyyppisenä palvelimena.

--header-rivi on valinnainen. Ilman sitä saat ilmaisversion, joka vastaa kaikkiin yllä mainittuihin kysymyksiin; avaimella käytössäsi on tilisi Pro-sisältö tai aluepassi.

claude mcp add --transport http suomiatlas https://suomiatlas.com/api/mcp \
  --header "Authorization: Bearer sk_live_..."

Muut asiakasohjelmat

Jos asiakasohjelmassa ei ole komentoa palvelimen lisäämiseen, lisää sama osoite käsin asetustiedostoon HTTP-tyyppisenä palvelimena.

Authorization-rivi on valinnainen: ilman sitä käytössä on ilmaisversio.

{
  "mcpServers": {
    "suomiatlas": {
      "type": "http",
      "url": "https://suomiatlas.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_live_..." }
    }
  }
}

API-avain

Luo avain kirjautuneena Suomiatlaksessa kohdasta API-avaimet. Avain näytetään kerran; sen jälkeen näet vain alkuosan. Voit mitätöidä avaimen milloin tahansa.

Avain kulkee aina Authorization-otsakkeessa, ei evästeessä. Sillä pääsee lukemaan tilisi Pro-sisältöä, mutta sillä ei voi luoda tai mitätöidä avaimia eikä muuttaa tiliä.

curl -X POST https://suomiatlas.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer sk_live_...' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Mitä ilmaisversio jättää pois

Kun jokin tieto on maksumuurin takana, vastauksessa on locked-kenttä joka kertoo mikä puuttuu ja miksi. Tieto on olemassa — sitä ei vain palauteta. Avustaja osaa näin sanoa "tämä vaatii Pron" sen sijaan että väittäisi dataa puuttuvaksi tai kuvaisi kolmen vuoden pätkää koko kehityksenä.

{
  "summary": "Espoo: latest median sale prices - Two-room apartment: 3718 EUR/m2 (2025).",
  "data": { "latestHousingPrices": [ ... ] },
  "tier": "free",
  "locked": [
    {
      "field": "housingPriceSeries",
      "reason": "Housing price history for a municipality requires a Suomiatlas Pro subscription. The data exists - it is withheld, not missing.",
      "upgrade": "https://suomiatlas.com/hinnat"
    }
  ]
}

Työkalut

Työkalu	Mihin vastaa
`search_places`	nimen tunnistus koodiksi — "mitä Töölöä tarkoitat?"
`get_place_stats`	"kuinka monta asuu Toukolassa tai Akaassa?", "paljonko asunto maksaa Töölössä?"
`get_place_history`	"ovatko asuntojen hinnat nousseet Espoossa?" — aikasarja, laskettu suunta ja alueen 1/5/10 vuoden kehitysmittarit
`get_air_quality`	"onko ilma puhdasta Vantaalla?" — mitatut arvot WHO- ja EU-rajoihin verrattuna
`compare_areas`	jopa 12 postinumeroalueen vertailu rinnakkain
`rank_areas`	"missä Suomessa on korkeimmat tulot?" — koko maa, kunta tai maakunta
`find_similar_areas`	"missä muualla on samanlaista kuin täällä?"
`list_variables`	mittarien luettelo ja kunkin mittarin vuodet
`get_area_report`	PDF-raportin latauslinkki yhdelle postinumeroalueelle (vaatii Pron tai aluepassin)

Ilmainen ja Pro

Ominaisuus	Ilmainen	Pro
Väkiluku, tulot, koulutus, työllisyys	kaikki	kaikki
Asuntojen hinnat (uusin vuosi)	kyllä	kyllä
Rikollisuus ja ilmanlaatu	kyllä	kyllä
Historia	3 vuotta	koko aineisto (2010–)
Asuntojen hintakehitys	ei	koko aikasarja (2009–)
Sijoituslistat	10 riviä	100 riviä
Alueiden vertailu	2 aluetta	12 aluetta
Yhdistelmäpisteiden erittely	vain kokonaispisteet	kaikki osatekijät

Data on CC BY 4.0 -lisenssillä. Lähteet: Tilastokeskus (Paavo, rikollisuus, asuntojen kauppahinnat) ja Ilmatieteen laitos (ilmanlaatu). Mainitse alkuperäinen julkaisija kun käytät lukuja.