Skip to main content

๐Ÿ‡จ๐Ÿ‡ญ Part of the Swiss Public Data MCP Portfolio

๐Ÿ›๏ธ swiss-culture-mcp

Version License: MIT Python 3.11+ MCP Data Source CI

MCP server for Swiss cultural heritage data from the Federal Office of Culture (BAK) โ€” ISOS townscapes, Living Traditions, cultural prizes, press releases. No API key required.

๐ŸŒ English | Deutsch

Demo: Claude queries ISOS townscapes via MCP tool call


Overview

swiss-culture-mcp makes Swiss cultural data accessible to AI assistants. The server connects LLMs like Claude with Switzerland's national cultural heritage: from protected townscapes (ISOS) to living traditions of intangible cultural heritage and current cultural awards.

Sources: geo.admin.ch REST API ยท news.admin.ch RSS ยท opendata.swiss CKAN ยท lebendige-traditionen.ch

No API key required. All data sources are publicly available (Open Government Data).

Anchor demo query: "Which protected townscapes are there in the school districts of the city of Zurich, and what living traditions are practised there?"


Features

  • ๐Ÿ˜๏ธ ISOS search โ€“ Federal Inventory of Swiss Townscapes Worth Protecting by name, canton or settlement type
  • ๐Ÿ“œ Living Traditions โ€“ 228 entries of Swiss intangible cultural heritage
  • ๐Ÿ† Cultural prizes โ€“ Swiss Film Prize, Grand Prix Literature, Music Prize and more
  • ๐Ÿ“ฐ BAK press releases โ€“ current news from the Federal Office of Culture
  • ๐Ÿ“ฆ Open data catalogue โ€“ BAK datasets on opendata.swiss
  • โ˜๏ธ Dual transport โ€“ stdio for Claude Desktop, Streamable HTTP for cloud deployment
# Tool Description
1 bak_search_isos Search ISOS townscapes by place name
2 bak_isos_by_kanton List all ISOS objects in a canton
3 bak_get_isos_detail Get full details of an ISOS object
4 bak_isos_by_kategorie Filter ISOS by settlement type (Stadt, Dorf, etc.)
5 bak_isos_statistics ISOS inventory statistics (sampled by canton)
6 bak_get_news Current BAK press releases
7 bak_get_kulturpreise Swiss cultural prizes (Film Prize, Grand Prix Literature, etc.)
8 bak_get_opendata BAK datasets on opendata.swiss
9 bak_list_traditions List Switzerland's Living Traditions
10 bak_get_tradition_detail Get detailed description of a tradition

3 Resources: bak://isos/kantone ยท bak://isos/kategorien ยท bak://kulturpreise/uebersicht


Data Sources

Source API Type Content
geo.admin.ch REST MapServer ISOS (Federal Inventory of Swiss Townscapes)
news.admin.ch RSS Feed BAK press releases, cultural prizes
opendata.swiss CKAN REST API BAK open data datasets
lebendige-traditionen.ch HTML Fetch 228 entries of intangible cultural heritage

Prerequisites

  • Python 3.11+
  • uv or pip
  • No API keys required

Installation

# Recommended: uvx (no install step needed)
uvx swiss-culture-mcp

# Alternative: pip
pip install swiss-culture-mcp

Quickstart

# Start the server (stdio mode for Claude Desktop)
uvx swiss-culture-mcp

Try it immediately in Claude Desktop:

"Show me all protected townscapes in the canton of Graubรผnden" "Which living traditions are practised in canton Appenzell?" "Which Swiss cultural prizes were awarded in 2026?"


Configuration

Environment Variables

Variable Default Description
MCP_TRANSPORT stdio Transport: stdio or streamable_http
MCP_HOST 127.0.0.1 Bind host for HTTP transport (loopback by default)
MCP_PORT 8000 Port for HTTP transport
MCP_ALLOW_PUBLIC_BIND false If true, permits binding 0.0.0.0 without auth. Set this only behind an authenticating reverse proxy (e.g. Cloudflare Access, oauth2-proxy).
LOG_LEVEL INFO DEBUG, INFO, WARNING, ERROR โ€” structured JSON logs to stderr

