kolada-mcp

An MCP server for Kolada.

13 stars PythonServers & Infrastructure Updated Jul 29, 2025

Documentation

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

bash

pip install -e .

Using Docker

bash

docker-compose up -d kolada-mcp

Usage

Stdio Mode (Default)

bash

kolada-mcp
# or
python -m kolada_mcp

HTTP Mode

bash

MCP_TRANSPORT=http PORT=8001 kolada-mcp

Claude Desktop Integration

Add to your Claude Desktop configuration:

json

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

bash

# Create virtual environment
python -m venv .venv
source .venv/bin/activate

# Install with dev dependencies
pip install -e ".[dev]"

Running Tests

bash

pytest

Code Quality

bash

# Linting
ruff check src tests

# Type checking
mypy src

Architecture

code

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

Frequently asked questions

What is kolada-mcp?

kolada-mcp is An MCP server for Kolada.

How do I install kolada-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is kolada-mcp open source?

Yes — it is hosted on GitHub at https://github.com/aerugo/kolada-mcp and has 13 stars.

Related MCP tools

damn-vulnerable-mcp-server

Damn Vulnerable MCP Server Python-based implementation. Trusted by 1200+ developers. Trusted by 1200+ developers. Trusted by 1200+ developers.

1,209 Python

mysql_mcp_server

A Model Context Protocol (MCP) server that enables secure interaction with MySQL databases Python-based implementation. Trusted by 900+ developers.

964 Python

aimcpmodel-context-protocol+1

supabase-mcp-server

Query MCP enables end-to-end management of Supabase via chat interface: read & write query executions, management API support, automatic migration versioning...

805 Python

cursormodel-context-protocolsupabase+1