Merge pull request #116 from vikramgorla/develop

release: v0.7.0 — SLF snow conditions module

Author: vikramgorla

README.md

@@ -24,7 +24,7 @@
 
 `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.
 
-**73 tools. No API keys. No registration. No server to run. Just `npx mcp-swiss`.**
+**76 tools. No API keys. No registration. No server to run. Just `npx mcp-swiss`.**
 
 ```
 🚆 Transport    — SBB, PostBus, trams, live departures, journey planning
@@ -280,7 +280,7 @@ docker pull ghcr.io/vikramgorla/mcp-swiss
 
 ## Module Filtering
 
-By default, mcp-swiss loads all 20 modules (73 tools). For better token efficiency, load only the modules you need:
+By default, mcp-swiss loads all 21 modules (76 tools). For better token efficiency, load only the modules you need:
 
 ### Select specific modules
 ```json
@@ -309,11 +309,11 @@ By default, mcp-swiss loads all 20 modules (73 tools). For better token efficien
 | Preset | Modules | Tools | Token Savings |
 |--------|---------|-------|---------------|
 | `commuter` | transport, weather, holidays | 14 | 81% |
-| `outdoor` | weather, avalanche, hiking, earthquakes, dams | 16 | 78% |
+| `outdoor` | weather, avalanche, hiking, earthquakes, dams, snow | 19 | 75% |
 | `business` | companies, geodata, post, energy, statistics, snb | 24 | 67% |
 | `citizen` | parliament, voting, holidays, news | 17 | 77% |
 | `minimal` | transport | 5 | 93% |
-| `full` | all 20 modules (default) | 73 | — |
+| `full` | all 21 modules (default) | 76 | — |
 
 Combine preset + modules: `--preset commuter --modules parliament`
 
@@ -347,7 +347,7 @@ Once connected, try asking your AI:
 
 ## Tools
 
-> 73 tools across 20 modules. Full specifications: [`docs/tool-specs.md`](docs/tool-specs.md) · Machine-readable: [`docs/tools.schema.json`](docs/tools.schema.json)
+> 76 tools across 21 modules. Full specifications: [`docs/tool-specs.md`](docs/tool-specs.md) · Machine-readable: [`docs/tools.schema.json`](docs/tools.schema.json)
 
 ### 🚆 Transport (5 tools)
 
@@ -522,6 +522,14 @@ Once connected, try asking your AI:
 | `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 |
+
 ---
 
 ## Data Sources
@@ -550,6 +558,7 @@ All official Swiss open data — no API keys required:
 | [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) |
 
 ---
 

docs/tool-specs.md

