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

Exempel: finns det en badstrand i närheten?

På frågan "finns det en simhall eller badstrand i eller nära Berghäll?" svarar assistenten med ett anrop: get_nearby_places med withinKm (högst 5 km) ger områdets egna platser och dem som ligger högst så långt från dess gräns, närmaste först, med avstånd.

Avståndet är fågelvägen från områdets gräns, 0 km inne i området — inte en gång- eller restid. inArea anger om platsen hör till själva området.

get_nearby_places {"place": "00530", "categories": ["swimming_pool", "beach"], "withinKm": 2}

{
  "summary": "Within 2 km of Kallio (Helsinki) (00530): nearest swimming pool Urheiluhallit Kallio / Helsingin urheilutalo / Uimahalli (0.03 km); nearest beach Mustikkamaan uimaranta (1.25 km).",
  "data": {
    "withinKm": 2,
    "nearby": {
      "swimming_pool": {
        "countWithin": 5,
        "nearest": [
          { "name": "Urheiluhallit Kallio / Helsingin urheilutalo / Uimahalli", "distanceKm": 0.03, "postalCode": "00510", "inArea": false },
          ...
        ]
      },
      "beach": { "countWithin": 2, "nearest": [ ... ] }
    }
  }
}

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
`get_nearby_places`	"vad finns i Berghäll?" — kollektivtrafikens hållplatser, daghem, skolor, högskolor och yrkesinstitut, hälso- och läkarstationer, apotek, livsmedelsbutiker, bibliotek, simhallar och badstränder inom ett postnummerområde eller några kilometer därifrån
`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; även brottslighet och renaste luften per kommun
`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
Platser i närheten (hållplatser och service)	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

Prova själv

Suomiatlas-kartan — samma data i webbläsaren, inget att installera
OpenAPI-specifikation — samma API som ett maskinläsbart kontrakt, ingen nyckel behövs

Statistiken är licensierad under CC BY 4.0. Källor: Statistikcentralen (Paavo, brottslighet, bostadspriser) och Meteorologiska institutet (luftkvalitet). Platserna i närheten har egna licenser: hållplatserna är öppen data från Digitransit (CC BY 4.0), daghemmen kommer från Suomi.fi-servicedatalagret (CC0 1.0), servicen från OpenStreetMap (© OpenStreetMaps bidragsgivare, ODbL 1.0) och simhallar och badstränder från LIPAS (Jyväskylä universitet, Lipas Liikuntapaikat.fi, CC BY 4.0). Ange den ursprungliga utgivaren när du använder uppgifterna; /api/v1/license beskriver hur databasen över platserna i närheten har byggts.