Skip to content

malkreide/bakom-mcp

Repository files navigation

🇨🇭 Part of the Swiss Public Data MCP Portfolio

📡 bakom-mcp

Version License: MIT Python 3.11+ MCP Auth CI

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

🇩🇪 Deutsche Version

Demo: Claude queries fibre and 5G coverage via MCP tool call


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, licensed broadcasters (RTV database), and telecommunications statistics — all without API keys.

All data is published as Open Government Data (OGD) under open licences (CC0).

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.


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
  • 📺 RTV database – Search licensed radio and TV broadcasters by name, type, canton
  • 🗞️ 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, rtvdb.ofcomnet.ch)

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

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

Tool Description
bakom_broadband_coverage Fixed-line coverage at a coordinate (30–1000 Mbit/s)
bakom_glasfaser_verfuegbarkeit FTTB/FTTH fibre availability
bakom_multi_standort_konnektivitaet Connectivity comparison for up to 20 locations

Mobile & Transmitters

Tool Description
bakom_mobilfunk_abdeckung 5G/4G/3G outdoor coverage
bakom_sendeanlagen_suche Mobile antennas within a configurable radius
bakom_frequenzdaten Radio/TV transmitter sites near a location

Media & RTV

Tool Description
bakom_rtv_suche Search licensed broadcasters (RTV database)
bakom_medienstruktur_info Swiss media landscape datasets
bakom_aktuell Current BAKOM topics (5G, media, AI, postal)

Statistics & Catalogue

Tool Description
bakom_telekomstatistik_uebersicht Telecom statistics from opendata.swiss
bakom_breitbandatlas_datensaetze Full catalogue of Broadband Atlas layers
bakom_check_api_status 🔍 Health check for all configured data sources

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

Aspect Details
Access Read-only (readOnlyHint: true) — the server cannot modify or delete any data
Personal data No personal data — all sources are aggregated, public open data
Rate limits Built-in per-query caps (max 50 antennas, max 20 locations, max 50 RTV results)
Timeout 20 seconds per API call
Authentication No API keys required — all 3 APIs are publicly accessible
Licences All data under CC0 / open licences (Open Government Data)
Terms of Service Subject to ToS of the respective data sources: geo.admin.ch, opendata.swiss, rtvdb.ofcomnet.ch

Data Sources

Source Data Authentication
geo.admin.ch Broadband Atlas, mobile coverage, antenna locations None
opendata.swiss BAKOM datasets, telecom statistics None
rtvdb.ofcomnet.ch Licensed radio/TV broadcasters None

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


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
├── LICENSE
├── README.md                # This file (English)
└── README.de.md             # German version

Testing

# Unit tests (no network required)
PYTHONPATH=src pytest tests/ -m "not live"

# Integration tests (live APIs, internet required)
PYTHONPATH=src pytest tests/ -m "live"

Changelog

See CHANGELOG.md


Contributing

Contributions are welcome! See CONTRIBUTING.md for guidelines on reporting bugs, suggesting features, and submitting pull requests.


License

MIT License — see LICENSE


Author

Hayal Oezkan · github.com/malkreide


Credits & Related Projects


Part of the Swiss Open Data MCP portfolio — public data deserves public interfaces.

About

MCP Server for BAKOM Open Data – broadband, 5G/4G/3G coverage, media licences and Swiss telecom stats

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages