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_operating_areas`	List all KPI categories with counts
`get_kpis_by_operating_area`	Get KPIs within a specific category
`search_kpis`	Semantic search for KPIs using natural language
`get_kpi_metadata`	Get detailed metadata for a specific KPI
`fetch_kolada_data`	Fetch raw KPI data for municipalities
`analyze_kpi_across_municipalities`	Comparative analysis with rankings
`compare_kpis`	Compare two KPIs (difference or correlation)
`list_municipalities`	List municipalities/regions
`filter_municipalities_by_kpi`	Filter by KPI threshold

Installation

Using pip

pip install -e .

Using Docker

docker-compose up -d kolada-mcp

Usage

Stdio Mode (Default)

kolada-mcp # or python -m kolada_mcp

HTTP Mode

MCP_TRANSPORT=http PORT=8001 kolada-mcp

Claude Desktop Integration

Add to your Claude Desktop configuration:

{ "mcpServers": { "kolada": { "command": "kolada-mcp" } } }

Configuration

Environment variables:

Variable	Default	Description
`MCP_TRANSPORT`	`stdio`	Transport mode (`stdio` or `http`)
`PORT`	`8001`	HTTP server port
`LOG_LEVEL`	`INFO`	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

pytest

Code Quality

# Linting ruff check src tests # Type checking mypy src

Architecture

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 tools

License

Apache-2.0

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

Kolada MCP Server

Kolada MCP Server

Overview

Features

Available Tools

Installation

Using pip

Using Docker

Usage

Stdio Mode (Default)

HTTP Mode

Claude Desktop Integration

Configuration

Development

Setup

Running Tests

Code Quality

Architecture

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API