Suomiatlas MCP server

An MCP (Model Context Protocol) server that lets an AI assistant query Suomiatlas directly: "how many people live in Toukola?", "what does an apartment cost in Töölö?", "is the air clean in Vantaa?". Covers ~3,000 Finnish postal code areas and all 308 municipalities.

Connect with nothing installed

The server is hosted at https://suomiatlas.com/api/mcp over Streamable HTTP. In Claude Code that is one command; in other clients, add the same URL as an HTTP-type MCP server.

The --header line is optional. Leave it out and you get the free tier, which answers every question above; supply a key and you get your account's Pro access or Area Pass.

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

Other clients

If your client has no command for adding a server, put the same URL in its configuration file as an HTTP-type MCP server.

The Authorization line is optional — leave it out and you get the free tier.

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

API keys

Create a key while signed in to Suomiatlas, under API keys. It is shown once; afterwards you see only its prefix. Revoke it at any time.

Keys travel in the Authorization header, never in a cookie. A key can read your account's Pro data, but cannot create or revoke keys, or change the account.

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

What the free tier withholds

When something is behind the paywall, the result carries a locked field naming what is missing and why. The data exists — it is simply not returned. That lets an assistant say "this needs Pro" instead of reporting the data as absent, or describing a three-year window as if it were the whole trend.

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

Tools

Tool	Answers
`search_places`	name to code — "which Töölö do you mean?"
`get_place_stats`	"how many people live in Toukola or Akaa?", "what does an apartment cost in Töölö?"
`get_place_history`	"have apartment prices been rising in Espoo?" — series, a computed direction, and an area's 1/5/10-year trend indicators
`get_air_quality`	"is the air clean in Vantaa?" — measured values against WHO and EU limits
`compare_areas`	side-by-side statistics for up to 12 postal areas
`rank_areas`	"highest income areas in Finland?" — nationally, or within one municipality or region
`find_similar_areas`	"where else feels like this neighbourhood?"
`list_variables`	the metric catalogue, and each metric's year coverage
`get_area_report`	the PDF report download link for one postal area (needs Pro or an Area Pass)

Free and Pro

Feature	Free	Pro
Population, income, education, employment	all	all
Housing sale prices (latest year)	yes	yes
Crime and air quality	yes	yes
History	3 years	full record (2010–)
Housing price trends	no	full series (2009–)
Rankings	10 rows	100 rows
Area comparison	2 areas	12 areas
Composite score breakdown	headline score only	every component

The data is CC BY 4.0. Sources: Statistics Finland (Paavo, crime, housing sale prices) and the Finnish Meteorological Institute (air quality). Attribute the original publisher when you use the figures.