Claude Desktop Configuration

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

Config file locations:

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

After restarting Claude Desktop, all tools are available. Example queries:

  • "Show me all protected townscapes in the canton of Graubรผnden"
  • "What is the Alphorn and Bรผchelspiel tradition?"
  • "Which Swiss cultural prizes were awarded in 2026?"
  • "Is the old town of Stein am Rhein in the ISOS inventory?"
  • "Which living traditions are practised in canton Appenzell?"

Cloud Deployment (Streamable HTTP)

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

Render.com (recommended):

  1. Push/fork the repository to GitHub
  2. On render.com: New Web Service โ†’ connect GitHub repo
  3. Set environment variables in the Render dashboard
  4. In claude.ai under Settings โ†’ MCP Servers, add: https://your-app.onrender.com/mcp
# Docker / local HTTP mode (loopback only โ€” safe default)
MCP_TRANSPORT=streamable_http MCP_PORT=8000 python -m swiss_culture_mcp.server

# Public bind (DANGEROUS โ€” only behind an authenticating reverse proxy)
MCP_TRANSPORT=streamable_http MCP_HOST=0.0.0.0 MCP_ALLOW_PUBLIC_BIND=true \
    python -m swiss_culture_mcp.server

โš ๏ธ Security: The server itself has no authentication. Binding to a public interface without an upstream auth layer turns it into an open proxy for the federal data sources. Always run an authenticating reverse proxy (Cloudflare Access, oauth2-proxy, nginx + auth_request) in front of 0.0.0.0 deployments.


Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚   Claude / AI   โ”‚โ”€โ”€โ”€โ”€โ–ถโ”‚   Swiss Culture MCP      โ”‚โ”€โ”€โ”€โ”€โ–ถโ”‚  geo.admin.ch REST       โ”‚
โ”‚   (MCP Host)    โ”‚โ—€โ”€โ”€โ”€โ”€โ”‚   (MCP Server)           โ”‚โ—€โ”€โ”€โ”€โ”€โ”‚  news.admin.ch RSS       โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜     โ”‚                          โ”‚     โ”‚  opendata.swiss CKAN     โ”‚
                        โ”‚  10 Tools ยท 3 Resources  โ”‚     โ”‚  lebendige-traditionen   โ”‚
                        โ”‚  Stdio | Streamable HTTP  โ”‚     โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                        โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Project Structure

swiss-culture-mcp/
โ”œโ”€โ”€ src/
โ”‚   โ””โ”€โ”€ swiss_culture_mcp/
โ”‚       โ”œโ”€โ”€ __init__.py
โ”‚       โ””โ”€โ”€ server.py          # All 10 tools, 3 resources
โ”œโ”€โ”€ tests/
โ”‚   โ”œโ”€โ”€ conftest.py            # pytest configuration
โ”‚   โ””โ”€โ”€ test_server.py         # 36 tests (unit + live)
โ”œโ”€โ”€ pyproject.toml
โ”œโ”€โ”€ CHANGELOG.md
โ”œโ”€โ”€ CONTRIBUTING.md            # Contribution guide (English)
โ”œโ”€โ”€ CONTRIBUTING.de.md         # Contribution guide (German)
โ”œโ”€โ”€ SECURITY.md               # Security policy & posture (English)
โ”œโ”€โ”€ SECURITY.de.md            # Security policy & posture (German)
โ”œโ”€โ”€ LICENSE
โ”œโ”€โ”€ README.md                  # This file (English)
โ””โ”€โ”€ README.de.md               # German version

Testing

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

# Integration tests (live API calls)
PYTHONPATH=src pytest tests/ -m "live"

Example Use Cases

Schools / Education

"Which protected townscapes are there in the school districts of the city of Zurich?"
โ†’ bak_isos_by_kanton(kanton="ZH") + bak_get_isos_detail(...)

"Find living traditions for a project week on the theme of cultural heritage"
โ†’ bak_list_traditions() + bak_get_tradition_detail(slug="...")

"Which UNESCO World Heritage Sites are also in ISOS?"
โ†’ bak_search_isos(query="...") + bak_get_opendata(query="UNESCO")

