<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

Install · Tools · Demo · Data Sources

</div>

mcp-swiss is a Model Context Protocol 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

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

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

{
  "mcpServers": {
    "swiss": {
      "command": "npx",
      "args": ["-y", "mcp-swiss"]
    }
  }
}

Restart Claude Desktop after saving.

Claude Code (CLI)

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:

{
  "mcpServers": {
    "swiss": {
      "command": "npx",
      "args": ["-y", "mcp-swiss"]
    }
  }
}

Option B: Global config — create ~/.cursor/mcp.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"> <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">

#### CLI Install

# 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):

{
  "mcp": {
    "servers": {
      "swiss": {
        "command": "npx",
        "args": ["-y", "mcp-swiss"]
      }
    }
  }
}

Or add to .vscode/mcp.json in your workspace (shareable with your team):

{
  "servers": {
    "swiss": {
      "command": "npx",
      "args": ["-y", "mcp-swiss"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/model_config.json:

{
  "mcpServers": {
    "swiss": {
      "command": "npx",
      "args": ["-y", "mcp-swiss"]
    }
  }
}

Cline (VS Code)

Open VS Code settings.json and add:

{
  "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:

{
  "command": "npx",
  "args": ["-y", "mcp-swiss"]
}

This works with any MCP-compatible client — just plug it in.

Docker

docker pull vikramgorla/mcp-swiss

Use with any MCP client that supports Docker-based servers. The container uses stdio transport:

# Run directly (stdio)
docker run -i vikramgorla/mcp-swiss

# Use with Claude Desktop

For Claude Desktop, update your config to use Docker:

{
  "mcpServers": {
    "swiss": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "vikramgorla/mcp-swiss"]
    }
  }
}

Also available on GitHub Container Registry:

docker pull ghcr.io/vikramgorla/mcp-swiss

Streamable HTTP

stdio is still the default. For a local HTTP client, run:

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. 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):

{
  "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

{
  "mcpServers": {
    "swiss": {
      "command": "npx",
      "args": ["-y", "mcp-swiss", "--modules", "transport,weather"]
    }
  }
}

Use presets

{
  "mcpServers": {
    "swiss": {
      "command": "npx",
      "args": ["-y", "mcp-swiss", "--preset", "commuter"]
    }
  }
}

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:

Tools

94 tools across 27 modules. Full specifications: docs/tool-specs.md · Machine-readable: docs/tools.schema.json

🚆 Transport (5 tools)

🌤️ Weather & Hydrology (6 tools)

🗺️ Geodata / swisstopo (6 tools)

🏢 Companies / ZEFIX (5 tools)

🎄 Holidays (3 tools)

🏛️ Parliament (9 tools) — OpenParlData.ch

🏔️ Avalanche (2 tools)

💨 Air Quality (2 tools)

📮 Swiss Post (4 tools)

⚡ Energy Prices (3 tools)

📊 Statistics / BFS (3 tools)

🏦 SNB Exchange Rates (3 tools)

♻️ Recycling / Waste Collection (3 tools)

📰 Swiss News (2 tools)

🗳️ Voting (3 tools)

🌊 Dams & Reservoirs (3 tools)

🥾 Hiking / Trail Closures (2 tools)

🏠 Buildings / GWR (3 tools)

🏠 Real Estate (3 tools)

🚗 Traffic / ASTRA (3 tools)

🌍 Earthquakes / SED (3 tools)

❄️ Snow Conditions / SLF (3 tools)

🌿 Pollen / MeteoSwiss (3 tools)

📂 Open Data Catalogue (3 tools)

🌡️ MeteoSwiss OGD (3 tools)

🧭 Map Layers / geo.admin (3 tools)

🚉 SBB Open Data (3 tools)

Data Sources

All official Swiss open data — no API keys required:

Development

# 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

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