Kolada MCP Server
The Kolada MCP Server connects LLMs and AI assistants to Sweden's Kolada open data platform, providing access to 5,000+ KPIs across all 290 municipalities and 21 regions.
Search & Retrieve KPIs
Full-text search with filters for operating area and publication date
Fetch KPI metadata by ID (single or up to 25 at once)
Browse thematic KPI groups and list all 264 operating areas
Explore Municipalities & Regions
Search by name or type, retrieve details by 4-digit ID
Browse municipality groups (e.g., coastal, metropolitan)
Manage Organizational Units
Search schools, preschools, nursing homes, etc. by name, municipality, or type
List available unit types and retrieve unit details
Access & Compare Data
Fetch KPI values for municipalities or organizational units, filtered by year and gender (Total/Men/Women)
Compare 2–10 municipalities on a KPI
Retrieve historical trend data for a KPI
Advanced Analysis
Statistical summaries (min, max, mean, median, rankings) across all municipalities
Filter municipalities by KPI threshold (e.g., unemployment < 5%)
Calculate Pearson correlation between two KPIs
Core Features: gender-based filtering, intelligent caching, API rate limit compliance, and Swedish-optimized documentation.
Integrates with Firebase Studio / Android Studio MCP configuration to access Kolada statistics for Swedish municipalities and regions.
Dependabot is used for automatic security updates of dependencies.
Firebase Studio supports MCP server configuration for accessing Kolada statistics.
Source code hosted on GitHub; uses GitHub Actions for security scanning and Dependabot for dependency updates.
Supports configuration on macOS for Claude Desktop and other MCP clients.
Published as npm package 'kolada-mcp-server' for easy installation and use.
Works with OpenAI Codex CLI via MCP configuration to provide access to Kolada's municipal and regional data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Kolada MCP Server compare school funding per student between Stockholm and Gothenburg for the last 5 years"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Kolada MCP Server
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-serverMed global installation:
npm install -g kolada-mcp-server
kolada-mcp-serverPaketet 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.jsonWindows:
%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-serverVerifiera med:
claude mcp listOpenAI 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.jsVerktyg
Nyckeltal (KPI)
Verktyg | Beskrivning |
| Fritextsökning bland 5 000+ nyckeltal |
| Hämta metadata för ett nyckeltal via ID |
| Hämta flera nyckeltal samtidigt (max 25) |
| Lista tematiska grupper |
| Hämta alla nyckeltal i en grupp |
| Lista 264 verksamhetsområden |
| Filtrera nyckeltal per verksamhetsområde |
Kommuner och regioner
Verktyg | Beskrivning |
| Sök bland 290 kommuner och 21 regioner |
| Hämta detaljer via kommun-ID (t.ex. "0180") |
| Lista kommungrupper |
| Hämta kommuner i en grupp |
Organisationsenheter
Verktyg | Beskrivning |
| Sök skolor, äldreboenden m.m. |
| Hämta enhetsdetaljer |
| Lista enhetstyper |
Data
Verktyg | Beskrivning |
| Hämta värden med könsfiltrering (T/M/K) |
| Lista KPI:er för en kommun |
| Jämför 2–10 kommuner |
| Tidsserieanalys |
Analys
Verktyg | Beskrivning |
| Statistik + rankning |
| Filtrera efter tröskelvärde |
| 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 toolsanalyze_kpi_across_municipalitiesARead-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_kpisARead-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_municipalitiesARead-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_kpiARead-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_kpiARead-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_dataARead-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_groupARead-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_groupsARead-onlyIdempotent
Lista KPI-grupper (tematiska samlingar av nyckeltal) med valfri sökning. Grupper hjälper till att organisera KPIs efter ämne.
Inputs: query.
get_kpisARead-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_areaARead-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_trendBRead-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_municipalityARead-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_groupBRead-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_groupsBRead-onlyIdempotent
Lista kommungrupper som storstadsregioner, kustkommuner etc. Grupper hjälper till att jämföra liknande kommuner.
Inputs: query.
get_municipality_kpisARead-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_unitBRead-onlyIdempotent
Hämta detaljerad information om en specifik organisationsenhet via dess ID.
Inputs: ou_id (required).
get_ou_typesARead-onlyIdempotent
Hämta en lista över vanliga organisationsenhetstyper och deras beskrivningar (t.ex. V11=Förskola, V15=Grundskola).
Inputs: no named parameters.
list_operating_areasARead-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_kpisARead-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_municipalitiesARead-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_unitsARead-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
Scored across 21 tools
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.
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.
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.
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
Related MCP Connectors
Kolada (RKA) MCP — Sweden's municipal & regional key-performance-indicator (KPI) database.
Swedish public data as read-only tools: registries, statistics, domains, transport, energy.
MCP server for Statistics Sweden (SCB) - 1200+ tables with population, economy, environment data
Swedish B2B intelligence for AI agents: insolvency risk, procurement, BRF health and more.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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.16Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables 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.9MIT
- AlicenseAqualityDmaintenanceQuery Swedish public data from AI tools. Includes company data, SCB statistics, weather, transport, public agencies, and more through the Apiverket API.253 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables easy access to open data from the Swedish National Agency for Education, allowing querying and integration of educational statistics and facts through large language models.1MIT