mcp-swiss
<div align="center">
<img src="assets/icon.svg" width="120" height="120" alt="mcp-swiss" />
# mcp-swiss
**Swiss open data for AI — zero config, zero API keys**
[](https://www.npmjs.com/package/mcp-swiss)
[](https://github.com/vikramgorla/mcp-swiss/actions/workflows/ci.yml)
[](https://opensource.org/licenses/MIT)
[](https://modelcontextprotocol.io)
[](https://www.npmjs.com/package/mcp-swiss)
[](https://github.com/vikramgorla/mcp-swiss)
[](https://nodejs.org)
[](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
[](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vikramgorla/swiss)
[](https://github.com/punkpeye/awesome-mcp-servers#data-platforms)
[](https://glama.ai/mcp/servers/vikramgorla/mcp-swiss)
[Install](#installation) · [Tools](#tools) · [Demo](#demo-prompts) · [Data Sources](#data-sources)
</div>
---
`mcp-swiss` is a [Model Context Protocol](https://modelcontextprotocol.io) server that gives any AI assistant direct access to Swiss open data — trains, weather, rivers, maps, and companies.
**94 tools. No API keys. No registration. No server to run. Just `npx mcp-swiss`.**
```
🚆 Transport — SBB, PostBus, trams, live departures, journey planning
🌤️ Weather — MeteoSwiss live conditions + historical data
🌊 Hydrology — BAFU river & lake levels (great for Aare swimming!)
🗺️ Geodata — swisstopo geocoding, solar potential, geographic layers
🏢 Companies — ZEFIX federal registry, all 700K+ Swiss companies
🎄 Holidays — Swiss public & school holidays by canton
🏛️ Parliament — Bills, votes, members, speeches, cantonal affairs (OpenParlData.ch)
🏔️ Avalanche — SLF danger bulletins and warning regions
💨 Air Quality — NABEL stations, Swiss legal limits (LRV)
📮 Swiss Post — Postcode lookup and parcel tracking
⚡ Energy — Electricity tariffs by municipality (ElCom)
📊 Statistics — Population, demographics, BFS datasets
🏦 SNB Rates — Swiss National Bank CHF exchange rates, historical data
♻️ Recycling — Zurich city waste collection calendar (OpenERZ)
📰 Swiss News — SRF news headlines and keyword search
🗳️ Voting — Swiss popular vote results (Basel-Stadt open data)
🌊 Dams — Swiss federal dam registry (SFOE/swisstopo)
🥾 Hiking — Swiss trail closures and hiking alerts (swisstopo)
🏠 Real Estate — Swiss property prices, rent index, housing data (BFS)
🚗 Traffic — ASTRA counting stations, daily volumes
🌍 Earthquakes — Swiss Seismological Service (SED/ETH Zürich), FDSN API
❄️ Snow — SLF snow depth, stations, and measurements
🌿 Pollen — MeteoSwiss pollen concentrations at the published stations
🏠 Buildings — Federal register of buildings and dwellings (GWR)
📂 Catalogue — opendata.swiss dataset search, metadata, and downloads
🌡️ Meteo OGD — SwissMetNet stations and measurements (STAC CSV)
🧭 Map layers — geo.admin layer search, identify, and attribute find
🚉 SBB Data — station passengers, punctuality, and step-free access
```
---
## Installation
### Quick Start
```bash
npx mcp-swiss
```
That's it. No API keys, no `.env` files, no accounts. Pick your client below and paste the config.
---
### One-Click Install (.mcpb)
`.mcpb` bundles work with Claude Desktop and any MCP Bundle-compatible app.
[**⬇ Download mcp-swiss.mcpb**](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
[](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
Open the downloaded file — your app handles the rest. No config editing, no terminal, no API keys.
---
### Claude Desktop
Edit your config file:
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
- **Linux:** `~/.config/Claude/claude_desktop_config.json`
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
```
Restart Claude Desktop after saving.
---
### Claude Code (CLI)
```bash
claude mcp add swiss -- npx -y mcp-swiss
```
That's it — Claude Code will use it in your next session.
---
### Cursor
> Requires Cursor 0.45.6+
**Option A: Project config** — create `.cursor/mcp.json` in your project root:
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
```
**Option B: Global config** — create `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
```
**Option C: Via Cursor Settings UI**
1. Open Cursor Settings
2. Go to **Features → MCP Servers**
3. Click **+ Add new global MCP server**
4. Paste the JSON config above
---
### VS Code (GitHub Copilot)
#### One-click Install
[<img src="https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code">](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522swiss%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522mcp-swiss%2522%255D%257D)
[<img src="https://img.shields.io/badge/VS_Code_Insiders-Install_Server-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white" alt="Install in VS Code Insiders">](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522swiss%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522mcp-swiss%2522%255D%257D)
#### CLI Install
```bash
# VS Code
code --add-mcp '{"name":"swiss","command":"npx","args":["-y","mcp-swiss"]}'
# VS Code Insiders
code-insiders --add-mcp '{"name":"swiss","command":"npx","args":["-y","mcp-swiss"]}'
```
#### Manual Config
Add to your VS Code User Settings (JSON) — press `Ctrl+Shift+P` → `Preferences: Open User Settings (JSON)`:
```json
{
"mcp": {
"servers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
}
```
Or add to `.vscode/mcp.json` in your workspace (shareable with your team):
```json
{
"servers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
```
---
### Windsurf
Add to `~/.codeium/windsurf/model_config.json`:
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
```
---
### Cline (VS Code)
Open VS Code `settings.json` and add:
```json
{
"cline.mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
}
}
```
---
### Any MCP Client
`mcp-swiss` uses **stdio transport** and requires no environment variables. Upstream calls time out after 30 seconds (`MCP_SWISS_TIMEOUT_MS` overrides that) and retry once on a dropped connection or a rate limit. The universal config:
```json
{
"command": "npx",
"args": ["-y", "mcp-swiss"]
}
```
This works with any MCP-compatible client — just plug it in.
### Docker
```bash
docker pull vikramgorla/mcp-swiss
```
Use with any MCP client that supports Docker-based servers. The container uses stdio transport:
```bash
# Run directly (stdio)
docker run -i vikramgorla/mcp-swiss
# Use with Claude Desktop
```
For Claude Desktop, update your config to use Docker:
```json
{
"mcpServers": {
"swiss": {
"command": "docker",
"args": ["run", "-i", "--rm", "vikramgorla/mcp-swiss"]
}
}
}
```
Also available on GitHub Container Registry:
```bash
docker pull ghcr.io/vikramgorla/mcp-swiss
```
---
## Streamable HTTP
stdio is still the default. For a local HTTP client, run:
```bash
npx mcp-swiss --http
```
That listens on `127.0.0.1:3000` and serves MCP at `POST /mcp` (also `GET` and `DELETE`) plus `GET /health`. `--port`, `--host`, `PORT`, `HOST`, and `MCP_TRANSPORT=http` are the other switches.
A bind that is not loopback (`127.0.0.1`, `localhost`, or `::1`) refuses to start unless both `MCP_AUTH_TOKEN` and `MCP_ALLOWED_HOSTS` are set. Sessions are capped (`MCP_MAX_SESSIONS`, default 64) and idle ones expire. This is the transport half of [#64](https://github.com/vikramgorla/mcp-swiss/issues/64). It does not deploy a hosted instance.
---
## Module Filtering
By default, mcp-swiss loads all 27 modules (94 tools). The full `tools/list` schema is about 9,300 tokens (37,011 characters). For a smaller startup list, load only the modules you need.
### Discovery mode
Search, then execute. The server lists three meta-tools instead of every schema (about 330 tokens versus about 9,300):
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss", "--discovery"]
}
}
}
```
`MCP_SWISS_MODE=discovery` and `--mode discovery` do the same thing. `swiss_search_tools` finds tools by keyword or module and returns their input schemas. `swiss_call_tool` checks those arguments, then runs the tool. `swiss_list_modules` is the catalog. The default, with no flag, is still the full tool list.
### Select specific modules
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss", "--modules", "transport,weather"]
}
}
}
```
### Use presets
```json
{
"mcpServers": {
"swiss": {
"command": "npx",
"args": ["-y", "mcp-swiss", "--preset", "commuter"]
}
}
}
```
| Preset | Modules | Tools | Token Savings |
|--------|---------|-------|---------------|
| `commuter` | transport, weather, holidays | 14 | 83% |
| `outdoor` | weather, avalanche, hiking, earthquakes, dams, snow, pollen | 22 | 74% |
| `business` | companies, geodata, post, energy, statistics, snb, gwr | 27 | 68% |
| `citizen` | parliament, voting, holidays, news | 17 | 80% |
| `minimal` | transport | 5 | 94% |
| `full` | all 27 modules (default) | 94 | — |
Combine preset + modules: `--preset commuter --modules parliament`
List available: `npx mcp-swiss --list-modules` or `npx mcp-swiss --list-presets`
---
## Demo Prompts
Once connected, try asking your AI:
| Prompt | What it uses |
|--------|-------------|
| *"Next 5 trains from Zürich HB to Geneva"* | `get_connections` |
| *"Is the Aare in Bern warm enough to swim?"* | `get_water_level` |
| *"Weather in Lugano vs Zürich today"* | `get_weather` |
| *"Find blockchain companies registered in Zug"* | `search_companies` |
| *"Solar potential of Bundesplatz 3, Bern"* | `geocode` + `get_solar_potential` |
| *"Live departures from Bern HB"* | `get_departures` |
| *"What rivers are near Thun?"* | `list_hydro_stations` + `get_water_level` |
| *"Plan my Saturday: train to Interlaken, check weather"* | Multiple tools chained |
| *"Is next Monday a holiday in Zürich?"* | `get_public_holidays` |
| *"What did the Swiss parliament vote on recently?"* | `search_parliament_business` |
| *"What's the avalanche danger level in the Bernese Alps?"* | `get_avalanche_bulletin` |
| *"What's the postcode for Zermatt?"* | `search_postcode` |
| *"Track my Swiss Post parcel 99.12.345678.12345678"* | `track_parcel` |
| *"How much does electricity cost in Zürich vs Basel?"* | `search_municipality_energy` + `compare_electricity_tariffs` |
| *"What's the population of canton Zug?"* | `get_population` |
---
## Tools
> 94 tools across 27 modules. Full specifications: [`docs/tool-specs.md`](docs/tool-specs.md) · Machine-readable: [`docs/tools.schema.json`](docs/tools.schema.json)
### 🚆 Transport (5 tools)
| Tool | Description |
|------|-------------|
| `search_stations` | Find stations/stops by name or location |
| `get_connections` | Journey planner between any two points |
| `get_departures` | Live departures from a station |
| `get_arrivals` | Live arrivals at a station |
| `get_nearby_stations` | Stations near coordinates |
### 🌤️ Weather & Hydrology (6 tools)
| Tool | Description |
|------|-------------|
| `get_weather` | Current conditions at a MeteoSwiss station |
| `list_weather_stations` | All ~160 MeteoSwiss stations with metadata |
| `get_weather_history` | Historical weather data (up to 32 days) |
| `get_water_level` | River/lake level + temperature (BAFU) |
| `list_hydro_stations` | All 400+ hydrological monitoring stations |
| `get_water_history` | Historical hydrology data |
### 🗺️ Geodata / swisstopo (6 tools)
| Tool | Description |
|------|-------------|
| `geocode` | Swiss address → coordinates |
| `reverse_geocode` | Coordinates → Swiss address |
| `search_places` | Swiss place names, mountains, lakes, features |
| `get_solar_potential` | Rooftop solar irradiation at a location |
| `identify_location` | All geographic data layers at a point |
| `get_municipality` | Municipality info by name |
### 🏢 Companies / ZEFIX (5 tools)
| Tool | Description |
|------|-------------|
| `search_companies` | Search by name, canton, legal form |
| `get_company` | Full company details by ZEFIX `ehraid` |
| `search_companies_by_locality` | Companies seated in a commune or town (ZEFIX has no street search) |
| `list_cantons` | All 26 Swiss cantons |
| `list_legal_forms` | AG, GmbH, and all Swiss legal forms |
### 🎄 Holidays (3 tools)
| Tool | Description |
|------|-------------|
| `get_public_holidays` | Swiss public holidays by year, optionally filtered by canton |
| `get_school_holidays` | School holiday periods by year and canton |
| `is_holiday_today` | Quick check if today is a public holiday |
### 🏛️ Parliament (9 tools) — [OpenParlData.ch](https://openparldata.ch)
| Tool | Description |
|------|-------------|
| `search_parliament_business` | Search federal political affairs (bills, motions, questions) |
| `get_parliament_members` | List parliament members by canton, party, or activity |
| `get_parliament_votes` | Voting results for a specific affair |
| `get_session_schedule` | Upcoming/recent parliament sessions |
| `search_parliament_speeches` | Debate speeches for an affair |
| `get_politician_interests` | Declared interests and mandates of a member |
| `search_cantonal_affairs` | Search across 26 cantonal parliaments |
| `get_parliamentary_documents` | Official documents for an affair |
| `get_committee_meetings` | Committee/commission meeting schedule |
### 🏔️ Avalanche (2 tools)
| Tool | Description |
|------|-------------|
| `get_avalanche_bulletin` | Live SLF bulletin: danger level, problems, advice for a region or coordinate |
| `list_avalanche_regions` | The 135 SLF/EAWS warning regions |
### 💨 Air Quality (2 tools)
| Tool | Description |
|------|-------------|
| `list_air_quality_stations` | All 16 NABEL monitoring stations, plus any code the live layer adds |
| `get_air_quality` | Station info, Swiss legal limits (LRV), and BAFU data links |
### 📮 Swiss Post (4 tools)
| Tool | Description |
|------|-------------|
| `lookup_postcode` | PLZ → locality, canton, coordinates |
| `search_postcode` | City name → matching postcodes |
| `list_postcodes_in_canton` | All postcodes in a canton |
| `track_parcel` | Generate Swiss Post tracking URL for a parcel |
### ⚡ Energy Prices (3 tools)
| Tool | Description |
|------|-------------|
| `get_electricity_tariff` | Electricity tariff by municipality with component breakdown |
| `compare_electricity_tariffs` | Compare electricity prices across municipalities |
| `search_municipality_energy` | Find municipality ID for tariff lookup |
### 📊 Statistics / BFS (3 tools)
| Tool | Description |
|------|-------------|
| `get_population` | Population by canton or municipality from BFS STATPOP |
| `search_statistics` | Search BFS datasets on opendata.swiss |
| `get_statistic` | Fetch detailed dataset information |
### 🏦 SNB Exchange Rates (3 tools)
| Tool | Description |
|------|-------------|
| `list_currencies` | List all currencies available from the Swiss National Bank (SNB) |
| `get_exchange_rate` | Get the current CHF exchange rate for any currency |
| `get_exchange_rate_history` | Get historical monthly CHF exchange rates with date filtering |
### ♻️ Recycling / Waste Collection (3 tools)
| Tool | Description |
|------|-------------|
| `get_waste_collection` | Next waste collection dates by Zurich ZIP code and waste type |
| `list_waste_types` | List all supported waste types with descriptions |
| `get_waste_calendar` | Full waste collection calendar for a ZIP code (upcoming dates) |
### 📰 Swiss News (2 tools)
| Tool | Description |
|------|-------------|
| `get_swiss_news` | Latest Swiss headlines from SRF by category (Switzerland/international/economy) |
| `search_swiss_news` | Search SRF news by keyword across all categories |
### 🗳️ Voting (3 tools)
| Tool | Description |
|------|-------------|
| `get_voting_results` | Swiss popular vote results from Basel-Stadt open data |
| `search_votes` | Search popular votes by keyword (German/French/Italian) |
| `get_vote_details` | Detailed per-district breakdown of a specific vote |
### 🌊 Dams & Reservoirs (3 tools)
| Tool | Description |
|------|-------------|
| `search_dams` | Search Swiss federal dams by name or keyword |
| `get_dams_by_canton` | List all federal dams in a canton |
| `get_dam_details` | Detailed info on a specific dam (height, volume, purpose) |
### 🥾 Hiking / Trail Closures (2 tools)
| Tool | Description |
|------|-------------|
| `get_trail_closures` | Swiss trail closures and hiking alerts from swisstopo |
| `get_trail_closures_nearby` | Trail closures near given coordinates |
### 🏠 Buildings / GWR (3 tools)
| Tool | Description |
|------|-------------|
| `search_buildings` | Find buildings in the federal register (GWR) by address and return EGIDs |
| `get_building` | Full building record by EGID: year, floors, heating, parcel, entrances, dwellings |
| `buildings_near` | Buildings nearest a WGS84 point, closest first |
### 🏠 Real Estate (3 tools)
| Tool | Description |
|------|-------------|
| `get_property_price_index` | Swiss property price index (BFS Immo-Monitoring) |
| `search_real_estate_data` | Search BFS real estate datasets on opendata.swiss |
| `get_rent_index` | Swiss rent index and housing cost data from BFS |
### 🚗 Traffic / ASTRA (3 tools)
| Tool | Description |
|------|-------------|
| `get_traffic_count` | Traffic counting station data (ASTRA) — daily volumes and heavy traffic share |
| `get_traffic_by_canton` | List ASTRA traffic counting stations filtered by canton |
| `get_traffic_nearby` | Find traffic counting stations near given coordinates |
### 🌍 Earthquakes / SED (3 tools)
| Tool | Description |
|------|-------------|
| `get_recent_earthquakes` | Recent seismic events in/around Switzerland from the Swiss Seismological Service (SED) at ETH Zürich |
| `get_earthquake_details` | Full details for a specific seismic event by SED event ID |
| `search_earthquakes_by_location` | Earthquakes near given coordinates with configurable radius, time range, and limit |
### ❄️ Snow Conditions / SLF (3 tools)
| Tool | Description |
|------|-------------|
| `get_snow_conditions` | Current snow depth and new snow (24h) across Switzerland from SLF IMIS stations, filterable by canton/altitude |
| `list_snow_stations` | All 307 SLF snow measurement stations (IMIS automatic + manual study plots) |
| `get_snow_measurements` | Detailed snow and weather measurements for a specific SLF station |
### 🌿 Pollen / MeteoSwiss (3 tools)
| Tool | Description |
|------|-------------|
| `get_pollen_current` | Current hourly pollen concentrations at a published MeteoSwiss station |
| `get_pollen_daily` | Daily pollen averages over a configurable range |
| `list_pollen_stations` | Published MeteoSwiss pollen stations (the list is no longer a frozen 16) |
### 📂 Open Data Catalogue (3 tools)
| Tool | Description |
|------|-------------|
| `search_opendata` | Search the opendata.swiss catalogue (CKAN) by keyword, optionally limited to one publisher |
| `get_opendata_dataset` | Metadata for one dataset: publisher, description, keywords, and a short resource summary |
| `list_opendata_resources` | Download links and services for a dataset, with an optional format filter |
### 🌡️ MeteoSwiss OGD (3 tools)
| Tool | Description |
|------|-------------|
| `list_ogd_stations` | Stations in a MeteoSwiss OGD STAC collection (SwissMetNet by default, plus precipitation, climate, phenology, and totaliser networks) |
| `get_ogd_recent` | Latest measurements for one station, parsed from the now/recent CSV asset |
| `get_ogd_history` | Historical measurements for a date range, parsed from the historical or recent CSV assets |
### 🧭 Map Layers / geo.admin (3 tools)
| Tool | Description |
|------|-------------|
| `search_map_layers` | Search or list layers in the geo.admin ech MapServer catalogue |
| `identify_map_layer` | Features at a WGS84 point on one layer, keeping the current version of time-series layers |
| `find_map_features` | Find features on one layer by attribute value |
### 🚉 SBB Open Data (3 tools)
| Tool | Description |
|------|-------------|
| `get_station_passengers` | Average daily, weekday, and weekend boardings and alightings at an SBB station |
| `get_station_punctuality` | Previous-day arrival and departure punctuality, delays, and cancellations |
| `get_station_accessibility` | Platform length and rail-free (step-free) access |
---
## Data Sources
All official Swiss open data — no API keys required:
| Source | Data | Docs |
|--------|------|------|
| [transport.opendata.ch](https://transport.opendata.ch) | SBB, PostBus, trams | [API docs](http://transport.opendata.ch/docs.html) |
| [api.existenz.ch](https://api.existenz.ch) | MeteoSwiss weather + BAFU hydrology | [API docs](https://api.existenz.ch) |
| [api3.geo.admin.ch](https://api3.geo.admin.ch) | swisstopo federal geodata | [API docs](https://api3.geo.admin.ch/api/doc.html) |
| [zefix.admin.ch](https://www.zefix.admin.ch) | Federal company registry | [Swagger](https://www.zefix.admin.ch/ZefixREST/swagger-ui.html) |
| [openholidaysapi.org](https://openholidaysapi.org) | Swiss public & school holidays | [API docs](https://openholidaysapi.org/swagger) |
| [OpenParlData.ch](https://openparldata.ch) | Swiss Parliament data — federal & cantonal (CC BY 4.0) | [API docs](https://api.openparldata.ch/documentation) |
| [whiterisk.ch](https://whiterisk.ch) / [aws.slf.ch](https://aws.slf.ch) | SLF/WSL avalanche bulletins | [SLF](https://www.slf.ch/en/avalanche-bulletin-and-snow-situation.html) |
| [geo.admin.ch](https://api3.geo.admin.ch) — BAFU/NABEL | Swiss air quality monitoring stations | [BAFU NABEL](https://www.bafu.admin.ch/bafu/en/home/topics/air/state/data/nabel.html) |
| [geo.admin.ch](https://api3.geo.admin.ch) — swisstopo | Swiss postcodes (Amtliches Ortschaftenverzeichnis) | [geo.admin.ch](https://api3.geo.admin.ch/api/doc.html) |
| [strompreis.elcom.admin.ch](https://strompreis.elcom.admin.ch) | ElCom electricity tariffs by municipality | [ElCom](https://www.elcom.admin.ch/elcom/en/home.html) |
| [pxweb.bfs.admin.ch](https://www.pxweb.bfs.admin.ch) + [opendata.swiss](https://opendata.swiss) | BFS population statistics (STATPOP) + datasets | [BFS](https://www.bfs.admin.ch/bfs/en/home/statistics/population.html) |
| [data.snb.ch](https://data.snb.ch) | Swiss National Bank CHF exchange rates | [SNB data portal](https://data.snb.ch/en) |
| [openerz.metaodi.ch](https://openerz.metaodi.ch) | Zurich waste collection calendar (OpenERZ) | [OpenERZ](https://openerz.metaodi.ch) |
| [srf.ch](https://www.srf.ch) | SRF Swiss news headlines | [SRF](https://www.srf.ch/news) |
| [data.bs.ch](https://data.bs.ch) | Basel-Stadt popular vote results | [Open Data BS](https://data.bs.ch) |
| [geo.admin.ch](https://api3.geo.admin.ch) — SFOE | Swiss federal dam registry | [SFOE](https://www.bfe.admin.ch) |
| [geo.admin.ch](https://api3.geo.admin.ch) — swisstopo | Swiss trail closures and hiking alerts | [swisstopo](https://www.swisstopo.admin.ch) |
| [pxweb.bfs.admin.ch](https://www.pxweb.bfs.admin.ch) | BFS property prices + rent index | [BFS housing](https://www.bfs.admin.ch/bfs/en/home/statistics/construction-housing.html) |
| [geo.admin.ch](https://api3.geo.admin.ch) — ASTRA | Traffic counting stations + daily volumes | [ASTRA](https://www.astra.admin.ch) |
| [arclink.ethz.ch](http://arclink.ethz.ch) | Swiss Seismological Service earthquakes (SED/ETH) | [SED](http://www.seismo.ethz.ch) |
| [measurement-api.slf.ch](https://measurement-api.slf.ch/public/api) | SLF snow depth + measurements (IMIS + study plots, CC BY 4.0) | [SLF](https://www.slf.ch) |
| [data.geo.admin.ch](https://data.geo.admin.ch/ch.meteoschweiz.ogd-pollen/) | MeteoSwiss pollen concentrations (16 automatic stations, CC BY) | [MeteoSwiss](https://www.meteoswiss.admin.ch) |
| [api3.geo.admin.ch](https://api3.geo.admin.ch/rest/services/ech/MapServer) | Federal map layers: search, identify, and attribute find | [geo.admin API](https://api3.geo.admin.ch/api/doc.html) |
| [data.geo.admin.ch STAC](https://data.geo.admin.ch/api/stac/v1/collections/ch.meteoschweiz.ogd-smn) | MeteoSwiss OGD station measurements (CSV assets, CC BY) | [MeteoSwiss open data](https://www.meteoswiss.admin.ch/services-and-publications/service/open-data.html) |
| [ckan.opendata.swiss](https://ckan.opendata.swiss/api/3/action/) | National open data catalogue (datasets and resources) | [opendata.swiss](https://opendata.swiss) |
| [data.sbb.ch](https://data.sbb.ch/api/explore/v2.1/) | SBB station passengers, punctuality, and platform accessibility | [SBB Open Data](https://data.sbb.ch/) |
---
## Development
```bash
# Clone
git clone https://github.com/vikramgorla/mcp-swiss.git
cd mcp-swiss
# Install deps
npm install
# Build
npm run build
# Run in dev mode
npm run dev
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node dist/index.js
```
### Testing
```bash
npm test
```
---
## Contributing
We welcome contributions! mcp-swiss follows a strict PR-based workflow to keep the codebase clean and CI always green.
### Quick links
- **[`CONTRIBUTING.md`](CONTRIBUTING.md)** — full contributor guide:
- Development setup (clone, install, build, test)
- Branch model (develop / main / feature branches)
- Hard workflow rules (no direct pushes, always PRs, regular merge only)
- Adding a new module (step-by-step with code templates)
- Integration checklist (all files to update)
- Code standards (TypeScript, no `any`, 50K response limit, zero API keys)
- **[`RELEASING.md`](RELEASING.md)** — release process for maintainers:
- Step-by-step release workflow
- Pre-release checklist
- Version strategy (minor for features, patch for fixes)
- Post-release verification
- CI/CD workflow reference (`ci.yml`, `release.yml`, `beta.yml`, `mcp-registry.yml`)
---
## Requirements
- Node.js 20+
- No API keys or accounts needed
- Optional: `MCP_SWISS_TIMEOUT_MS` — per-request upstream timeout in milliseconds (default 30000)
## License
MIT — see [LICENSE](LICENSE)
TDQS
Scored across 94 tools
Most tools map to distinct Swiss data domains, but there are real clusters of near-duplicates: search_opendata / search_statistics / search_real_estate_data all search catalogues, get_weather / get_ogd_recent / get_ogd_history / get_weather_history overlap on MeteoSwiss readings, and search_places / geocode / identify_location / search_map_layers all resolve locations. Descriptions usually clarify the intended boundary (e.g. get_rent_index explicitly disclaims being a rent index, get_traffic_count vs get_traffic_by_canton), which keeps it workable, but an agent must read carefully to pick correctly.
The dominant convention is snake_case verb_noun (get_vote_details, list_pollen_stations, search_companies, compare_electricity_tariffs) applied consistently across most of the 94 tools. Deviations are minor: bare verb names like geocode / reverse_geocode, and noun-first variants like buildings_near. Nothing is camelCase-mixed or chaotic.
94 tools in a single server is far past the practical ceiling; even though each contributes to a genuinely broad 'Swiss public data' scope, the surface is too large to navigate or select from reliably. This is really a federation of ~15 domain servers (weather, transit, parliament, geodata, energy, hazards) bundled into one.
Coverage across the chosen domains is unusually thorough: search plus detail pairs exist for businesses, dams, buildings, datasets, parliament affairs, votes, earthquakes, and stations, with canton/radius filters and supporting lookup tables (list_cantons, list_legal_forms, list_avalanche_regions). Gaps are mostly upstream-imposed dead ends (track_parcel and get_air_quality return only links, no live measurements) rather than missing tool patterns.