@@ -29,6 +29,7 @@
 - [Real Estate Module (3 tools)](#real-estate)
 - [Traffic / ASTRA Module (3 tools)](#traffic)
 - [Earthquakes / SED Module (3 tools)](#earthquakes)
+- [Snow Conditions / SLF Module (3 tools)](#snow-conditions)
 
 ---
 
@@ -2468,5 +2469,50 @@ Search for earthquakes near given coordinates using the SED FDSN API.
 
 ---
 
+---
+
+## Snow Conditions
+
+### `get_snow_conditions`
+
+Get current snow conditions across Switzerland from SLF (WSL Institute for Snow and Avalanche Research). Returns snow depth and new snow (24h) for IMIS stations, sorted by snow depth. Data updated daily.
+
+### Input
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| canton | string | ❌ | Filter by canton abbreviation (e.g. GR, VS, BE, UR, TI) |
+| min_altitude | number | ❌ | Minimum station altitude in metres (e.g. 2000) |
+| limit | number | ❌ | Maximum number of stations to return (default: 20, max: 100) |
+
+---
+
+### `list_snow_stations`
+
+List all SLF snow measurement stations in Switzerland (IMIS automatic stations and manual study plots). Returns station code, name, altitude, canton, and type. Sorted by elevation descending.
+
+### Input
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| canton | string | ❌ | Filter by canton abbreviation (e.g. GR, VS, BE) |
+| type | string | ❌ | Station type: "imis" (automatic) or "study-plot" (manual). Returns both by default |
+| limit | number | ❌ | Maximum number of stations to return (default: 20, max: 200) |
+
+---
+
+### `get_snow_measurements`
+
+Get detailed snow and weather measurements for a specific SLF station. IMIS stations return 30-min data (snow depth, temperature, humidity, wind, radiation). Study plots return daily data (snow depth, new snow, water equivalent).
+
+### Input
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| station_code | string | ✅ | Station code (e.g. DAV2, WFJ2, 4AO0). Use list_snow_stations to find codes |
+| type | string | ❌ | Station type: "imis" (default) or "study-plot". Determines which API endpoint to query |
+
+---
+
 *Specification generated from mcp-swiss source code.*  
-*API sources: transport.opendata.ch, api.existenz.ch, api3.geo.admin.ch, zefix.admin.ch, openholidaysapi.org, ws.parlament.ch, aws.slf.ch/whiterisk.ch, geo.admin.ch (NABEL), service.post.ch, strompreis.elcom.admin.ch, pxweb.bfs.admin.ch, opendata.swiss, data.snb.ch, openerz.metaodi.ch, srf.ch, data.bs.ch, geo.admin.ch (SFOE dams), geo.admin.ch (hiking), api3.geo.admin.ch (ASTRA traffic), arclink.ethz.ch (SED earthquakes)*
+*API sources: transport.opendata.ch, api.existenz.ch, api3.geo.admin.ch, zefix.admin.ch, openholidaysapi.org, ws.parlament.ch, aws.slf.ch/whiterisk.ch, geo.admin.ch (NABEL), service.post.ch, strompreis.elcom.admin.ch, pxweb.bfs.admin.ch, opendata.swiss, data.snb.ch, openerz.metaodi.ch, srf.ch, data.bs.ch, geo.admin.ch (SFOE dams), geo.admin.ch (hiking), api3.geo.admin.ch (ASTRA traffic), arclink.ethz.ch (SED earthquakes), measurement-api.slf.ch (SLF snow)*

docs/tools.schema.json

@@ -1439,6 +1439,51 @@
         }
       },
       "outputExample": { "count": 3, "center": { "lat": 46.948, "lon": 7.447 }, "radius_km": 50, "events": [] }
+    },
+    {
+      "name": "get_snow_conditions",
+      "module": "snow",
+      "description": "Get current snow conditions across Switzerland from SLF (WSL Institute for Snow and Avalanche Research)",
+      "apiSource": "https://measurement-api.slf.ch/public/api",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "canton": { "type": "string" },
+          "min_altitude": { "type": "number" },
+          "limit": { "type": "number" }
+        }
+      },
+      "outputExample": { "count": 20, "stations": [{ "station": "Zermatt", "altitude_m": 3150, "canton": "VS", "snow_depth_cm": 245, "new_snow_24h_cm": 32 }] }
+    },
+    {
+      "name": "list_snow_stations",
+      "module": "snow",
+      "description": "List all SLF snow measurement stations in Switzerland (IMIS automatic + manual study plots)",
+      "apiSource": "https://measurement-api.slf.ch/public/api",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "canton": { "type": "string" },
+          "type": { "type": "string", "enum": ["imis", "study-plot"] },
+          "limit": { "type": "number" }
+        }
+      },
+      "outputExample": { "count": 20, "total_stations": 307, "stations": [{ "code": "DAV2", "name": "Bärentälli", "altitude_m": 2558, "canton": "GR", "type": "imis" }] }
+    },
+    {
+      "name": "get_snow_measurements",
+      "module": "snow",
+      "description": "Detailed snow and weather measurements for a specific SLF station",
+      "apiSource": "https://measurement-api.slf.ch/public/api",
+      "inputSchema": {
+        "type": "object",
+        "required": ["station_code"],
+        "properties": {
+          "station_code": { "type": "string" },
+          "type": { "type": "string", "enum": ["imis", "study-plot"] }
+        }
+      },
+      "outputExample": { "station_code": "DAV2", "type": "imis", "measurements": [{ "time": "2026-03-15T08:30:00Z", "snow_depth_cm": 139, "air_temp_c": -6.8 }] }
     }
   ]
 }

manifest.json

@@ -2,9 +2,9 @@
   "manifest_version": "0.3",
   "name": "mcp-swiss",
   "display_name": "Switzerland MCP \ud83c\udde8\ud83c\udded",
