Skip to main content
Glama

Kolada MCP Server

npm version MCP Registry License: MIT

MCP-server för svensk kommun- och regionstatistik från Kolada API.

Kolada MCP-server kan LLMs ansluta till via lokal installation – och genom den få direkt tillgång till data och statistik för 5 000+ nyckeltal (KPI:er) inom 264 områden (ex. skola, vård, miljö, ekonomi, demokrati o.s.v.) för Sveriges alla kommuner och regioner. Utvecklad av Isak Skogstad, fristående från Kolada/RKA.

English: Kolada MCP Server connects LLMs and AI chatbots to 5,000+ Key Performance Indicators (KPIs) across 264 operating areas for all 290 Swedish municipalities and 21 regions. Kolada is Sweden's most comprehensive open data source for municipal and regional statistics. Developed by Isak Skogstad, not associated with Kolada/SKR.

https://github.com/user-attachments/assets/6791bb81-79dc-4af3-8028-44c3929d57d0

Installation

Med npx (snabbast):

npx kolada-mcp-server

Med global installation:

npm install -g kolada-mcp-server
kolada-mcp-server

Paketet publiceras på npm: kolada-mcp-server.

Related MCP server: SCB MCP Server

Klientkonfiguration

Claude Desktop

Lägg till i konfigurationsfilen:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

Claude Code (CLI)

claude mcp add kolada -- npx -y kolada-mcp-server

Verifiera med:

claude mcp list

OpenAI Codex CLI

Lägg till i ~/.codex/config.toml:

[mcp_servers.kolada]
command = "npx"
args = ["-y", "kolada-mcp-server"]

Gemini CLI

Lägg till i ~/.gemini/settings.json:

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

Firebase Studio / Android Studio

Lägg till i mcp.json i projektroten:

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

Andra MCP-klienter

De flesta MCP-klienter stödjer stdio-transport. Konfigurera med:

{
  "mcpServers": {
    "kolada": {
      "command": "npx",
      "args": ["-y", "kolada-mcp-server"]
    }
  }
}

Installation från källkod

git clone https://github.com/isakskogstad/kolada-mcp.git
cd kolada-mcp
npm install
npm run build
node dist/index.js

Verktyg

Nyckeltal (KPI)

Verktyg

Beskrivning

search_kpis

Fritextsökning bland 5 000+ nyckeltal

get_kpi

Hämta metadata för ett nyckeltal via ID

get_kpis

Hämta flera nyckeltal samtidigt (max 25)

get_kpi_groups

Lista tematiska grupper

get_kpi_group

Hämta alla nyckeltal i en grupp

list_operating_areas

Lista 264 verksamhetsområden

get_kpis_by_operating_area

Filtrera nyckeltal per verksamhetsområde

Kommuner och regioner

Verktyg

Beskrivning

search_municipalities

Sök bland 290 kommuner och 21 regioner

get_municipality

Hämta detaljer via kommun-ID (t.ex. "0180")

get_municipality_groups

Lista kommungrupper

get_municipality_group

Hämta kommuner i en grupp

Organisationsenheter

Verktyg

Beskrivning

search_organizational_units

Sök skolor, äldreboenden m.m.

get_organizational_unit

Hämta enhetsdetaljer

get_ou_types

Lista enhetstyper

Data

Verktyg

Beskrivning

get_kpi_data

Hämta värden med könsfiltrering (T/M/K)

get_municipality_kpis

Lista KPI:er för en kommun

compare_municipalities

Jämför 2–10 kommuner

get_kpi_trend

Tidsserieanalys

Analys

Verktyg

Beskrivning

analyze_kpi_across_municipalities

Statistik + rankning

filter_municipalities_by_kpi

Filtrera efter tröskelvärde

compare_kpis

Korrelation mellan nyckeltal

Verksamhetsområden (urval)

Område

Antal KPI:er

Kommunen, övergripande

553

Grundskola åk 0-9

470

Gymnasieskola åk 1-3

215

Hälso- och sjukvård

204

Befolkning

199

Region/Landsting

151

Förskoleverksamhet

135

Vuxenutbildning

126

Totalt 264 verksamhetsområden.

Enhetstyper

Kod

Typ

V11

Förskola

V15

Grundskola

V16

Gymnasieskola

V17

Anpassad skola

V18

Vuxenutbildning

V21

Äldreboende

V31

Fritidshem

Huvudfunktioner

  • Könsfiltrering – T (totalt), M (män), K (kvinnor)

  • Intelligent cachning – 24-timmarscache för kataloger

  • Hastighetsbegränsning – Respekterar Koladas API-gränser

  • Svensk dokumentation – Optimerat för svenska AI-assistenter

Säkerhet / Security

Kolada MCP Server använder flera lager av automatisk säkerhetsskanning för att säkerställa kodens integritet och upptäcka sårbarheter:

🛡️ Automatiska Säkerhetsverktyg

  • CodeQL: Kontinuerlig kodanalys för säkerhetsbrister

  • GitGuardian: Skannar efter exponerade API-nycklar och hemligheter

  • TruffleHog: Kompletterande secret scanning i commit-historik

  • Bearer SAST: Static Application Security Testing för applikationssårbarheter

  • Dependabot: Automatiska säkerhetsuppdateringar för dependencies

  • npm audit: Daglig granskning av sårbara paket

📋 Säkerhetspolicy

Se SECURITY.md för:

  • Hur man rapporterar säkerhetsproblem

  • Detaljer om säkerhetsskanningsprocessen

  • Riktlinjer för säker användning

  • Kontaktinformation

🔒 Bästa Praxis

  • Inga hårdkodade hemligheter i källkoden

  • Alla känsliga värden hanteras via miljövariabler

  • Rate limiting och timeout-konfigurationer

  • Regelbundna automatiska säkerhetsuppdateringar

English: For security policies and vulnerability reporting, see SECURITY.md.

Licens

MIT – se LICENSE

Skapat av Isak Skogstad.

  • Utnyttjande av data från Koladas API är avgiftsfritt och kräver inget avtal.

  • Om du använder data från Kolada i en tjänst, ska källan anges ('Källa: Kolada').

  • Gör du egna bearbetningar på vår data, får inte Kolada anges som källa.

  • Det är tillåtet att använda vår data för kommersiella ändamål.

  • API:et får inte användas för att sprida skadlig kod.

  • Du får inte presentera den tjänst du utvecklat som ett 'officiellt samarbete' eller 'partnerskap' med RKA/Kolada.

  • Tjänsten tillhandahålls i befintligt skick.

  • Publicering av data i Kolada sker löpande under året i enlighet med respektive statistikkällas publiceringstidpunkt.

  • Revideringar av data i Kolada kan ske och aviseras inte särskilt.

  • Enskilda nyckeltal kan tas bort ur Kolada t.ex. pga. att underlag för nyckeltalen förändras, vilket inte aviseras.

Available Tools

21 tools
analyze_kpi_across_municipalitiesA
Read-onlyIdempotent

Analysera ett KPI över alla kommuner med statistik (min, max, medel, median) och rankning. Visar toppkommuner och bottenkommuner. Perfekt för benchmarking och jämförelser.

Inputs: kpi_id (required), year (required), gender, municipality_type, +2 more.

compare_kpisA
Read-onlyIdempotent

Beräkna Pearson-korrelation mellan två KPIs för att se om det finns samband. T.ex. korrelation mellan lärartäthet och skolresultat. Värden nära 1 = starkt positivt samband, nära -1 = starkt negativt, nära 0 = inget samband.

Inputs: kpi_id_1 (required), kpi_id_2 (required), year (required), gender, +1 more.

compare_municipalitiesA
Read-onlyIdempotent

Jämför ett specifikt nyckeltal över flera kommuner för angivna år. Utmärkt för benchmarking. Stöder könsfiltrering (T/M/K).

Inputs: kpi_id (required), municipality_ids (required), years, gender.

filter_municipalities_by_kpiA
Read-onlyIdempotent

Filtrera kommuner baserat på KPI-tröskelvärde. Hitta t.ex. alla kommuner där lärartäthet > 12 eller arbetslöshet < 5%. Användbart för att identifiera kommuner som uppfyller specifika kriterier.

Inputs: kpi_id (required), year (required), threshold (required), operator (required), +2 more.

get_kpiA
Read-onlyIdempotent

Hämta detaljerad information om ett specifikt nyckeltal (KPI) via dess ID. Returnerar fullständig metadata inklusive publiceringsdatum och könsuppdelning.

Inputs: kpi_id (required).

get_kpi_dataA
Read-onlyIdempotent

Hämta faktiska KPI-datavärden för specifika kommuner eller organisationsenheter. Kan filtrera efter år och kön (T=Totalt, M=Män, K=Kvinnor).

Inputs: kpi_id (required), municipality_id, ou_id, years, +1 more.

get_kpi_groupA
Read-onlyIdempotent

Hämta detaljerad information om en specifik KPI-grupp inklusive alla ingående nyckeltal. Användbar för att utforska relaterade KPIs.

Inputs: group_id (required).

get_kpi_groupsA
Read-onlyIdempotent

Lista KPI-grupper (tematiska samlingar av nyckeltal) med valfri sökning. Grupper hjälper till att organisera KPIs efter ämne.

Inputs: query.

get_kpisA
Read-onlyIdempotent

Hämta flera nyckeltal (KPIs) via deras ID:n i en enda förfrågan. Accepterar upp till 25 KPI-ID:n per anrop.

Inputs: kpi_ids (required).

