Skip to main content
Glama
README.md
<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**

[![npm](https://img.shields.io/npm/v/mcp-swiss.svg?style=flat-square)](https://www.npmjs.com/package/mcp-swiss)
[![CI](https://img.shields.io/github/actions/workflow/status/vikramgorla/mcp-swiss/ci.yml?style=flat-square&label=CI)](https://github.com/vikramgorla/mcp-swiss/actions/workflows/ci.yml)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](https://opensource.org/licenses/MIT)
[![MCP](https://img.shields.io/badge/MCP-compatible-D52B1E?style=flat-square)](https://modelcontextprotocol.io)
[![Downloads](https://img.shields.io/npm/dm/mcp-swiss.svg?style=flat-square)](https://www.npmjs.com/package/mcp-swiss)
[![Stars](https://img.shields.io/github/stars/vikramgorla/mcp-swiss?style=flat-square)](https://github.com/vikramgorla/mcp-swiss)
[![Node](https://img.shields.io/node/v/mcp-swiss?style=flat-square)](https://nodejs.org)
[![.mcpb](https://img.shields.io/badge/.mcpb-One--Click_Install-D52B1E?style=flat-square)](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
[![Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install-D52B1E?style=flat-square&logo=anthropic&logoColor=white)](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
[![MCP Registry](https://img.shields.io/badge/MCP_Registry-io.github.vikramgorla%2Fswiss-D52B1E?style=flat-square)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.vikramgorla/swiss)
[![Awesome MCP Servers](https://img.shields.io/badge/Awesome-MCP_Servers-fc60a8?style=flat-square&logo=awesomelists&logoColor=white)](https://github.com/punkpeye/awesome-mcp-servers#data-platforms)
[![Glama](https://glama.ai/mcp/servers/vikramgorla/mcp-swiss/badges/score.svg)](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)

[![Install in Claude Desktop](https://img.shields.io/badge/Install_in_Claude_Desktop-D52B1E?style=for-the-badge&logo=anthropic&logoColor=white)](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

B3/5.0

Scored across 94 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count2/5

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.

Completeness4/5

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.

Maintenance

ActivityActive
ResponsivenessNo recent community issues