City Administration / Spatial Planning

"Is the building at address X within an ISOS perimeter?"
โ†’ bak_search_isos(query="community/place name")

"Which BAK datasets are available for GIS integration?"
โ†’ bak_get_opendata() โ†’ WMS/WFS URLs for GIS software

AI Working Group / Demos

"Show current cultural policy of the federal government"
โ†’ bak_get_news() + bak_get_kulturpreise()
โ†’ More use cases by audience โ†’

Safety & Limits

Aspect Details
Access Read-only โ€” the server cannot modify or delete any data
Personal data No personal data โ€” all sources are aggregated, public cultural heritage data
Rate limits Built-in per-query caps (e.g. max 100 ISOS results, 50 news items, 200 category entries)
Timeout 20 seconds per API call
Authentication No API keys required โ€” all 4 data sources are publicly accessible
Licenses All data under open licenses (Open Government Data): geo.admin.ch, opendata.swiss, news.admin.ch
Terms of Service Subject to ToS of the respective data sources: geo.admin.ch, opendata.swiss, news.admin.ch, lebendige-traditionen.ch

Known Limitations

  • ISOS statistics: Sample-based per canton (not exhaustive for all cantons)
  • Living Traditions: HTML scraping โ€“ may break if lebendige-traditionen.ch changes its structure
  • BAK news/prizes: RSS feed limited to the most recent entries
  • opendata.swiss CKAN: Full-text search may return results from other publishers

Synergies with Other MCP Servers

swiss-culture-mcp can be combined with other servers in the portfolio:

Combination Use Case
+ swiss-transport-mcp Cultural tourism: day trips to traditions by public transport
+ zurich-opendata-mcp Local cultural atlas: ISOS + Zurich city events
+ global-education-mcp Cultural education in international comparison
+ fedlex-mcp Cultural property transfer act + BAK enforcement practice
+ swiss-statistics-mcp Cultural expenditure by canton (BFS data)

Changelog

See CHANGELOG.md


Contributing

Contributions are welcome โ€” see CONTRIBUTING.md.


Security

Security posture, hardening details and the responsible-disclosure process are documented in SECURITY.md.


License

MIT License โ€” see LICENSE


Author

Hayal Oezkan ยท malkreide


Credits & Related Projects

Installation

Run via uv's uvx โ€” no clone or manual install needed. Add to your MCP client config (mcpServers for Claude Desktop, Cursor and Windsurf; use a top-level servers key for VS Code in .vscode/mcp.json):

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

swiss_culture_mcp-1.1.4.tar.gz (57.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

swiss_culture_mcp-1.1.4-py3-none-any.whl (21.4 kB view details)

Uploaded Python 3

File details

Details for the file swiss_culture_mcp-1.1.4.tar.gz.

File metadata

  • Download URL: swiss_culture_mcp-1.1.4.tar.gz
  • Upload date:
  • Size: 57.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for swiss_culture_mcp-1.1.4.tar.gz
Algorithm Hash digest
SHA256 c64f01bb8e6d6f43b7190ebf17f78f48da550ff9915e5d1bbc776fd90f9b57c4
MD5 1add3e9fe8e24bbba68e20dfba4e40bf
BLAKE2b-256 cc0fcac757cc2c2e9824bdaa036909fd02f8c52c55e42675fa4f2a667fe1b846

See more details on using hashes here.

Provenance

The following attestation bundles were made for swiss_culture_mcp-1.1.4.tar.gz:

Publisher: publish.yml on malkreide/swiss-culture-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file swiss_culture_mcp-1.1.4-py3-none-any.whl.

File metadata

File hashes

Hashes for swiss_culture_mcp-1.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 5388af50832516479c727ad4b9697f7fdbf7698f65c0047eba8ac1e87a2f5643
MD5 a454dceede0625f04abbc219679ea838
BLAKE2b-256 7ab6f605b54405572c19bbe96350dd6f01c55701c13f23bafd5465cb028886a8

See more details on using hashes here.

Provenance

The following attestation bundles were made for swiss_culture_mcp-1.1.4-py3-none-any.whl:

Publisher: publish.yml on malkreide/swiss-culture-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page