-  "version": "0.6.0",
-  "description": "Swiss open data for AI \u2014 73 tools, zero API keys. Transport, weather, geodata, companies, parliament, and 15 more modules.",
-  "long_description": "mcp-swiss gives any AI assistant direct access to Swiss open data. 73 tools across 20 modules: train schedules (SBB), weather (MeteoSwiss), river levels (BAFU), geodata (swisstopo), company registry (ZEFIX), parliament (OpenParlData.ch), avalanche bulletins, holidays, postal services, electricity prices, population statistics, exchange rates (SNB), recycling schedules, news (SRF), voting results, dam registry, hiking trail alerts, real estate data, traffic counts, and earthquake monitoring. All APIs are free and require zero authentication.",
+  "version": "0.7.0",
+  "description": "Swiss open data for AI \u2014 76 tools, zero API keys. Transport, weather, geodata, companies, parliament, and 16 more modules.",
+  "long_description": "mcp-swiss gives any AI assistant direct access to Swiss open data. 76 tools across 21 modules: train schedules (SBB), weather (MeteoSwiss), river levels (BAFU), geodata (swisstopo), company registry (ZEFIX), parliament (OpenParlData.ch), avalanche bulletins, holidays, postal services, electricity prices, population statistics, exchange rates (SNB), recycling schedules, news (SRF), voting results, dam registry, hiking trail alerts, real estate data, traffic counts, earthquake monitoring, and snow conditions (SLF). All APIs are free and require zero authentication.",
   "author": {
     "name": "Vikram Gorla",
     "url": "https://github.com/vikramgorla"
@@ -300,6 +300,18 @@
       "name": "search_earthquakes_by_location",
       "description": "Search earthquakes near a location"
     },
+    {
+      "name": "get_snow_conditions",
+      "description": "Get current snow conditions across Switzerland from SLF"
+    },
+    {
+      "name": "list_snow_stations",
+      "description": "List all SLF snow measurement stations"
+    },
+    {
+      "name": "get_snow_measurements",
+      "description": "Get detailed measurements for a specific SLF station"
+    },
     {
       "name": "search_parliament_speeches",
       "description": "Search speeches given in Swiss parliament"
@@ -347,7 +359,8 @@
     "hiking",
     "real-estate",
     "traffic",
-    "earthquakes"
+    "earthquakes",
+    "snow"
   ],
   "license": "MIT",
   "compatibility": {

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-swiss",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Swiss open data MCP server — 68 tools across 20 modules. Zero API keys.",
   "main": "dist/index.js",
   "bin": {

package.json

@@ -1,13 +1,13 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.vikramgorla/swiss",
-  "title": "Switzerland MCP \ud83c\udde8\ud83c\udded",
-  "description": "Swiss open data MCP server. 73 tools, zero API keys. Transport, weather, geodata, news, rates.",
+  "title": "Switzerland MCP 🇨🇭",
+  "description": "Swiss open data MCP server. 76 tools, zero API keys. Transport, weather, geodata, news, rates.",
   "repository": {
     "url": "https://github.com/vikramgorla/mcp-swiss",
     "source": "github"
   },
-  "version": "0.6.0",
+  "version": "0.7.0",
   "icons": [
     {
       "src": "https://raw.githubusercontent.com/vikramgorla/mcp-swiss/main/assets/icon.svg",
@@ -25,7 +25,7 @@
     {
       "registryType": "npm",
       "identifier": "mcp-swiss",
-      "version": "0.6.0",
+      "version": "0.7.0",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"

server.json

@@ -26,6 +26,7 @@ import { hikingTools, handleHiking } from "./modules/hiking.js";
 import { realEstateTools, handleRealEstate } from "./modules/realestate.js";
 import { trafficTools, handleTraffic } from "./modules/traffic.js";
 import { earthquakeTools, handleEarthquakes } from "./modules/earthquakes.js";
+import { snowTools, handleSnow } from "./modules/snow.js";
 
 // ── Module Registry ──────────────────────────────────────────────────────────
 
@@ -57,13 +58,14 @@ export const moduleRegistry: Record<string, ModuleEntry> = {
   realestate:  { tools: realEstateTools,  handler: handleRealEstate },
   traffic:     { tools: trafficTools,     handler: handleTraffic },
   earthquakes: { tools: earthquakeTools,  handler: handleEarthquakes as ToolHandler },
+  snow:        { tools: snowTools,        handler: handleSnow },
 };
 
 // ── Presets ───────────────────────────────────────────────────────────────────
 
 export const presets: Record<string, string[]> = {
   commuter:  ["transport", "weather", "holidays"],
-  outdoor:   ["weather", "avalanche", "hiking", "earthquakes", "dams"],
+  outdoor:   ["weather", "avalanche", "hiking", "earthquakes", "dams", "snow"],
   business:  ["companies", "geodata", "post", "energy", "statistics", "snb"],
   citizen:   ["parliament", "voting", "holidays", "news"],
   minimal:   ["transport"],