get_kpis_by_operating_areaA
Read-onlyIdempotent

Hämta alla KPIs inom ett specifikt verksamhetsområde. T.ex. alla utbildnings-KPIs eller alla vård-KPIs. Enklare än fritextsökning för att hitta relaterade nyckeltal.

Inputs: operating_area (required), limit.

get_kpi_trendB
Read-onlyIdempotent

Hämta historisk trenddata för ett nyckeltal som visar förändringar över tid. Användbart för att analysera utveckling och identifiera trender. Stöder könsfiltrering (T/M/K).

Inputs: kpi_id (required), municipality_id (required), start_year (required), end_year, +1 more.

get_municipalityA
Read-onlyIdempotent

Hämta detaljerad information om en specifik kommun via dess ID. Kommun-ID är 4-siffriga koder (t.ex. "0180" för Stockholm, "1480" för Göteborg).

Inputs: municipality_id (required).

get_municipality_groupB
Read-onlyIdempotent

Hämta detaljerad information om en specifik kommungrupp inklusive alla medlemskommuner. Användbar för att analysera grupper av liknande kommuner.

Inputs: group_id (required).

get_municipality_groupsB
Read-onlyIdempotent

Lista kommungrupper som storstadsregioner, kustkommuner etc. Grupper hjälper till att jämföra liknande kommuner.

Inputs: query.

get_municipality_kpisA
Read-onlyIdempotent

Visa tillgängliga KPIs för en kommun. Filtrera på verksamhetsområde för att hitta relevanta nyckeltal. Snabb och pålitlig - använder cachad KPI-katalog.

Inputs: municipality_id (required), operating_area, limit.

get_organizational_unitB
Read-onlyIdempotent

Hämta detaljerad information om en specifik organisationsenhet via dess ID.

Inputs: ou_id (required).

get_ou_typesA
Read-onlyIdempotent

Hämta en lista över vanliga organisationsenhetstyper och deras beskrivningar (t.ex. V11=Förskola, V15=Grundskola).

Inputs: no named parameters.

list_operating_areasA
Read-onlyIdempotent

Lista alla verksamhetsområden (t.ex. Utbildning, Vård och omsorg) med antal KPIs per område. Ger överblick över vilka typer av data som finns tillgänglig.

Inputs: no named parameters.

search_kpisA
Read-onlyIdempotent

Sök efter nyckeltal (KPIs) med fritextsökning, publiceringsdatum eller verksamhetsområde. Returnerar en lista med matchande KPIs. Svenska söktermer ger bäst resultat.

Inputs: query, publication_date, operating_area, limit.

search_municipalitiesA
Read-onlyIdempotent

Sök efter svenska kommuner eller regioner (landsting). Filtrera efter namn eller typ. Det finns 290 kommuner och 21 regioner i Sverige.

Inputs: query, municipality_type.

search_organizational_unitsA
Read-onlyIdempotent

Sök efter organisationsenheter som skolor, förskolor, äldreboenden etc. Filtrera efter namn, kommun eller typ. OBS: Resultat trunkeras till limit (max 100). Kontrollera "truncated" i svaret för att veta om det finns fler träffar.

Inputs: query, municipality, ou_type, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools have distinct purposes, such as 'analyze_kpi_across_municipalities' for statistical analysis and 'compare_kpis' for correlation. However, some overlap exists, like 'get_kpi_data' and 'get_kpis' both retrieving KPI values, which could cause minor confusion. The descriptions help clarify, but the boundaries between data retrieval tools are not perfectly sharp.

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, such as 'get_kpi', 'search_municipalities', and 'list_operating_areas'. There are no deviations in naming conventions, making the set predictable and easy to navigate for an agent.

    Tool Count3/5

    With 21 tools, the count is borderline high for a data query server, potentially overwhelming for an agent. While the tools cover various aspects like KPI analysis, municipality data, and organizational units, some could be consolidated (e.g., multiple get/search tools) to reduce complexity without losing functionality.

    Completeness5/5

    The tool set provides comprehensive coverage for querying and analyzing Swedish municipal data, including KPIs, municipalities, and organizational units. It supports CRUD-like operations (e.g., get, search, compare, analyze) across the domain, with no obvious gaps that would hinder an agent from performing typical data exploration and benchmarking tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides access to Sweden's comprehensive municipal and regional statistics database with semantic search capabilities. Enables natural language queries against thousands of Key Performance Indicators covering various aspects of Swedish public sector data.
      16
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables LLMs to search, access, and retrieve official Swedish statistics from Statistics Sweden (SCB), providing access to 1,200+ tables covering demographics, economy, environment, labor market, and education with 75+ years of historical data.
      9
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Query Swedish public data from AI tools. Includes company data, SCB statistics, weather, transport, public agencies, and more through the Apiverket API.
      2
      53 npm
      2
      MIT