Bakom MCP

🇨🇭 Part of the [Swiss Public Data MCP Portfolio](https://github.com/malkreide)

📡 bakom-mcp

MCP server for BAKOM open data – broadband, mobile coverage, media and Swiss telecom statistics.

🇩🇪 Deutsche Version

---

Overview

bakom-mcp connects AI assistants like Claude to the Swiss Federal Office of Communications (BAKOM) open data infrastructure. It enables natural-language queries about broadband availability, 5G/4G coverage, mobile antenna locations, BAKOM datasets on radio and television, and telecommunications statistics — all without API keys.

All data is published as Open Government Data (OGD) on opendata.swiss / geo.admin.ch under CC BY 4.0 — see the Data Licence section below for attribution requirements.

Anchor demo query: *"Which school buildings in district 7 do not yet have fibre optic connectivity?"*

bakom_multi_standort_konnektivitaet delivers the comparison table automatically.

→ More use cases by audience →

---

Scope

What this server does

✓ Read-only queries against three public BAKOM/Confederation APIs:

• api3.geo.admin.ch / wms.geo.admin.ch (broadband, mobile coverage, antennas)
• ckan.opendata.swiss (telecom statistics, dataset metadata)

✓ Returns aggregated, anonymous data — no personal data, no household-level identification.

✓ Bound to Swiss WGS84 coordinates (lat 45.8–47.9, lon 5.9–10.6) via Pydantic input validation.

✓ Egress is locked to a code-layer allow-list of the six known data-source hosts.

What this server does not

✗ Send data anywhere (read-only, no write tools).

✗ Access the local filesystem (no path-traversal surface).

✗ Use authentication tokens (none required — all sources are public OGD).

✗ Cache or persist user inputs across calls.

✗ Execute shell commands or arbitrary code (no subprocess/os.system/eval).

---

Features

• 📶 Broadband availability – Fixed-line coverage at 30/100/300/500/1000 Mbit/s (250×250m grid)
• 🔌 Fibre status – FTTB/FTTH availability per location
• 📍 Multi-location comparison – Connectivity check for up to 20 locations simultaneously
• 📱 Mobile coverage – 5G/4G/3G outdoor coverage (100×100m grid)
• 📡 Antenna search – Mobile and broadcast transmitters within a configurable radius
• 📺 Radio & TV datasets – Full-text search across BAKOM's radio and television datasets on opendata.swiss
• 🗞️ Media landscape – BAKOM media structure reports and datasets
• 📊 Telecom statistics – Fixed-line, mobile, broadband market data via opendata.swiss
• 🗂️ Broadband Atlas catalogue – All BAKOM dataset layers with direct API links
• 🔓 No authentication required – All data is Open Government Data (OGD)

---

Prerequisites

• Python 3.11+
• uv or pip for installation
• Internet connection (live APIs: geo.admin.ch, opendata.swiss)

---

Installation

# Recommended: uvx (no permanent installation required)

uvx bakom-mcp

Or install with pip

pip install bakom-mcp

Development install

git clone https://github.com/malkreide/bakom-mcp cd bakom-mcp pip install -e ".[dev]"

---

Quickstart

Claude Desktop

Add to claude_desktop_config.json:

{

"mcpServers": { "bakom": { "command": "uvx", "args": ["bakom-mcp"] } } }

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cloud / HTTP Transport

python -m bakom_mcp.server --http

Server running at http://localhost:8050/mcp

Configuration via environment variables (see .env.example):

Docker

A hardened container image is provided. Suitable for cloud deployments behind a reverse proxy (Caddy, Traefik, nginx).

# Build & run via compose (recommended)

docker compose up --build

Or via docker run

docker build -t bakom-mcp:latest . docker run --rm \ --read-only \ --cap-drop=ALL \ --security-opt=no-new-privileges \ --tmpfs /tmp:rw,size=16M \ -p 127.0.0.1:8050:8050 \ bakom-mcp:latest

The image runs as non-root (UID 10001), uses a read-only filesystem, drops all Linux capabilities and refuses privilege escalation. Resource limits are configured in docker-compose.yml (256 MB memory, 0.5 CPU, 64 PIDs). The default port mapping binds to 127.0.0.1 only — for public exposure, terminate TLS and CORS at a reverse proxy.

Cursor / VS Code / LibreChat

{

"bakom": { "command": "uvx", "args": ["bakom-mcp"], "transport": "stdio" } }

💡 *"stdio for the developer laptop, HTTP/SSE for the browser."*

---

Available Tools (12)

Broadband & Connectivity

Mobile & Transmitters

Media & RTV

Statistics & Catalogue

---

Example Prompts

What is the broadband situation at Schulhaus Leutschenbach (47.4148, 8.5654)?

Compare 5G and fibre coverage for these three school buildings: [coordinates]

Which radio stations are licensed in canton Zurich?

Show me the current BAKOM position on 5G frequency allocation.

List all Broadband Atlas datasets available via geo.admin.ch.

---

Safety & Limits

---

Data Sources

All data is published under open licences (CC0 / OGD).

Architecture decision — media statistics

bakom_medien_statistik uses Architecture A (live API only), verified live on 2026-08-13:

• The SPARQL endpoint is https://lindas.admin.ch/query; the /sparql path documented elsewhere returns 404.
• The OFCOM cubes live in the named graph https://lindas.admin.ch/ofcom/cube. Without an explicit FROM, a query hits the default graph and sees 2010 cubes from every federal office instead of 540.
• A bulk download exists for only 137 of 540 cubes, so a dump-first architecture would cover a quarter of the data.
• An unknown graph answers HTTP 200 with zero rows — a silent empty, not an error. Requests carry retry with exponential backoff; egress-policy violations are not retried.

Scope, stated in the tool description because the README does not reach the model: the cubes cover the programmes that were *surveyed*, not the full inventory. LINDAS's own count cube reports 199+39+17 radio programmes for 2020, while the Programm dimension across all cubes exposes 128 labels — some of which are the same station spelled differently (Energy BE / Energy Bern), plus Durchschnitt, which is an aggregate rather than a station. This tool is a statistics source, not a broadcaster register; licensed broadcasters are listed in the RTV database, which offers no machine-readable interface.

---

Synergies with the MCP Portfolio

bakom-mcp can be combined with other servers in the portfolio for multi-dimensional queries:

zurich-opendata-mcp  →  school building addresses

+ bakom-mcp → fibre and 5G status = "Digital equity" dashboard for all school districts

Further combinations:

• srgssr-mcp + bakom-mcp → Media coverage and broadcast network
• swiss-statistics-mcp + bakom-mcp → Telecom market development
• fedlex-mcp + bakom-mcp → Regulatory context (RTVG, FMG)

---

Project Structure

bakom-mcp/

├── src/bakom_mcp/ │ ├── init.py # Package │ ├── server.py # MCP server (12 tools, 2 resources) │ └── py.typed # PEP 561 type marker ├── tests/ │ └── test_integration.py # Integration tests (live APIs) ├── assets/ │ └── demo.svg # Demo flow diagram ├── .github/workflows/ │ ├── ci.yml # CI: lint, syntax, import, tests │ └── publish.yml # PyPI publish on release ├── .gitignore ├── pyproject.toml # Build config (hatchling) ├── CHANGELOG.md ├── CONTRIBUTING.md # Contribution guide (English) ├── CONTRIBUTING.de.md # Contribution guide (German) ├── SECURITY.md # Security policy (English) ├── SECURITY.de.md # Security policy (German) ├── LICENSE # MIT License ├── README.md # This file (English) └── README.de.md # German version

---

MCP Protocol Version

This server speaks two protocol eras over the same endpoint. The client's first request on a connection decides which one applies; a later claim from the other era is refused.

| initialize han