mcp-swiss 0.1.7 → 0.2.0

package/README.md

@@ -19,7 +19,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.
 
-**22 tools. No API keys. No registration. No server to run. Just `npx mcp-swiss`.**
+**37 tools. No API keys. No registration. No server to run. Just `npx mcp-swiss`.**
 
 ```
 🚆 Transport — SBB, PostBus, trams, live departures, journey planning
@@ -27,6 +27,11 @@
 🌊 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, councillors, session schedule
+🏔️ Avalanche  — SLF danger bulletins and warning regions
+💨 Air Quality — NABEL stations, Swiss legal limits (LRV)
+📮 Swiss Post — Postcode lookup and parcel tracking
 ```
 
 ---
@@ -225,12 +230,17 @@ Once connected, try asking your AI:
 | *"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?"* | `get_latest_votes` |
+| *"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` |
 
 ---
 
 ## Tools
 
-> Full specifications: [`docs/tool-specs.md`](docs/tool-specs.md) · Machine-readable: [`docs/tools.schema.json`](docs/tools.schema.json)
+> 37 tools across 9 modules. Full specifications: [`docs/tool-specs.md`](docs/tool-specs.md) · Machine-readable: [`docs/tools.schema.json`](docs/tools.schema.json)
 
 ### 🚆 Transport (5 tools)
 
@@ -274,6 +284,46 @@ Once connected, try asking your AI:
 | `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 (4 tools)
+
+| Tool | Description |
+|------|-------------|
+| `search_parliament_business` | Search bills, motions, interpellations |
+| `get_latest_votes` | Recent parliamentary vote results |
+| `search_councillors` | Find members of the National/States Council |
+| `get_sessions` | Parliamentary session schedule |
+
+### 🏔️ Avalanche (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `get_avalanche_bulletin` | Current avalanche bulletin with danger levels and PDF links |
+| `list_avalanche_regions` | All 22 Swiss avalanche warning regions |
+
+### 💨 Air Quality (2 tools)
+
+| Tool | Description |
+|------|-------------|
+| `list_air_quality_stations` | All 14 NABEL monitoring stations |
+| `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 |
+
 ---
 
 ## Data Sources
@@ -286,6 +336,11 @@ All official Swiss open data — no API keys required:
 | [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) |
+| [ws.parlament.ch](https://ws.parlament.ch) | Swiss Parliament OData (bills, votes, councillors) | [OData docs](https://ws.parlament.ch/odata.svc/$metadata) |
+| [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) |
 
 ---
 

package/dist/index.js

@@ -8,12 +8,22 @@ const transport_js_1 = require("./modules/transport.js");
 const weather_js_1 = require("./modules/weather.js");
 const geodata_js_1 = require("./modules/geodata.js");
 const companies_js_1 = require("./modules/companies.js");
+const holidays_js_1 = require("./modules/holidays.js");
+const parliament_js_1 = require("./modules/parliament.js");
+const avalanche_js_1 = require("./modules/avalanche.js");
+const airquality_js_1 = require("./modules/airquality.js");
+const post_js_1 = require("./modules/post.js");
 const server = new index_js_1.Server({ name: "mcp-swiss", version: "0.1.0" }, { capabilities: { tools: {} } });
 const allTools = [
     ...transport_js_1.transportTools,
     ...weather_js_1.weatherTools,
     ...geodata_js_1.geodataTools,
     ...companies_js_1.companiesTools,
+    ...holidays_js_1.holidaysTools,
+    ...parliament_js_1.parliamentTools,
+    ...avalanche_js_1.avalancheTools,
+    ...airquality_js_1.airqualityTools,
+    ...post_js_1.postTools,
 ];
 server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
     tools: allTools,
@@ -35,6 +45,21 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
         else if (companies_js_1.companiesTools.some((t) => t.name === name)) {
             result = await (0, companies_js_1.handleCompanies)(name, safeArgs);
         }
+        else if (holidays_js_1.holidaysTools.some((t) => t.name === name)) {
+            result = await (0, holidays_js_1.handleHolidays)(name, safeArgs);
+        }
+        else if (parliament_js_1.parliamentTools.some((t) => t.name === name)) {
+            result = await (0, parliament_js_1.handleParliament)(name, safeArgs);
+        }
+        else if (avalanche_js_1.avalancheTools.some((t) => t.name === name)) {
+            result = await (0, avalanche_js_1.handleAvalanche)(name, safeArgs);
+        }
+        else if (airquality_js_1.airqualityTools.some((t) => t.name === name)) {
+            result = await (0, airquality_js_1.handleAirQuality)(name, safeArgs);
+        }
+        else if (post_js_1.postTools.some((t) => t.name === name)) {
+            result = await (0, post_js_1.handlePost)(name, safeArgs);
+        }
         else {
             throw new Error(`Unknown tool: ${name}`);
         }

package/dist/modules/airquality.d.ts

@@ -0,0 +1,25 @@
+export declare const airqualityTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            station?: undefined;
+        };
+        required?: undefined;
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            station: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+})[];
+export declare function handleAirQuality(name: string, args: Record<string, unknown>): Promise<string>;

