Click on "Install 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 Servercompare unemployment rates between Stockholm and Gothenburg"
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
A clean, standalone MCP (Model Context Protocol) server for Sweden's Kolada municipal statistics API.
Overview
This server provides AI applications with access to Sweden's comprehensive municipal and regional statistics database. It enables natural language queries against thousands of Key Performance Indicators (KPIs) covering various aspects of Swedish public sector data.
Features
9 MCP Tools for comprehensive data access
Semantic Search using Swedish BERT embeddings
No External Dependencies - fully standalone (no Mima or Redis)
Containerized with Docker support
Modern Python 3.11+ with type hints and async/await
Available Tools
Tool | Description |
| List all KPI categories with counts |
| Get KPIs within a specific category |
| Semantic search for KPIs using natural language |
| Get detailed metadata for a specific KPI |
| Fetch raw KPI data for municipalities |
| Comparative analysis with rankings |
| Compare two KPIs (difference or correlation) |
| List municipalities/regions |
| Filter by KPI threshold |
Installation
Using pip
pip install -e .Using Docker
docker-compose up -d kolada-mcpUsage
Stdio Mode (Default)
kolada-mcp
# or
python -m kolada_mcpHTTP Mode
MCP_TRANSPORT=http PORT=8001 kolada-mcpClaude Desktop Integration
Add to your Claude Desktop configuration:
{
"mcpServers": {
"kolada": {
"command": "kolada-mcp"
}
}
}Configuration
Environment variables:
Variable | Default | Description |
|
| Transport mode ( |
|
| HTTP server port |
|
| Logging level |
Development
Setup
# Create virtual environment
python -m venv .venv
source .venv/bin/activate
# Install with dev dependencies
pip install -e ".[dev]"Running Tests
pytestCode Quality
# Linting
ruff check src tests
# Type checking
mypy srcArchitecture
src/kolada_mcp/
├── __init__.py # Package init
├── __main__.py # Entry point
├── config.py # Settings (Pydantic)
├── server.py # FastMCP server
├── models/
│ └── types.py # Data models
├── services/
│ ├── kolada_client.py # API client
│ ├── embeddings.py # Semantic search
│ └── data_processing.py
└── tools/
├── metadata.py # KPI metadata tools
├── data.py # Data fetching tools
├── municipality.py # Municipality tools
└── comparison.py # Comparison toolsLicense
Apache-2.0
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.