srgssr-mcp 0.1.0

MCP server for SRG SSR public APIs – weather, TV/radio metadata, program guide & Swiss votations/elections since 1900

🇨🇭 Part of the Swiss Public Data MCP Portfolio

📺 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 [e-mail] 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=... \
  python -m srgssr_mcp.server --transport streamable_http --port 8000

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

---

Available Tools

🌦️ SRF Weather (4 tools)

Tool	Description	Data Source
srgssr_weather_search_location	Search for a location by name or postal code to obtain a geolocationId	SRF Meteo
srgssr_weather_current	Current weather conditions for a Swiss location	SRF Meteo
srgssr_weather_forecast_24h	Hourly 24-hour forecast	SRF Meteo
srgssr_weather_forecast_7day	Daily 7-day forecast	SRF Meteo

📺 Video (3 tools)

Tool	Description	Data Source
srgssr_video_get_shows	List TV shows for a business unit	SRG SSR IL
srgssr_video_get_episodes	Retrieve latest episodes of a show	SRG SSR IL
srgssr_video_get_livestreams	List live TV channels	SRG SSR IL

🎙️ Audio (3 tools)

Tool	Description	Data Source
srgssr_audio_get_shows	List radio shows for a business unit	SRG SSR IL
srgssr_audio_get_episodes	Retrieve audio episodes of a show	SRG SSR IL
srgssr_audio_get_livestreams	List live radio stations	SRG SSR IL

📅 EPG – Electronic Program Guide (1 tool)

Tool	Description	Data Source
srgssr_epg_get_programs	Daily program schedule for a TV or radio channel	SRG SSR IL

🗳️ Polis – Swiss Democracy (3 tools)

Tool	Description	Data Source
srgssr_polis_get_votations	Popular votes since 1900 (national or cantonal)	Polis API
srgssr_polis_get_votation_results	Detailed results of a specific vote	Polis API
srgssr_polis_get_elections	Election results since 1900	Polis API

Supported Business Units

Code	Unit	Language
srf	SRF (Schweizer Radio und Fernsehen)	German
rts	RTS (Radio Télévision Suisse)	French
rsi	RSI (Radiotelevisione svizzera)	Italian
rtr	RTR (Radiotelevisiun Svizra Rumantscha)	Romansh
swi	SWI swissinfo.ch	Multilingual

Example Use Cases

Query	Tool
"Weather in Zurich tomorrow?"	srgssr_weather_forecast_24h
"What's on SRF 1 tonight?"	srgssr_epg_get_programs
"Latest Tagesschau episodes?"	srgssr_video_get_episodes
"Popular votes in Canton Bern 2010–2020?"	srgssr_polis_get_votations
"Cantonal results of the mask initiative vote?"	srgssr_polis_get_votation_results
"All current RTS radio shows?"	srgssr_audio_get_shows

---

Architecture

┌─────────────────┐     ┌───────────────────────────┐     ┌──────────────────────────┐
│   Claude / AI   │────▶│       srgssr-mcp           │────▶│    SRG SSR APIs          │
│   (MCP Host)    │◀────│       (MCP Server)         │◀────│                          │
└─────────────────┘     │                           │     │  SRF Meteo (Weather)     │
                        │  14 Tools                 │     │  Integration Layer (A/V) │
                        │  Stdio | SSE              │     │  Polis (Democracy)       │
                        │                           │     │  developer.srgssr.ch     │
                        │  OAuth2 token mgmt        │     └──────────────────────────┘
                        │  server.py (FastMCP)       │
                        └───────────────────────────┘

Data Sources

Source	Data	Access
developer.srgssr.ch	SRG SSR PUBLIC API V2 (weather, A/V, EPG, Polis)	OAuth2 (free registration)

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

---

Project Structure

srgssr-mcp/
├── src/srgssr_mcp/
│   ├── __init__.py          # Package
│   └── server.py            # FastMCP server: 14 tools, OAuth2 client
├── .github/
│   └── workflows/
│       └── ci.yml           # GitHub Actions CI (Python 3.11–3.13)
├── pyproject.toml           # Build configuration (hatchling)
├── CHANGELOG.md
├── CONTRIBUTING.md          # English
├── CONTRIBUTING.de.md       # German
├── LICENSE                  # MIT
├── README.md                # This file (English)
└── README.de.md             # German version

---

Known Limitations

• API keys required – unlike other portfolio servers, SRG SSR APIs require free OAuth2 credentials
• Non-commercial use – the SRG SSR API terms restrict commercial use without explicit permission
• Rate limits – the SRG SSR API may enforce rate limits depending on your application tier
• Weather data – SRF Meteo covers Switzerland only

---

Testing

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

# Integration tests (requires SRG SSR API keys)
PYTHONPATH=src pytest tests/ -m "live"

# Linting
ruff check src/

---

Contributing

See CONTRIBUTING.md

---

Changelog

See CHANGELOG.md

---

License

MIT License — see LICENSE

The SRG SSR APIs used in this project are subject to the SRG SSR Terms of Use.

---

Author

Hayal Oezkan · github.com/malkreide

---

Credits & Related Projects

• Data: SRG SSR Developer Portal · SRF Meteo · Polis API
• Protocol: Model Context Protocol – Anthropic / Linux Foundation
• Related:

Server	Description
zurich-opendata-mcp	City of Zurich open data (OSTLUFT air quality, weather, parking, geodata)
swiss-transport-mcp	Swiss public transport – OJP 2.0 journey planning, SIRI-SX disruptions
swiss-environment-mcp	BAFU environmental data – air quality, hydrology, natural hazards
swiss-statistics-mcp	BFS STAT-TAB – 682 statistical datasets
fedlex-mcp	Swiss federal law via Fedlex SPARQL

Synergy example: "What were the results of the 2020 popular votes in Canton Zurich – and how did turnout compare to the national average?" → srgssr-mcp (Polis, cantonal results) + swiss-statistics-mcp (BFS, turnout data)

• Portfolio: Swiss Public Data MCP Portfolio