Srgssr MCP

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

📺 srgssr-mcp

MCP server connecting AI models to SRG SSR public APIs – weather, TV/radio metadata, program guide and Swiss votations/elections since 1900 (SRF, RTS, RSI, RTR, SWI).

🇩🇪 Deutsche Version

---

Overview

srgssr-mcp gives AI assistants like Claude direct access to the public APIs of SRG SSR – Switzerland's national public broadcaster. Weather forecasts, TV and radio metadata, electronic program guides, and historical democratic data (votations and elections since 1900) are all accessible through a single standardised MCP interface.

The server covers five thematic clusters: SRF Weather, Video, Audio, EPG and Polis (Swiss Democracy). Each cluster maps to a group of purpose-built tools that translate raw SRG SSR API data into clean JSON responses.

Anchor demo query: *"What were the cantonal results of the popular vote on initiative X in Zurich?"* – answered with historical real-time data from the Polis system, not a hallucination.

---

Features

• 🌦️ Weather – location search, current conditions, 24h hourly forecast, 7-day forecast (SRF Meteo)
• 📺 Video – TV show listings, latest episodes, live TV channels across all business units
• 🎙️ Audio – radio show listings, audio episodes, live radio stations
• 📅 EPG – daily program schedule for any TV or radio channel
• 🗳️ Polis – popular votes and elections since 1900, national and cantonal results
• 🏢 Multi-unit – SRF (DE), RTS (FR), RSI (IT), RTR (RM), SWI (multilingual)
• 🔐 OAuth2 – automatic token management with Client Credentials flow
• ☁️ Dual transport – stdio for Claude Desktop, Streamable HTTP/SSE for cloud deployment

---

Prerequisites

• Python 3.11+
• API keys from developer.srgssr.ch (free registration):

1. Create an account and log in
2. Under "My Apps", create a new application
3. Add the product SRG SSR PUBLIC API V2
4. Note your Consumer Key and Consumer Secret

⚠️ Terms of use: SRG SSR APIs are available for non-commercial use. For commercial use, contact api@srgssr.ch directly.

---

Installation

# Clone the repository

git clone https://github.com/malkreide/srgssr-mcp.git cd srgssr-mcp

Install

pip install -e .

Or with uvx (no permanent installation):

uvx srgssr-mcp

Or via pip:

pip install srgssr-mcp

---

Quickstart

# Set credentials

export SRGSSR_CONSUMER_KEY="your-consumer-key" export SRGSSR_CONSUMER_SECRET="your-consumer-secret"

Start the server (stdio mode for Claude Desktop)

srgssr-mcp

Try it immediately in Claude Desktop:

*"What will the weather be like in Zurich tomorrow?"*

*"What's on SRF 1 tonight?"*

*"Which popular votes took place in the canton of Bern between 2010 and 2020?"*

---

Configuration

Claude Desktop

Minimal (recommended):

{

"mcpServers": { "srgssr": { "command": "uvx", "args": ["srgssr-mcp"], "env": { "SRGSSR_CONSUMER_KEY": "your-consumer-key", "SRGSSR_CONSUMER_SECRET": "your-consumer-secret" } } } }

Config file locations:

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

After saving, restart Claude Desktop completely.

Other MCP Clients

Compatible with Cursor, Windsurf, VS Code + Continue, LibreChat, Cline, and self-hosted models via mcp-proxy. Set the same environment variables.

Cloud Deployment (SSE for browser access)

For use via claude.ai in the browser (e.g. on managed workstations without local software):

SRGSSR_CONSUMER_KEY=... \

SRGSSR_CONSUMER_SECRET=... \ SRGSSR_MCP_TRANSPORT=streamable-http \ SRGSSR_MCP_HOST=0.0.0.0 \ SRGSSR_MCP_PORT=8000 \ python -m srgssr_mcp.server

Transport, host, port and mount path are all driven by environment variables (see srgssr_mcp.server.Settings). Valid values for SRGSSR_MCP_TRANSPORT are stdio (default), sse, and streamable-http.

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

---

MCP Primitives

This server exposes all three orthogonal MCP primitives:

Tools cover parametrized searches (year ranges, free-text, paginated listings) where every call may yield different results. Resources expose stable data points that are safe to cache: a published EPG for a given channel/date, or the final result of a closed Swiss votation. Prompts standardise recurring multi-step analyses so users don't have to phrase them from scratch.

Resources

EPG station ids — hyphenated, and not the same as the livestream ids:

Prompts

---

Available Tools

Tool Naming Convention

This server uses `snake_case` for tool names, following Python ecosystem idioms. While MCP best practice favors camelCase for optimal LLM tokenization, snake_case remains acceptable and keeps tool names aligned with the underlying Python function identifiers.

All tools follow the pattern srgssr_ _ with the namespace prefix srgssr_ and a semantically meaningful _ suffix (e.g. srgssr_weather_current, srgssr_polis_get_votations).

🌦️ SRF Weather (4 tools)

📺 Video (3 tools)

🎙️ Audio (3 tools)

📅 EPG – Electronic Program Guide (1 tool)

🗳️ Polis – Swiss Democracy (3 tools)

Supported Business Units

Example Use Cases

→ More use cases by audience →

---

Architecture

┌─────────────┐

│ Claude / LLM│ └──────┬──────┘ │ MCP (stdio) ┌──────▼───────────────────┐ │ srgssr-mcp Server │ │ ├─ Weather Tools (4) │ │ ├─ EPG Tools (1) │ │ ├─ Polis Tools (3) │ │ ├─ Video Tools (3) │ │ └─ Audio Tools (3) │ └──────┬───────────────────┘ │ HTTPS (OAuth2) ┌──────▼──────────────┐ │ SRG SSR Public APIs │ │ developer.srgssr.ch│ └─────────────────────┘

Data Sources

Attribution: SRG SSR APIs are subject to the SRG SSR Terms of Use.

---

Development Phase

This server is in Phase 1: Read-only Wrapper.

The server exposes only GET-style operations against public SRG SSR APIs. There are no write, mutate or delete capabilities by design — see Safety & Limits for the threat-model implications.

Phase 1 Completion Criteria

• 14 read-only tools across five thematic clusters (Weather, Video, Audio, EPG, Polis)
• OAuth2 Client Credentials authentication with token caching
• Bilingual documentation (EN/DE)
• Test suite (unit + live) — see OPS-001
• Structured logging — see OBS-003 and CHANGELOG
• Production-ready error handling (uniform retry/backoff, typed error envelopes)

Future Phases

• Phase 2 (Write): Not planned. The SRG SSR Public APIs are read-only by contract; there is no upstream surface to write to.
• Phase 3 (Multi-Agent): Evaluation deferred. Will be reconsidered once user feedback indicates concrete multi-agent workflows that this server should orchestrate (e.g. cross-server aggregation with swiss-statistics-mcp or `swiss-transport