Kolada MCP Server

SSE

by aerugo

16 180 downloads Not rated yet

About

A standalone MCP server that provides AI applications with access to Sweden's Kolada municipal statistics API. It enables natural language queries against thousands of Key Performance Indicators covering Swedish public sector data. Designed for developers and data analysts…

Details

Transport
SSE

Explore

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Kolada MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Environment variables:

| Variable | Default | Description |
|----------|---------|-------------|
| MCP_TRANSPORT | stdio | Transport mode (stdio or http) |
| PORT | 8001 | HTTP server port |
| LOG_LEVEL | INFO | Logging level |

python -m venv .venv
source .venv/bin/activate

pip install -e ".[dev]"


bash
pytest
```

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

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "kolada mcp server": {
            "kolada-mcp": {
                "command": "python",
                "args": [
                    "-m",
                    "kolada_mcp"
                ]
            }
        }
    }
}

McpServers

{
    "kolada-mcp": {
        "command": "python",
        "args": [
            "-m",
            "kolada_mcp"
        ]
    }
}

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)

```bash
kolada-mcp

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.