package/dist/modules/airquality.js

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.airqualityTools = void 0;
+exports.handleAirQuality = handleAirQuality;
+const http_js_1 = require("../utils/http.js");
+const GEO_ADMIN = "https://api3.geo.admin.ch/rest/services/api/MapServer";
+const NABELSTATIONEN_LAYER = "ch.bafu.nabelstationen";
+// ── Known NABEL stations (BAFU/EMPA national monitoring network) ─────────────
+// Source: geo.admin.ch ch.bafu.nabelstationen layer
+// These are the official NABEL (Nationales Beobachtungsnetz für Luftfremdstoffe) stations
+const NABEL_STATIONS = {
+    BAS: { name: "Basel-Binningen", canton: "BS", lat: 47.541081, lon: 7.583264, altitude_m: 316, environment: "urban" },
+    BER: { name: "Bern-Bollwerk", canton: "BE", lat: 46.950993, lon: 7.440866, altitude_m: 540, environment: "urban" },
+    CHA: { name: "Chaumont", canton: "NE", lat: 47.049465, lon: 6.979204, altitude_m: 1136, environment: "rural-elevated" },
+    DAV: { name: "Davos", canton: "GR", lat: 46.815199, lon: 9.855859, altitude_m: 1590, environment: "alpine" },
+    DUE: { name: "Duebendorf", canton: "ZH", lat: 47.404842, lon: 8.608474, altitude_m: 432, environment: "suburban" },
+    HAE: { name: "Haerkingen", canton: "SO", lat: 47.311911, lon: 7.8205, altitude_m: 430, environment: "rural-roadside" },
+    LAU: { name: "Lausanne", canton: "VD", lat: 46.522018, lon: 6.639701, altitude_m: 540, environment: "urban" },
+    LUG: { name: "Lugano", canton: "TI", lat: 46.011117, lon: 8.957165, altitude_m: 273, environment: "urban" },
+    MAG: { name: "Magadino-Cadenazzo", canton: "TI", lat: 46.160376, lon: 8.933939, altitude_m: 203, environment: "rural" },
+    PAY: { name: "Payerne", canton: "VD", lat: 46.813057, lon: 6.944473, altitude_m: 490, environment: "rural" },
+    RIG: { name: "Rigi-Seebodenalp", canton: "SZ", lat: 47.06741, lon: 8.46333, altitude_m: 1030, environment: "alpine" },
+    SIO: { name: "Sion-Aerodrome", canton: "VS", lat: 46.220201, lon: 7.341966, altitude_m: 482, environment: "urban" },
+    TAE: { name: "Taenikon", canton: "TG", lat: 47.479771, lon: 8.904686, altitude_m: 540, environment: "rural" },
+    ZUE: { name: "Zürich-Kaserne", canton: "ZH", lat: 47.3769, lon: 8.5417, altitude_m: 409, environment: "urban" },
+};
+// ── Swiss legal air quality limits (LRV - Luftreinhalteordnung, Swiss Clean Air Act) ──
+// Immissionsgrenzwerte (IGW) — annual mean limits in µg/m³
+const SWISS_LIMITS = {
+    PM10: { annual_mean_µg_m3: 20, daily_mean_µg_m3: 50, who_note: "WHO 2021 guideline: 15 µg/m³ annual, 45 µg/m³ daily" },
+    PM2_5: { annual_mean_µg_m3: 10, who_note: "WHO 2021 guideline: 5 µg/m³ annual" },
+    O3: { hourly_mean_µg_m3: 120, who_note: "Peak season 8h: 60 µg/m³ (WHO 2021)" },
+    NO2: { annual_mean_µg_m3: 30, hourly_mean_µg_m3: 100, who_note: "WHO 2021 guideline: 10 µg/m³ annual" },
+    SO2: { annual_mean_µg_m3: 30, daily_mean_µg_m3: 100 },
+};
+// ── Tool definitions ──────────────────────────────────────────────────────────
+exports.airqualityTools = [
+    {
+        name: "list_air_quality_stations",
+        description: "List all official Swiss NABEL (Nationales Beobachtungsnetz für Luftfremdstoffe) air quality monitoring stations operated by BAFU/EMPA. Returns station codes, names, cantons, coordinates, and environment types.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+    },
+    {
+        name: "get_air_quality",
+        description: "Get information about a Swiss NABEL air quality monitoring station, including location, environment type, Swiss legal limits (LRV), and a direct link to the BAFU live data portal. Use station codes from list_air_quality_stations (e.g. BER=Bern, ZUE=Zürich, LUG=Lugano).",
+        inputSchema: {
+            type: "object",
+            required: ["station"],
+            properties: {
+                station: {
+                    type: "string",
+                    description: "NABEL station code (e.g. BER, ZUE, LUG, BAS, DAV). Use list_air_quality_stations for all codes.",
+                },
+            },
+        },
+    },
+];
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function normalizeStationCode(code) {
+    return code.trim().toUpperCase();
+}
+async function fetchStationFromApi(stationCode) {
+    const url = `${GEO_ADMIN}/${NABELSTATIONEN_LAYER}/${encodeURIComponent(stationCode)}?returnGeometry=true&sr=4326`;
+    try {
+        const data = await (0, http_js_1.fetchJSON)(url);
+        return data?.feature ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Handler ───────────────────────────────────────────────────────────────────
+async function handleAirQuality(name, args) {
+    switch (name) {
+        case "list_air_quality_stations": {
+            // Build compact station dict from our hardcoded registry (confirmed via geo.admin.ch API)
+            const stations = {};
+            for (const [code, info] of Object.entries(NABEL_STATIONS)) {
+                stations[code] = `${info.name} (${info.canton}) — ${info.environment}`;
+            }
+            return JSON.stringify({
+                count: Object.keys(stations).length,
+                network: "NABEL — Nationales Beobachtungsnetz für Luftfremdstoffe",
+                operator: "BAFU (Swiss Federal Office for the Environment) / EMPA",
+                source: "geo.admin.ch ch.bafu.nabelstationen",
+                data_portal: "https://www.bafu.admin.ch/bafu/en/home/topics/air/state/data/nabel.html",
+                stations,
+            });
+        }
+        case "get_air_quality": {
+            const code = normalizeStationCode(args.station);
+            const local = NABEL_STATIONS[code];
+            if (!local) {
+                const knownCodes = Object.keys(NABEL_STATIONS).join(", ");
+                throw new Error(`Unknown NABEL station code "${code}". Known stations: ${knownCodes}. ` +
+                    `Use list_air_quality_stations to see all options.`);
+            }
+            // Optionally enrich from live geo.admin.ch API (non-blocking fallback)
+            let apiName;
+            try {
+                const feature = await fetchStationFromApi(code);
+                apiName = feature?.attributes?.name;
+            }
+            catch {
+                // continue with local data
+            }
+            const stationName = apiName ?? local.name;
+            return JSON.stringify({
+                station: code,
+                name: stationName,
+                canton: local.canton,
+                coordinates: { lat: local.lat, lon: local.lon },
+                altitude_m: local.altitude_m,
+                environment: local.environment,
+                network: "NABEL",
+                operator: "BAFU / EMPA",
+                source: "geo.admin.ch — ch.bafu.nabelstationen",
+                data_note: "Live NABEL measurements (PM10, PM2.5, O3, NO2, SO2) are published on the BAFU data portal. " +
+                    "No public REST API for real-time values — use the portal link below.",
+                live_data_portal: "https://www.bafu.admin.ch/bafu/en/home/topics/air/state/data/nabel.html",
+                swiss_legal_limits_lrv: SWISS_LIMITS,
+                limits_reference: "LRV (Luftreinhalteordnung / Swiss Clean Air Act, Annex 7)",
+            });
+        }
+        default:
+            throw new Error(`Unknown air quality tool: ${name}`);
+    }
+}

package/dist/modules/avalanche.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Swiss Avalanche Bulletin module
+ *
+ * Data source: SLF (WSL Institute for Snow and Avalanche Research)
+ * The SLF publishes the official Swiss avalanche bulletin daily at ~08:00 and 17:00.
+ *
+ * API situation: The SLF JSON API used by the White Risk app (whiterisk.ch) requires
+ * authentication. The public-facing data is available as:
+ *   - PDF bulletins at aws.slf.ch (no auth, verified working)
+ *   - Interactive maps at whiterisk.ch
+ *   - EAWS CAAMLv6 feed (requires auth)
+ *
+ * This module provides:
+ *   - get_avalanche_bulletin: current bulletin URLs + danger level summary links
+ *   - list_avalanche_regions: all SLF warning regions with IDs and locations
+ */
+export interface AvalancheTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+export declare const SWISS_AVALANCHE_REGIONS: {
+    id: string;
+    name: string;
+    canton: string;
+    elevation_m: number;
+}[];
+export declare const avalancheTools: AvalancheTool[];
+export declare function handleAvalanche(name: string, args: Record<string, string>): Promise<string>;

package/dist/modules/avalanche.js

@@ -0,0 +1,191 @@
+"use strict";
+/**
+ * Swiss Avalanche Bulletin module
+ *
+ * Data source: SLF (WSL Institute for Snow and Avalanche Research)
+ * The SLF publishes the official Swiss avalanche bulletin daily at ~08:00 and 17:00.
+ *
+ * API situation: The SLF JSON API used by the White Risk app (whiterisk.ch) requires
+ * authentication. The public-facing data is available as:
+ *   - PDF bulletins at aws.slf.ch (no auth, verified working)
+ *   - Interactive maps at whiterisk.ch
+ *   - EAWS CAAMLv6 feed (requires auth)
+ *
+ * This module provides:
+ *   - get_avalanche_bulletin: current bulletin URLs + danger level summary links
+ *   - list_avalanche_regions: all SLF warning regions with IDs and locations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.avalancheTools = exports.SWISS_AVALANCHE_REGIONS = void 0;
+exports.handleAvalanche = handleAvalanche;
+// ── Region data (official SLF/EAWS regions for Switzerland) ───────────────────
+exports.SWISS_AVALANCHE_REGIONS = [
+    { id: "CH-1", name: "Jura", canton: "JU/NE/VD", elevation_m: 800 },
+    { id: "CH-2", name: "Mittelland", canton: "BE/ZH/AG", elevation_m: 700 },
+    { id: "CH-3", name: "Alps North of the Rhone", canton: "BE/VD/VS/FR", elevation_m: 1500 },
+    { id: "CH-4", name: "Western Alps", canton: "VS", elevation_m: 2500 },
+    { id: "CH-5", name: "Central Alps", canton: "VS/OW/NW", elevation_m: 2500 },
+    { id: "CH-6", name: "Bernese Alps North", canton: "BE", elevation_m: 2000 },
+    { id: "CH-7", name: "Bernese Alps South", canton: "BE/VS", elevation_m: 2500 },
+    { id: "CH-8", name: "Glarner Alps", canton: "GL/SG/GR", elevation_m: 2000 },
+    { id: "CH-9", name: "Central Graubünden", canton: "GR", elevation_m: 2500 },
+    { id: "CH-10", name: "Prättigau & Davos", canton: "GR", elevation_m: 2000 },
+    { id: "CH-11", name: "Silvretta", canton: "GR/GL", elevation_m: 2500 },
+    { id: "CH-12", name: "Surselva", canton: "GR", elevation_m: 2000 },
+    { id: "CH-13", name: "Engadine & Samnaun", canton: "GR", elevation_m: 2500 },
+    { id: "CH-14", name: "Val Müstair", canton: "GR", elevation_m: 2000 },
+    { id: "CH-15", name: "Bernina & Bregaglia", canton: "GR", elevation_m: 2500 },
+    { id: "CH-16", name: "Valposchiavo", canton: "GR", elevation_m: 2000 },
+    { id: "CH-17", name: "Mesolcina & Calanca", canton: "GR", elevation_m: 1800 },
+    { id: "CH-18", name: "Ticino North", canton: "TI", elevation_m: 2000 },
+    { id: "CH-19", name: "Ticino South", canton: "TI", elevation_m: 1500 },
+    { id: "CH-20", name: "Alps North of the Rhine", canton: "GL/SG/AI/AR", elevation_m: 1800 },
+    { id: "CH-21", name: "Uri Alps", canton: "UR/OW/NW", elevation_m: 2500 },
+    { id: "CH-22", name: "Schwyzer Alps", canton: "SZ/ZG", elevation_m: 1800 },
+];
+const DANGER_LEVELS = {
+    1: "Low (1/5) — No special precautions needed",
+    2: "Moderate (2/5) — Careful route selection on steep slopes",
+    3: "Considerable (3/5) — Careful assessment required; natural and human-triggered avalanches possible",
+    4: "High (4/5) — Very careful assessment; spontaneous avalanches likely",
+    5: "Very High (5/5) — Extraordinary situation; avoid all avalanche terrain",
+};
+const SUPPORTED_LANGUAGES = ["de", "en", "fr", "it"];
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function todayISO() {
+    return new Date().toISOString().slice(0, 10);
+}
+function bulletinPdfUrl(lang, _period = "morning") {
+    // aws.slf.ch serves official PDF bulletins — publicly accessible without auth
+    // Pattern: https://aws.slf.ch/api/bulletin/document/regional/<lang>/<period>
+    const validLang = SUPPORTED_LANGUAGES.includes(lang) ? lang : "en";
+    return `https://aws.slf.ch/api/bulletin/document/full/${validLang}`;
+}
+function whiteRiskUrl(lang) {
+    const validLang = SUPPORTED_LANGUAGES.includes(lang) ? lang : "en";
+    return `https://whiterisk.ch/${validLang}/conditions`;
+}
+// ── Tool definitions ──────────────────────────────────────────────────────────
+exports.avalancheTools = [
+    {
+        name: "get_avalanche_bulletin",
+        description: "Get the current Swiss avalanche danger bulletin from SLF (WSL Institute for Snow and Avalanche Research). " +
+            "Returns current bulletin URLs, danger level descriptions, and links to the interactive map. " +
+            "The bulletin is published daily at ~08:00 and updated at ~17:00 Swiss time (October–May).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                region: {
+                    type: "string",
+                    description: "Optional region ID (e.g. CH-9 for Central Graubünden) or region name. " +
+                        "Use list_avalanche_regions to see all options. If omitted, returns national overview.",
+                },
+                language: {
+                    type: "string",
+                    enum: ["de", "en", "fr", "it"],
+                    description: "Language for bulletin links: de (German), en (English), fr (French), it (Italian). Default: en",
+                },
+            },
+        },
+    },
+    {
+        name: "list_avalanche_regions",
+        description: "List all Swiss avalanche warning regions as defined by SLF/EAWS. " +
+            "Returns region IDs, names, cantons, and typical elevations. " +
+            "Use region IDs with get_avalanche_bulletin.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                canton: {
+                    type: "string",
+                    description: "Filter regions by canton abbreviation (e.g. GR, VS, BE). Optional.",
+                },
+            },
+        },
+    },
+];
+// ── Handlers ──────────────────────────────────────────────────────────────────
+async function handleGetAvalancheBulletin(args) {
+    const lang = SUPPORTED_LANGUAGES.includes(args.language) ? args.language : "en";
+    const today = todayISO();
+    // Find matching region if specified
+    let matchedRegion;
+    if (args.region) {
+        const query = args.region.trim().toLowerCase();
+        matchedRegion = exports.SWISS_AVALANCHE_REGIONS.find((r) => r.id.toLowerCase() === query ||
+            r.name.toLowerCase().includes(query) ||
+            r.canton.toLowerCase().includes(query));
+    }
+    const pdfUrl = bulletinPdfUrl(lang);
+    const mapUrl = whiteRiskUrl(lang);
+    const result = {
+        date: today,
+        source: "SLF – WSL Institute for Snow and Avalanche Research",
+        bulletin_url: {
+            interactive_map: mapUrl,
+            pdf_full: pdfUrl,
+            pdf_regions: {
+                de: "https://aws.slf.ch/api/bulletin/document/full/de",
+                en: "https://aws.slf.ch/api/bulletin/document/full/en",
+                fr: "https://aws.slf.ch/api/bulletin/document/full/fr",
+                it: "https://aws.slf.ch/api/bulletin/document/full/it",
+            },
+        },
+        danger_scale: DANGER_LEVELS,
+        schedule: {
+            morning_bulletin: "~08:00 CET/CEST",
+            afternoon_update: "~17:00 CET/CEST",
+            season: "October to May (daily). Summer bulletins are occasional.",
+        },
+        note: "The SLF JSON API requires authentication (used by the White Risk app). " +
+            "Current danger levels are available via the interactive map at whiterisk.ch " +
+            "or as PDF bulletins at the URLs above. " +
+            "For programmatic access, contact SLF at lawinfo@slf.ch.",
+    };
+    if (matchedRegion) {
+        result.region = {
+            id: matchedRegion.id,
+            name: matchedRegion.name,
+            canton: matchedRegion.canton,
+            typical_elevation_m: matchedRegion.elevation_m,
+            bulletin_link: `${mapUrl}#region=${matchedRegion.id}`,
+        };
+        result.tip = `Check ${matchedRegion.name} (${matchedRegion.id}) on the interactive map: ${mapUrl}`;
+    }
+    else if (args.region) {
+        result.region_not_found = args.region;
+        result.tip = `Use list_avalanche_regions to see valid region IDs. Or visit ${mapUrl} for the full map.`;
+    }
+    return JSON.stringify(result);
+}
+async function handleListAvalancheRegions(args) {
+    let regions = exports.SWISS_AVALANCHE_REGIONS;
+    if (args.canton) {
+        const cantonQuery = args.canton.trim().toUpperCase();
+        regions = exports.SWISS_AVALANCHE_REGIONS.filter((r) => r.canton.toUpperCase().includes(cantonQuery));
+    }
+    const result = {
+        count: regions.length,
+        source: "SLF/EAWS Swiss Avalanche Warning Regions",
+        regions: regions.map((r) => ({
+            id: r.id,
+            name: r.name,
+            canton: r.canton,
+            typical_elevation_m: r.elevation_m,
+        })),
+        usage: "Pass region ID (e.g. 'CH-9') to get_avalanche_bulletin for region-specific bulletin link",
+        bulletin_map: "https://whiterisk.ch/en/conditions",
+    };
+    return JSON.stringify(result);
+}
+// ── Main dispatcher ───────────────────────────────────────────────────────────
+async function handleAvalanche(name, args) {
+    switch (name) {
+        case "get_avalanche_bulletin":
+            return handleGetAvalancheBulletin(args);
+        case "list_avalanche_regions":
+            return handleListAvalancheRegions(args);
+        default:
+            throw new Error(`Unknown avalanche tool: ${name}`);
+    }
+}

package/dist/modules/holidays.d.ts

@@ -0,0 +1,33 @@
+export declare const holidaysTools: ({
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        required: string[];
+        properties: {
+            year: {
+                type: string;
+                description: string;
+            };
+            canton: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+} | {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            canton: {
+                type: string;
+                description: string;
+            };
+            year?: undefined;
+        };
+        required?: undefined;
+    };
+})[];
+export declare function handleHolidays(name: string, args: Record<string, unknown>): Promise<string>;