Suomiatlas MCP-server

En MCP-server (Model Context Protocol) som låter en AI-assistent fråga Suomiatlas direkt: "hur många bor i Toukola?", "vad kostar en lägenhet i Tölö?", "är luften ren i Vanda?". Omfattar ca 3000 finska postnummerområden och alla 308 kommuner.

Anslut utan installation

Servern finns på https://suomiatlas.com/api/mcp via Streamable HTTP. I Claude Code räcker ett kommando; i andra klienter lägger du till samma adress som en MCP-server av HTTP-typ.

Raden --header är valfri. Utan den får du gratisversionen, som svarar på alla frågor ovan; med en nyckel får du kontots Pro-innehåll eller områdespass.

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

Andra klienter

Om klienten saknar ett kommando för att lägga till servern anger du samma adress manuellt i konfigurationsfilen som en MCP-server av HTTP-typ.

Authorization-raden är valfri — utan den får du gratisversionen.

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

API-nycklar

Skapa en nyckel när du är inloggad i Suomiatlas, under API-nycklar. Den visas en gång; därefter ser du bara dess början. Du kan återkalla den när som helst.

Nycklar skickas alltid i Authorization-huvudet, aldrig i en cookie. En nyckel kan läsa ditt kontos Pro-innehåll, men kan varken skapa eller återkalla nycklar eller ändra kontot.

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

Vad gratisversionen håller tillbaka

När något ligger bakom betalväggen innehåller svaret ett locked-fält som anger vad som saknas och varför. Datan finns — den returneras bara inte. Då kan assistenten säga "detta kräver Pro" i stället för att rapportera datan som saknad, eller beskriva ett treårsfönster som om det vore hela utvecklingen.

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

Verktyg

Verktyg	Svarar på
`search_places`	namn till kod — "vilket Tölö menar du?"
`get_place_stats`	"hur många bor i Toukola eller Ackas?", "vad kostar en lägenhet i Tölö?"
`get_place_history`	"har bostadspriserna stigit i Esbo?" — tidsserie, beräknad riktning och områdets utvecklingsmått för 1/5/10 år
`get_air_quality`	"är luften ren i Vanda?" — uppmätta värden mot WHO- och EU-gränser
`compare_areas`	jämförelse av upp till 12 postnummerområden sida vid sida
`rank_areas`	"var i Finland är inkomsterna högst?" — hela landet, en kommun eller ett landskap
`find_similar_areas`	"var någon annanstans liknar det här området?"
`list_variables`	förteckning över mått och vilka år varje mått täcker
`get_area_report`	nedladdningslänk till PDF-rapporten för ett postnummerområde (kräver Pro eller områdespass)

Gratis och Pro

Funktion	Gratis	Pro
Befolkning, inkomst, utbildning, sysselsättning	allt	allt
Bostadspriser (senaste året)	ja	ja
Brottslighet och luftkvalitet	ja	ja
Historik	3 år	hela materialet (2010–)
Bostadsprisutveckling	nej	hela serien (2009–)
Rankningar	10 rader	100 rader
Områdesjämförelse	2 områden	12 områden
Uppdelning av sammansatta poäng	endast totalpoäng	alla delkomponenter

Datan är licensierad under CC BY 4.0. Källor: Statistikcentralen (Paavo, brottslighet, bostadspriser) och Meteorologiska institutet (luftkvalitet). Ange den ursprungliga utgivaren när du använder siffrorna.