# Swissyphus (npm · swissyphus)

Swiss public-data rollup for AI agents: 151 tools, 66 sources, zero keys, every answer cited.

- Trust score: 75/100 (medium)
- Change this week: +6
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- npm · `swissyphus`: 75/100 (this document), [markdown](https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus.md), [page](https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus)
- oci · `ghcr.io/cwellbournewood/swissyphus`: 46/100, [markdown](https://verifymcp.io/servers/cwellbournewood-swissyphus/ghcr-io-cwellbournewood-swissyphus.md), [page](https://verifymcp.io/servers/cwellbournewood-swissyphus/ghcr-io-cwellbournewood-swissyphus)

## Channel facts

- Registry: `npm`
- Package: `swissyphus`
- Version: `1.0.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Supply Chain Security**: 98/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 92 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 42/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Maintenance check failed: the publisher has marked this version as deprecated on the registry, telling users to stop installing it.
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 76/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 25136 tokens (~164/item across 153 items; 151 tools + 2 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 40/100
  - Stability observed for 12 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 93/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 78% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 151 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 153 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Swissyphus MCP server?

Swissyphus runs locally as an npm package, launched with npx -y swissyphus. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add cwellbournewood-swissyphus -- npx -y swissyphus
```

### Cursor

```json
{
  "mcpServers": {
    "cwellbournewood-swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "cwellbournewood-swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add cwellbournewood-swissyphus -- npx -y swissyphus
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cwellbournewood-swissyphus": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "swissyphus"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cwellbournewood-swissyphus --command npx --arg -y --arg swissyphus
```

### Hermes

```yaml
mcp_servers:
  cwellbournewood-swissyphus:
    command: "npx"
    args: ["-y", "swissyphus"]
```

### Netclaw

```json
{
  "McpServers": {
    "cwellbournewood-swissyphus": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "swissyphus"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add cwellbournewood-swissyphus -t stdio -c npx -a -y swissyphus
```

### Other

```json
{
  "mcpServers": {
    "cwellbournewood-swissyphus": {
      "command": "npx",
      "args": [
        "-y",
        "swissyphus"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-19 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 73, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-16 (score 72, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-11-10 (score 69, +20)

- [security improvement] Malware scan: unverified → pass
- [security improvement] Source repository: fail → pass
- [functional regression] Maintenance: pass → fail
- [functional improvement] Security disclosure: unverified → pass

### 2026-11-09 (score 49)

First indexed and scored.

## MCP tools (151)

### `search_companies` (~115 tokens)

Search Swiss companies

Search the Swiss commercial register (ZEFIX, 700k+ entities) by company name. Returns UID, legal form, seat, status and a link to the cantonal register excerpt. A UID like 'CHE-123.456.789' as query is looked up directly.

Input parameters:

- `canton` (string): Optional canton filter, e.g. 'ZH'
- `limit` (integer)
- `offset` (integer): Pagination offset
- `query` (string, required): Company name (or UID) to search for

### `get_company` (~97 tokens)

Get company details

Full ZEFIX record for one company: purpose, translations, seat, status, legal form, SOGC date and register links. Identify the company by UID ('CHE-107.028.276' or its 9 digits), exact registered name (case-insensitive; otherwise candidates are returned), or numeric EHRAID.

Input parameters:

- `identifier` (string, required): Company UID (CHE-…), exact registered name, or numeric EHRAID

### `list_legal_forms` (~39 tokens)

List Swiss legal forms

List the legal-form codes (ZEFIX legalFormId) used in the Swiss commercial register (AG, GmbH, foundation, …).

### `list_cantons` (~33 tokens)

List Swiss cantons

All 26 Swiss cantons with their two-letter abbreviations (used as filters across Swissyphus tools).

### `search_sogc_publications` (~145 tokens)

Search SOGC gazette publications

Search official Swiss Official Gazette of Commerce (SOGC/SHAB) publications: commercial-register mutations (HR), bankruptcies (KK), debt enforcement, and more. Filter by keyword, rubric and date range. Results are listed newest first.

Input parameters:

- `date_from` (string): Earliest publication date YYYY-MM-DD
- `date_to` (string): Latest publication date YYYY-MM-DD
- `keyword` (string): Free-text keyword, e.g. a company name
- `limit` (integer)
- `rubric` (string): Rubric: HR=commercial register, KK=bankruptcy, LS=debt call, ES=inheritance, …

### `get_connections` (~143 tokens)

Find public transport connections

Find the next train/bus/tram/boat connections between two Swiss stations or addresses, with platforms, delays, transfers and per-leg details.

Input parameters:

- `date` (string): Date YYYY-MM-DD (default: today)
- `from` (string, required): Origin station or address, e.g. 'Zürich HB'
- `is_arrival_time` (boolean): If true, date/time is the desired arrival time
- `limit` (integer)
- `time` (string): Time HH:MM (default: now)
- `to` (string, required): Destination station or address, e.g. 'Lugano'
- `via` (string): Optional via station

### `get_departures` (~49 tokens)

Departure board for a station

Live departure board for a Swiss public transport station, with delays and platforms.

Input parameters:

- `limit` (integer)
- `station` (string, required): Station name, e.g. 'Basel SBB'

### `get_arrivals` (~41 tokens)

Arrival board for a station

Live arrival board for a Swiss public transport station.

Input parameters:

- `limit` (integer)
- `station` (string, required): Station name, e.g. 'Bern'

### `search_stations` (~45 tokens)

Search public transport stations

Search Swiss public transport stations and stops by name.

Input parameters:

- `limit` (integer)
- `query` (string, required): Station name or fragment, e.g. 'Interlaken'

### `get_nearby_stations` (~56 tokens)

Find stations near coordinates

Find public transport stations near a WGS84 point, sorted by distance.

Input parameters:

- `lat` (number, required): WGS84 latitude
- `limit` (integer)
- `lon` (number, required): WGS84 longitude

### `get_weather` (~60 tokens)

Current weather + forecast for a location

MeteoSwiss current conditions, 8-day forecast and active weather warnings for a Swiss postal code (via the MeteoSwiss app service).

Input parameters:

- `plz` (string, required): 4-digit Swiss postal code, e.g. '8001' for Zürich

### `get_weather_warnings` (~66 tokens)

Official weather warnings for a location

Active MeteoSwiss weather warnings (wind, thunderstorms, heat, snow, flood, forest fire…) for a Swiss postal code, with danger levels 1–5 (via the MeteoSwiss app service).

Input parameters:

- `plz` (string, required): 4-digit Swiss postal code

### `get_current_measurements` (~126 tokens)

Live measurements from MeteoSwiss stations

Live 10-minute measurements from the official MeteoSwiss (SwissMetNet) station network. Choose a parameter and optionally filter to stations near a point (pass both near_lat and near_lon) or by name.

Input parameters:

- `limit` (integer)
- `near_lat` (number): Optional: WGS84 latitude to sort stations by distance (requires near_lon)
- `near_lon` (number): Optional: WGS84 longitude (requires near_lat)
- `parameter` (string, required): Measured parameter
- `station_name` (string): Optional: filter by station name fragment

### `get_weather_history` (~157 tokens)

Historical weather measurements

Historical measurements from an official SwissMetNet station over a date range (recent weeks), delivered via the api.existenz.ch proxy. Station codes are 3-letter MeteoSwiss codes, e.g. 'SMA' Zürich-Fluntern, 'BER' Bern, 'GVE' Geneva — see get_current_measurements station IDs. Long ranges are downsampled: precipitation and sunshine are summed per bucket (totals preserved), other parameters averaged with min/max.

Input parameters:

- `date_from` (string, required): Start date YYYY-MM-DD
- `date_to` (string): End date (default: today)
- `parameter` (string)
- `station_code` (string, required): SwissMetNet station code, e.g. 'SMA'

### `get_pollen` (~156 tokens)

Live pollen measurements

Live hourly pollen concentrations from the official MeteoSwiss pollen monitoring network. Choose a taxon (grasses, birch, ash, alder, hazel, mugwort, ambrosia); optionally sort stations by distance from a point (pass both near_lat and near_lon).

Input parameters:

- `limit` (integer)
- `near_lat` (number): Optional: WGS84 latitude (requires near_lon)
- `near_lon` (number): Optional: WGS84 longitude (requires near_lat)
- `taxon` (string): Pollen taxon: graeser=grasses, birke=birch, esche=ash, erle=alder, hasel=hazel, beifuss=mugwort

### `list_weather_stations` (~33 tokens)

List MeteoSwiss measurement stations

List official SwissMetNet stations reporting a given parameter, with coordinates and altitude.

Input parameters:

- `parameter` (string)

### `get_water_data` (~77 tokens)

Live water data for a station

Latest water level, discharge and temperature for a FOEN hydrology station, by numeric station ID. Do not guess IDs: call list_hydro_stations with a river, lake or place name first and use the station_id it returns.

Input parameters:

- `station_id` (string, required): FOEN station number as returned by list_hydro_stations

### `get_water_history` (~112 tokens)

Historical water data for a station

Historical water level, discharge or temperature for a FOEN station over a date range (recent weeks). Get the station ID from list_hydro_stations. Long ranges are downsampled to bucket means (with min/max) to stay compact.

Input parameters:

- `date_from` (string, required): Start date YYYY-MM-DD
- `date_to` (string): End date (default: today)
- `parameter` (string)
- `station_id` (string, required): FOEN station number as returned by list_hydro_stations

### `list_hydro_stations` (~70 tokens)

List FOEN hydrology stations

List FOEN river/lake monitoring stations with their IDs and water bodies. Optionally filter by name (river, lake or place).

Input parameters:

- `limit` (integer)
- `query` (string): Filter by water body or place name, e.g. 'Aare' or 'Bern'

### `geocode` (~113 tokens)

Geocode a Swiss address or place

Search Swiss addresses, places, municipalities and postal codes and return coordinates (WGS84 + LV95). Works with street addresses ('Bundesplatz 3 Bern'), place names ('Matterhorn'), and PLZ codes.

Input parameters:

- `limit` (integer): Max results
- `origins` (string): Comma-separated source filter: address, zipcode, gg25 (municipalities), district, kantone, gazetteer. Default: all
- `query` (string, required): Address, place name or postal code to search

### `reverse_geocode` (~95 tokens)

Reverse geocode coordinates to an address

Find the nearest registered building/address for WGS84 coordinates using the federal Register of Buildings and Dwellings (GWR). Returns street, number, postal code, locality, municipality and EGID.

Input parameters:

- `lat` (number, required): WGS84 latitude (Switzerland: ~45.8–47.9)
- `lon` (number, required): WGS84 longitude (Switzerland: ~5.9–10.6)

### `get_elevation` (~72 tokens)

Get elevation at a point

Return the terrain elevation in metres above sea level for WGS84 coordinates in Switzerland.

Input parameters:

- `lat` (number, required): WGS84 latitude (Switzerland: ~45.8–47.9)
- `lon` (number, required): WGS84 longitude (Switzerland: ~5.9–10.6)

### `get_elevation_profile` (~71 tokens)

Get an elevation profile along a line

Compute a terrain elevation profile along a line of WGS84 points (e.g. a hike). Returns distance/elevation pairs plus total ascent and descent.

Input parameters:

- `points` (array, required): Line as ordered WGS84 points, at least 2
- `samples` (integer): Number of profile samples

### `get_municipality` (~80 tokens)

Get municipality at coordinates

Return the Swiss municipality (Gemeinde) containing the given WGS84 point, including its official BFS number and canton.

Input parameters:

- `lat` (number, required): WGS84 latitude (Switzerland: ~45.8–47.9)
- `lon` (number, required): WGS84 longitude (Switzerland: ~5.9–10.6)

### `get_solar_potential` (~153 tokens)

Get roof solar potential (Sonnendach)

Return the federal Sonnendach solar-energy suitability of the roof surface(s) within 5 m of the given WGS84 coordinates, nearest first: suitability class, mean irradiation per m² (kWh/m²/yr), total roof-surface irradiation (kWh/yr), roof area, orientation and slope. Orientation follows the Sonnendach convention: 0° = south, −90° = east, +90° = west, ±180° = north.

Input parameters:

- `lat` (number, required): WGS84 latitude (Switzerland: ~45.8–47.9)
- `lon` (number, required): WGS84 longitude (Switzerland: ~5.9–10.6)

### `identify_map_layers` (~167 tokens)

Identify federal map layers at a point

Power tool: query any federal geodata layer(s) at a WGS84 point (e.g. 'ch.bafu.laerm-strassenlaerm_tag' for road noise, 'ch.bafu.gefahren-basiskarte' hazards, 'ch.are.bauzonen' building zones). Returns raw attributes per matching feature.

Input parameters:

- `lat` (number, required): WGS84 latitude (Switzerland: ~45.8–47.9)
- `layers` (string, required): Comma-separated geo.admin.ch layer IDs (BOD IDs), e.g. 'ch.bafu.laerm-strassenlaerm_tag'
- `lon` (number, required): WGS84 longitude (Switzerland: ~5.9–10.6)
- `tolerance` (integer): Search tolerance in metres

### `convert_wgs84_to_lv95` (~93 tokens)

Convert WGS84 → LV95

Convert WGS84 latitude/longitude (Switzerland and surroundings) to Swiss LV95 coordinates (EPSG:2056). Also returns legacy LV03 values.

Input parameters:

- `lat` (number, required): WGS84 latitude (Switzerland ≈ 45.8–47.8)
- `lon` (number, required): WGS84 longitude (Switzerland ≈ 5.9–10.5)

### `convert_lv95_to_wgs84` (~172 tokens)

Convert LV95 → WGS84

Convert Swiss LV95 coordinates (EPSG:2056, easting ~2'600'000 / northing ~1'200'000) to WGS84 latitude/longitude. LV03 legacy values (600'000/200'000 range) are auto-detected and shifted. Swapped easting/northing and out-of-range values are rejected with an explanation.

Input parameters:

- `easting` (number, required): LV95 easting (E, ~2'480'000–2'840'000) or LV03 easting (~480'000–840'000)
- `northing` (number, required): LV95 northing (N, ~1'070'000–1'300'000) or LV03 northing (~70'000–300'000)

### `lookup_postcode` (~52 tokens)

Look up a Swiss postal code

Resolve a 4-digit Swiss postal code (PLZ/NPA) to its locality/localities with coordinates.

Input parameters:

- `plz` (string, required): 4-digit Swiss postal code, e.g. '8001'

### `search_locality` (~50 tokens)

Find postal codes for a locality

Search Swiss localities by name in the official directory and return their postal code(s).

Input parameters:

- `limit` (integer)
- `name` (string, required): Locality name, e.g. 'Winterthur'

### `track_parcel` (~73 tokens)

Swiss Post parcel tracking link

Generate the official Swiss Post tracking URL for a shipment number (parcels, registered mail). Returns the link — tracking status itself requires the Swiss Post site.

Input parameters:

- `tracking_number` (string, required): Swiss Post shipment number, e.g. '99.60.126xxx.xxxxxxxx' or 'RX...CH'

### `get_building` (~74 tokens)

Get building register entry by EGID

Official GWR/RegBL record for a building identified by its federal EGID: status, category, construction year, floors, dwelling count, area, heating info. Get the EGID from reverse_geocode.

Input parameters:

- `egid` (string, required): Federal building ID (EGID), e.g. from reverse_geocode

### `search_federal_law` (~137 tokens)

Search federal legislation

Search the Swiss Classified Compilation (SR/RS) of federal law by title or abbreviation (e.g. 'data protection', 'OR', 'Datenschutz'). Exact abbreviation/title matches are ranked first. Returns SR number, title, abbreviation and the official Fedlex link. Search in the language of your query term (German titles for German terms, etc.).

Input parameters:

- `in_force_only` (boolean)
- `language` (string): Language of titles to search
- `limit` (integer)
- `query` (string, required): Title keyword or abbreviation, e.g. 'Datenschutz', 'obligations', 'DSG'

### `get_law_by_sr` (~111 tokens)

Get legislation by SR number

Look up one act of the Classified Compilation by its SR number (e.g. '220' Code of Obligations, '235.1' Data Protection Act). Returns titles in all official languages, in-force status and Fedlex links for the act currently in force; other acts sharing the SR number (e.g. repealed predecessors) are listed separately under other_acts.

Input parameters:

- `sr_number` (string, required): SR number, e.g. '220', '235.1', '101'

### `search_international_treaties` (~237 tokens)

Search international treaties

Search international treaties and agreements binding Switzerland (the international part of the Classified Compilation, SR numbers starting '0.': bilateral agreements with the EU, double-taxation agreements, conventions, UN/Council of Europe treaties) by title keyword and/or SR area. Returns SR number, title, short title, entry-into-force date, in-force status and the Fedlex link. Titles are language-specific: {query:'Doppelbesteuerung'} (de), {query:'double imposition', language:'fr'}, {query:'Freizügigkeit'}, {sr_prefix:'0.142.11'} (EU free movement area).

Input parameters:

- `in_force_only` (boolean)
- `language` (string): Language of titles to search
- `limit` (integer)
- `query` (string): Title keyword in the chosen language, e.g. 'Doppelbesteuerung', 'Deutschland', 'Menschenrechte'
- `sr_prefix` (string): Restrict to an SR area of international law, e.g. '0.1' (international law), '0.672' (double taxation)

### `list_recent_legislation_changes` (~282 tokens)

Recent changes to federal legislation

What changed in Swiss federal law in a date range (Classified Compilation): 'amended' = acts for which a new consolidated version became applicable (amendments taking effect, incl. new acts), 'entered_into_force' = acts that entered into force, 'repealed' = acts that ceased to be in force. Returns date, SR number, title and Fedlex link, newest first. Dates may lie in the future to see scheduled changes. Examples: {} (amendments in the last 30 days); {change:'entered_into_force', date_from:'2025-01-01', date_to:'2025-01-31'}; {sr_prefix:'8', query:'Kranken'} (health law).

Input parameters:

- `change` (string)
- `date_from` (string): Start date YYYY-MM-DD (default: 30 days ago)
- `date_to` (string): End date YYYY-MM-DD (default: today)
- `language` (string)
- `limit` (integer)
- `query` (string): Optional title keyword in the chosen language
- `sr_prefix` (string): Restrict to an SR area, e.g. '2' (private law), '6' (finance/tax), '8' (health/labour), '0.' (treaties)

### `search_consultations` (~131 tokens)

Federal consultations (Vernehmlassungen)

Federal consultation procedures (Vernehmlassungen / consultations / consultazioni) on draft laws and ordinances from Fedlex: title, description, status (planned, ongoing, closed, withdrawn), consultation period and lead federal office, newest first. Use it to see what legislation the Federal Council is preparing and until when stakeholders can respond. Example: {query: 'Energie', status: 'ongoing'}.

Input parameters:

- `language` (string)
- `limit` (integer)
- `query` (string): Word in title or description (in the chosen language)
- `status` (string)

### `search_federal_gazette` (~228 tokens)

Search the Federal Gazette (BBl)

Search publications in the Federal Gazette (Bundesblatt BBl / Feuille fédérale FF / Foglio federale FF): Federal Council dispatches (Botschaften) on new bills, draft federal acts and decrees, referendum texts, reports and official notices. Filter by title keyword and publication-date range; returns date, title, BBl reference (e.g. 'BBl 2024 1234') and Fedlex link, newest first. Examples: {query:'Botschaft'}; {query:'Klima', date_from:'2023-01-01'}; {query:'énergie', language:'fr'}.

Input parameters:

- `date_from` (string): Earliest publication date (default: 90 days before date_to, or 2 years with a query; range max 2 years)
- `date_to` (string): Latest publication date (default: today)
- `language` (string)
- `limit` (integer)
- `query` (string): Title keyword in the chosen language, e.g. 'Botschaft', 'Datenschutz'

### `get_population` (~60 tokens)

Population of Switzerland and its cantons

Official permanent resident population (BFS STATPOP) for Switzerland and every canton, latest available year. Optionally filter to one canton by name.

Input parameters:

- `canton` (string): Optional canton name filter, e.g. 'Zürich', 'Vaud'

### `search_datasets` (~426 tokens)

Search Swiss open-data catalogues

Full-text search over the national open-data catalogue opendata.swiss (default) or the City of Zürich portal (portal='stadt-zuerich'): statistics (population, prices, energy…), geodata, transport, health and more. Each hit lists its resource formats and whether it is queryable (has CSV/JSON/GeoJSON). Filter by publisher (slug from list_data_publishers), by format (e.g. 'CSV'), sort by 'modified' for the newest. Then call query_dataset {id} for the actual rows, or get_dataset {id} for metadata. Examples: {query: 'Mietpreisindex'}, {query: 'Bevölkerung Gemeinde', format: 'CSV'}, {publisher: 'bundesamt-fur-statistik-bfs', sort: 'modified'}, {query: 'Velo', portal: 'stadt-zuerich'}.

Input parameters:

- `format` (string): Only datasets with a resource of this format, e.g. 'CSV', 'JSON', 'GeoJSON', 'XLSX'
- `lang` (string): Language for titles/descriptions: de, fr, it or en (default en; falls back to de)
- `limit` (integer)
- `offset` (integer): Skip this many hits (paging)
- `portal` (string): Catalogue: 'opendata.swiss' (default, national), 'stadt-zuerich' (City of Zürich, data.stadt-zuerich.ch) or 'envidat' (WSL/ETH environmental research data: snow, glaciers, forests, biodiversity, clim…
- `publisher` (string): Optional publisher (organization) slug, e.g. 'bundesamt-fur-statistik-bfs' — see list_data_publishers
- `query` (string): Search terms, e.g. 'rent index', 'STATPOP', 'Luftqualität'. German terms match best. Optional if publisher/format is given
- `sort` (string): relevance (default), modified (newest updates first), created, name

### `get_dataset` (~168 tokens)

Get dataset details & download links

Full metadata for one dataset on opendata.swiss (or portal='stadt-zuerich'): description, publisher, licence and every resource with its 0-based index, format, whether it is queryable by query_dataset, and its direct download link.

Input parameters:

- `id` (string, required): Dataset ID (slug) from search_datasets
- `lang` (string): Language for titles/descriptions: de, fr, it or en (default en; falls back to de)
- `portal` (string): Catalogue: 'opendata.swiss' (default, national), 'stadt-zuerich' (City of Zürich, data.stadt-zuerich.ch) or 'envidat' (WSL/ETH environmental research data: snow, glaciers, forests, biodiversity, clim…

### `query_dataset` (~553 tokens)

Query the rows of an open-data dataset

Fetch the actual data of an opendata.swiss / City of Zürich dataset and return matching rows. Picks the best machine-readable resource (CSV > JSON > GeoJSON; HTML landing pages, ZIP, XLSX, PDF and services are skipped and reported with their download URLs), parses it and applies search / column filters / sort / paging. Returns columns, total matched, rows, the resource used and its licence. Works with a dataset id or a direct resource_url. Run describe_dataset_columns first to learn column names and values. Examples: {id: '<dataset-id>', where: {Kanton: 'ZH'}, sort: '-Einwohner', limit: 10}; {id: '<dataset-id>', search: 'Winterthur', columns: ['Jahr','Wert']}; {resource_url: 'https://…/data.csv', where: {Jahr: '>2020'}}.

Input parameters:

- `columns` (array): Only return these columns (names are matched case/accent-insensitively; max 50)
- `format` (string): Preferred resource format (overrides the CSV-first default)
- `id` (string): Dataset ID (slug): the 'id' of a search_datasets hit
- `lang` (string): Language for titles/descriptions: de, fr, it or en (default en; falls back to de)
- `limit` (integer): Rows to return (default 25, max 200; large rows are trimmed to fit 50 KB)
- `offset` (integer)
- `portal` (string): Catalogue: 'opendata.swiss' (default, national), 'stadt-zuerich' (City of Zürich, data.stadt-zuerich.ch) or 'envidat' (WSL/ETH environmental research data: snow, glaciers, forests, biodiversity, clim…
- `resource` (string): Optional resource selector: 0-based index from get_dataset, resource id, or part of its title. Default: best CSV > JSON > GeoJSON
- `resource_url` (string): Alternatively, a direct https URL of a CSV/JSON/GeoJSON file (e.g. a download_url from get_dataset). May be disabled on public deployments — prefer 'id'
- `search` (string): Case-insensitive substring matched against every field
- `sort` (string): Sort column; prefix '-' for descending, e.g. '-Jahr'
- `where` (object): Column filters: {column: value}. Exact (case-insensitive) match; prefix '~' for substring, '>'/'<' for numeric compare, e.g. {"Kanton": "ZH", "Jahr": ">2019"}

### `describe_dataset_columns` (~331 tokens)

Profile the columns of an open-data dataset

Fetch and parse a dataset's best CSV/JSON/GeoJSON resource (or a direct resource_url) and return its row count and, per column, the detected type (number/string/mixed), non-null count and example values — use it to plan query_dataset filters or aggregate_dataset group-bys. Examples: {id: '<dataset-id>'} or {id: '<dataset-id>', portal: 'stadt-zuerich', resource: '1'}.

Input parameters:

- `examples` (integer): Distinct example values per column (default 5)
- `format` (string): Preferred resource format (overrides the CSV-first default)
- `id` (string): Dataset ID (slug): the 'id' of a search_datasets hit
- `lang` (string): Language for titles/descriptions: de, fr, it or en (default en; falls back to de)
- `portal` (string): Catalogue: 'opendata.swiss' (default, national), 'stadt-zuerich' (City of Zürich, data.stadt-zuerich.ch) or 'envidat' (WSL/ETH environmental research data: snow, glaciers, forests, biodiversity, clim…
- `resource` (string): Optional resource selector: 0-based index from get_dataset, resource id, or part of its title. Default: best CSV > JSON > GeoJSON
- `resource_url` (string): Alternatively, a direct https URL of a CSV/JSON/GeoJSON file (e.g. a download_url from get_dataset). May be disabled on public deployments — prefer 'id'

### `aggregate_dataset` (~533 tokens)

Group-by aggregation over an open-data dataset

Group a dataset's rows by one or two columns and compute count, sum, avg, min or max of a numeric column (after optional where/search filters) — e.g. total population per canton, average rent per year. Numbers with Swiss formatting (1'234.5) are understood. Examples: {id: '<dataset-id>', group_by: ['Kanton'], op: 'sum', value_column: 'Einwohner'}; {id: '<dataset-id>', group_by: ['Jahr','Kanton'], op: 'avg', value_column: 'Wert', where: {Jahr: '>2015'}, order: 'group'}; {id: '<dataset-id>', group_by: ['Kategorie'], op: 'count'}.

Input parameters:

- `format` (string): Preferred resource format (overrides the CSV-first default)
- `group_by` (array): 0–2 column names to group by (omit for one overall total)
- `id` (string): Dataset ID (slug): the 'id' of a search_datasets hit
- `lang` (string): Language for titles/descriptions: de, fr, it or en (default en; falls back to de)
- `limit` (integer): Max groups returned (default 50)
- `op` (string): Aggregation (default count)
- `order` (string): Sort groups by value desc (default), asc, or by group key
- `portal` (string): Catalogue: 'opendata.swiss' (default, national), 'stadt-zuerich' (City of Zürich, data.stadt-zuerich.ch) or 'envidat' (WSL/ETH environmental research data: snow, glaciers, forests, biodiversity, clim…
- `resource` (string): Optional resource selector: 0-based index from get_dataset, resource id, or part of its title. Default: best CSV > JSON > GeoJSON
- `resource_url` (string): Alternatively, a direct https URL of a CSV/JSON/GeoJSON file (e.g. a download_url from get_dataset). May be disabled on public deployments — prefer 'id'
- `search` (string): Case-insensitive substring pre-filter across all fields
- `value_column` (string): Numeric column to aggregate (required for sum/avg/min/max)
- `where` (object): Column filters: {column: value}. Exact (case-insensitive) match; prefix '~' for substring, '>'/'<' for numeric compare, e.g. {"Kanton": "ZH", "Jahr": ">2019"}

### `list_data_publishers` (~235 tokens)

List open-data publishers

List the organisations publishing on opendata.swiss (federal offices, cantons, cities, companies) or on the City of Zürich portal (departments), with their slug and dataset count. Use the slug as 'publisher' in search_datasets. Examples: {} (largest publishers first), {query: 'statistik'}, {query: 'Kanton Zürich', lang: 'de'}, {portal: 'stadt-zuerich'}.

Input parameters:

- `lang` (string): Language for titles/descriptions: de, fr, it or en (default en; falls back to de)
- `limit` (integer): Max publishers returned (default 50)
- `portal` (string): Catalogue: 'opendata.swiss' (default, national), 'stadt-zuerich' (City of Zürich, data.stadt-zuerich.ch) or 'envidat' (WSL/ETH environmental research data: snow, glaciers, forests, biodiversity, clim…
- `query` (string): Filter by name/title substring (any language), e.g. 'BFS', 'Bern', 'meteo'

### `search_parliament_business` (~97 tokens)

Search parliamentary business

Search Curia Vista for federal parliamentary business (motions, postulates, interpellations, bills) by title keyword (case-insensitive). Returns business number, type, status and submission date.

Input parameters:

- `language` (string): Language of titles searched (DE has best coverage)
- `limit` (integer)
- `query` (string, required): Keyword to search in business titles, e.g. 'Klimaschutz', 'AI'

### `get_parliament_business` (~59 tokens)

Get one parliamentary business

Details of a specific Curia Vista business by its numeric ID (e.g. 20230456 → ID from search).

Input parameters:

- `id` (integer, required): Business ID, e.g. 20230456
- `language` (string)

### `get_session_schedule` (~29 tokens)

Parliament session schedule

Recent and upcoming sessions of the Federal Assembly with dates and names.

Input parameters:

- `limit` (integer)

### `get_parliament_votes` (~93 tokens)

Council votes on a business

Formal council votes for a parliamentary business (by short number like '23.4567'), including the subject, what yes/no meant, and the actual yes/no/abstain tallies of the most recent vote.

Input parameters:

- `business_short_number` (string, required): Business short number, e.g. '23.4567' (from search_parliament_business)
- `limit` (integer): Max votes to list

### `search_council_members` (~131 tokens)

Search Federal Assembly members

Search members of the National Council and Council of States (current by default) by last name (case-insensitive fragment), canton or party abbreviation.

Input parameters:

- `active_only` (boolean)
- `canton` (string): Canton abbreviation, e.g. 'ZH'
- `limit` (integer)
- `name` (string): Last-name fragment (case-insensitive)
- `party` (string): Party abbreviation as used in German, case-insensitive, e.g. 'SVP', 'SP', 'FDP-Liberale', 'M-E', 'GRÜNE', 'glp'

### `search_parliament_speeches` (~345 tokens)

Search parliamentary speeches (Amtliches Bulletin)

Search the verbatim record of speeches in the National Council and Council of States (Amtliches Bulletin transcripts) by speaker and/or keyword, optionally within a date range or session. Returns speaker, function, parliamentary group, canton, council, date, the business debated (short number + title when resolvable), a plain-text excerpt centred on the keyword, and a link to the official Bulletin debate. Keyword matching is case-sensitive and matches the speech's original language (e.g. 'Klimaschutz', 'Neutralität', 'intelligence artificielle'). Examples: {speaker:'Noser', keyword:'Datenschutz'}; {keyword:'Kita', date_from:'2024-01-01'}; {person_number:4057}. Speaker names come from search_council_members.

Input parameters:

- `date_from` (string): Earliest meeting date, YYYY-MM-DD
- `date_to` (string): Latest meeting date, YYYY-MM-DD
- `excerpt_chars` (integer): Max characters of speech text per result
- `keyword` (string): Case-sensitive word/phrase in the speech text, in the language it was spoken, e.g. 'Klimaschutz'
- `language` (string): Language of labels such as council name (speech text stays in its original language)
- `limit` (integer)
- `person_number` (integer): Exact PersonNumber of a council member (from search_council_members ID)
- `session_id` (integer): Session ID from get_session_schedule (field ID)
- `speaker` (string): Fragment of the speaker's full name, e.g. 'Noser', 'Funiciello'

### `get_member_interests` (~211 tokens)

Declared interests of a council member

Lobbying transparency: the declared interests and mandates of a member of the Federal Assembly (board seats, advisory roles, associations, foundations) with the organisation, the member's function, the type of interest and organisation, and paid/unpaid where published — plus declared occupations. Look up by last name (e.g. 'Noser', optionally first_name) or exact person_number (ID from search_council_members). Examples: {name:'Bregy'}; {name:'Müller', first_name:'Damian'}; {person_number:4057}.

Input parameters:

- `first_name` (string): First name to disambiguate common surnames
- `include_occupations` (boolean): Also return declared occupations/employers
- `language` (string)
- `limit` (integer)
- `name` (string): Last name (or fragment), e.g. 'Noser'
- `person_number` (integer): Exact PersonNumber (ID from search_council_members)

### `list_parliament_committees` (~200 tokens)

List parliamentary committees

List committees of the Federal Assembly (legislative committees such as WAK-N/WAK-S economy, SiK security, UREK environment, SGK health, plus supervisory committees GPK/FinK and joint bodies). Returns committee number, name, abbreviation, council (NR/SR/BV) and type. Filter by council and a name/abbreviation fragment. Examples: {council:'NR'}; {query:'Wirtschaft'}; {query:'SGK'}. Use get_committee_members for the members.

Input parameters:

- `council` (string): NR = National Council, SR = Council of States
- `include_inactive` (boolean): Include dissolved/historical committees
- `include_subcommittees` (boolean)
- `language` (string)
- `limit` (integer)
- `query` (string): Name or abbreviation fragment, e.g. 'WAK', 'Gesundheit'

### `get_committee_members` (~127 tokens)

Members of a parliamentary committee

Current members of one Federal Assembly committee with their function (president, vice-president, member), party, parliamentary group, canton and council. Identify the committee by abbreviation ('WAK-N', 'SGK-S', 'GPK-N'), committee number, or a name fragment ('Wirtschaft und Abgaben'). Use list_parliament_committees to find committees.

Input parameters:

- `committee` (string, required): Abbreviation (e.g. 'WAK-N'), committee number (e.g. '5') or name fragment
- `language` (string)
- `limit` (integer)

### `list_parliamentary_groups` (~134 tokens)

Parliamentary groups and parties with seat counts

Current parliamentary groups (Fraktionen: e.g. SVP-Fraktion, SP, Mitte, FDP, Grüne, GLP) or parties with their seat counts in the National Council (NR) and Council of States (SR), computed from the active membership. For groups, a party breakdown is included; for parties, the group they sit with. Examples: {} (factions, both chambers); {by:'party', council:'SR'}.

Input parameters:

- `by` (string): Aggregate by parliamentary group (faction) or by party
- `council` (string)
- `language` (string)

### `list_vote_dates` (~32 tokens)

List federal vote days

List available federal popular-vote days with official result data (newest first).

Input parameters:

- `limit` (integer)

### `get_voting_results` (~95 tokens)

Federal vote results

Official results of federal popular votes for a vote day (default: most recent): national yes-share, turnout, accepted/rejected, cantonal majority, and optional per-canton breakdown.

Input parameters:

- `date` (string): Vote day YYYY-MM-DD (see list_vote_dates); default: most recent
- `include_cantons` (boolean): Include per-canton results
- `language` (string): Language for proposal titles

### `get_emergency_alerts` (~110 tokens)

Current official emergency alerts

All currently active Alertswiss population warnings for Switzerland: event type, severity, affected regions, official instructions. Optionally filter by a region or canton (code or name in any national language or English, accents optional).

Input parameters:

- `include_tests` (boolean): Include technical test alerts
- `limit` (integer)
- `region` (string): Filter by region/canton, e.g. 'Zürich', 'Zurich', 'ZH', 'Ticino', 'Genève'

### `get_avalanche_bulletin` (~85 tokens)

Current avalanche bulletin

The current official SLF avalanche bulletin for Switzerland: danger ratings (EAWS scale 1 low – 5 very high) per bulletin, each listing the warning regions it covers, with elevation/time breakdown where published. Outside winter the bulletin is empty and this tool reports that clearly.

Input parameters:

- `limit` (integer): Max bulletins (danger areas) to return

### `get_avalanche_danger_at` (~64 tokens)

Avalanche danger at coordinates

Avalanche danger level for a specific WGS84 point (e.g. a ski-touring destination), resolved against the SLF warning-region polygons.

Input parameters:

- `lat` (number, required): WGS84 latitude
- `lon` (number, required): WGS84 longitude

### `list_snow_stations` (~96 tokens)

List IMIS snow stations

List SLF IMIS high-alpine measurement stations with code, name, elevation and coordinates. Filter by canton or name, or sort by distance from a point.

Input parameters:

- `canton` (string): Canton code filter, e.g. 'GR', 'VS'
- `limit` (integer)
- `near_lat` (number)
- `near_lon` (number)
- `query` (string): Name fragment filter

### `get_snow_conditions` (~91 tokens)

Live snow conditions

Latest measurement per IMIS station (snow depth, temperatures, wind). Filter by station code (from list_snow_stations) or get the deepest-snow stations right now.

Input parameters:

- `limit` (integer)
- `station_code` (string): IMIS station code, e.g. 'DAV2'
- `top_snow` (boolean): If true, return stations sorted by current snow depth

### `get_trail_closures` (~137 tokens)

Hiking trail closures near a point

Current official hiking-trail closures and detours near a WGS84 point. The search covers roughly radius_km (default 20 km, max 100 km) around the point; it is a map-tolerance buffer that may be a square box, so features up to ~1.4× radius_km away can be included, and distances are not computed. There is no nationwide listing. Use before recommending any hike.

Input parameters:

- `lat` (number, required): WGS84 latitude
- `limit` (integer)
- `lon` (number, required): WGS84 longitude
- `radius_km` (number)

### `get_recent_earthquakes` (~88 tokens)

Recent earthquakes

The most recent seismic events recorded by the Swiss Seismological Service, newest first. Optionally filter by minimum magnitude. event_type is included only when the service reports it (it may include quarry blasts).

Input parameters:

- `days_back` (integer): Search window in days
- `limit` (integer)
- `min_magnitude` (number): Only events at or above this magnitude

### `get_earthquake_details` (~102 tokens)

Details of one seismic event

Full record for one seismic event by its SED event ID — pass the event_id returned by get_recent_earthquakes unchanged (a full 'smi:ch.ethz.sed/…' ID; a short ID is also accepted on a best-effort basis).

Input parameters:

- `event_id` (string, required): SED event ID, e.g. 'smi:ch.ethz.sed/sc25a/Event/2026nbzmeg'

### `search_earthquakes` (~131 tokens)

Search earthquakes near a location

Search historical seismic events near a WGS84 point within a radius, with optional date range (inclusive; date_to covers the whole day) and magnitude filter.

Input parameters:

- `date_from` (string): Start date YYYY-MM-DD (default: 1 year back)
- `date_to` (string): End date YYYY-MM-DD (inclusive)
- `lat` (number, required): WGS84 latitude of search centre
- `limit` (integer)
- `lon` (number, required): WGS84 longitude of search centre
- `min_magnitude` (number)
- `radius_km` (number)

### `list_air_quality_stations` (~101 tokens)

List NABEL air-monitoring stations

All stations of the national NABEL air pollution monitoring network with type, altitude, coordinates and a link to each station's live hourly data on the BAFU site (measurement values themselves are not returned). Optionally sorted by distance from a point (pass both near_lat and near_lon).

Input parameters:

- `limit` (integer)
- `near_lat` (number): Optional WGS84 latitude to sort by distance
- `near_lon` (number)

### `get_air_quality` (~128 tokens)

Air quality station info + legal limits

NABEL station details (nearest to a point or by name) together with the Swiss legal ambient limit values (LRV/OAPC) for PM10, PM2.5, NO2, O3, SO2 and CO, plus the link to the station's live hourly measurements. Does NOT return current pollutant concentrations — follow live_data_url for those.

Input parameters:

- `lat` (number): Or: WGS84 latitude for nearest station
- `lon` (number)
- `station_name` (string): Station name fragment, e.g. 'Bern', 'Lugano'

### `get_energy_dashboard` (~422 tokens)

Swiss energy supply indicators (energiedashboard.ch)

Daily Swiss energy-supply data from the Federal Office of Energy's energy dashboard: 'electricity_production' (Electricity production by energy source (Swissgrid), GWh/day); 'electricity_consumption' (National and final electricity consumption (Swissgrid), GWh/day); 'electricity_consumption_estimate' (Model-based estimate of national electricity consumption (recent days), GWh/day); 'electricity_consumption_forecast' (Electricity final-consumption forecast min/mean/max (SDSC), GWh/day); 'electricity_cross_border' (Cross-border electricity flows per neighbour and net import, GWh/day); 'electricity_spot_price' (Day-ahead spot price Switzerland, baseload, EUR/MWh); 'gas_cross_border' (Cross-border gas flows per neighbour and net import, GWh/day); 'gas_net_imports_monthly' (Monthly gas net imports (VSG), GWh/month); 'gas_storage_eu' (Gas storage levels EU and neighbouring countries, TWh / % of capacity). Returns the last `last_days` (default 30) or a date range, optionally aggregated by week/month/year (energy summed, prices/levels averaged) and filtered to one category (production: 'Kernkraft', 'Flusskraft', 'Speicherkraft', 'Photovoltaik', 'Wind', 'Thermische'; gas storage: 'EU', 'Germany', 'Italy', …). Example: {series: 'electricity_production', aggregate: 'month', from: '2025-01-01'}.

Input parameters:

- `aggregate` (string): Aggregate to weeks, months or years
- `category` (string): Only this category (energy source or storage region)
- `from` (string): Start date YYYY-MM-DD (or YYYY-MM for monthly series)
- `last_days` (integer): Without `from`: how many most recent dates to return
- `series` (string, required): Which indicator
- `to` (string): End date (inclusive)

### `get_electricity_tariff` (~114 tokens)

Electricity tariff for a municipality

Official ElCom electricity tariff for a Swiss municipality, broken into energy, grid usage, community charges and federal grid surcharge (Rp./kWh). Categories: H1–H8 households (H4 = typical 4-room flat), C1–C7 commercial.

Input parameters:

- `category` (string): Consumption category (default H4)
- `municipality` (string, required): Municipality name (e.g. 'Baden') or BFS number
- `year` (string): Tariff year (default: current year)

### `compare_electricity_tariffs` (~100 tokens)

Compare electricity tariffs across municipalities

Compare official electricity tariffs (total Rp./kWh, standard product) across up to 10 Swiss municipalities for one category and year. Names that can't be resolved or have no tariff are reported per item in `errors` without failing the comparison.

Input parameters:

- `category` (string)
- `municipalities` (array, required): Municipality names or BFS numbers, e.g. ['Zürich','Baden','Bern']
- `year` (string)

### `get_ev_chargers_nearby` (~101 tokens)

Find EV charging stations near a point

EV charging stations from the national ich-tanke-strom.ch dataset near WGS84 coordinates: operator, plugs, max power, 24h access, address and number of charge points (evse_count) per station. Sorted by distance.

Input parameters:

- `lat` (number, required): WGS84 latitude
- `limit` (integer)
- `lon` (number, required): WGS84 longitude
- `radius_km` (number)

### `get_exchange_rate` (~72 tokens)

Current CHF exchange rate

Latest official SNB exchange rate for a currency against CHF (monthly average, e.g. EUR, USD, GBP, JPY). Rates are 'CHF per N units of foreign currency'.

Input parameters:

- `currency` (string, required): ISO currency code, e.g. 'EUR', 'USD', 'GBP', 'JPY'

### `get_exchange_rate_history` (~78 tokens)

CHF exchange rate history

Monthly average CHF exchange-rate history for a currency over a month range (YYYY-MM).

Input parameters:

- `currency` (string, required): ISO currency code, e.g. 'EUR'
- `from_month` (string, required): Start month YYYY-MM (range at most 240 months)
- `to_month` (string): End month YYYY-MM (default: current)

### `list_currencies` (~23 tokens)

List SNB-published currencies

List all currencies for which the SNB publishes official CHF exchange rates.

### `list_snb_datasets` (~144 tokens)

List well-known SNB data cubes

Curated list of well-known Swiss National Bank data-portal cube ids (FX rates, money market rates incl. SARON, Confederation bond yields, SNB balance sheet, monetary aggregates, CPI, effective exchange rates) with frequency and a confidence flag for each id. Optional keyword filter, e.g. 'saron', 'bond yield', 'balance sheet', 'M3'. Then call get_snb_cube_dimensions or get_snb_data with the cube_id. Any other cube id from data.snb.ch also works with those tools.

Input parameters:

- `query` (string): Optional keywords, e.g. 'saron', 'inflation', 'bond'

### `get_snb_cube_dimensions` (~177 tokens)

SNB cube dimensions

List the dimensions of any SNB data-portal cube and the item ids in each (e.g. devkum: D0 = monthly average 'M0' / end of month 'M1', D1 = currency 'EUR1', 'USD1', 'JPY100', …). Use the ids in get_snb_data's dimension_selection to fetch only the series you need. Examples: cube_id='devkum', cube_id='zimoma'.

Input parameters:

- `cube_id` (string, required): SNB cube id, e.g. 'devkum' (monthly FX), 'zimoma' (money market rates); see list_snb_datasets
- `language` (string): Label language: en or de (default en)
- `max_items_per_dimension` (integer): Max items listed per dimension (default 200)

### `get_snb_data` (~308 tokens)

SNB cube time series

Fetch labelled time series from any Swiss National Bank data-portal cube: each series has its dimension labels, unit, scale and the most recent values (trimmed to values_per_series). Optional date range (YYYY, YYYY-MM or YYYY-MM-DD matching the cube frequency) and dimension_selection from get_snb_cube_dimensions, e.g. {"D0":["M0"],"D1":["EUR1","USD1"]}. Examples: cube_id='zimoma' (money market rates incl. SARON), cube_id='devkum', from_date='2024-01'.

Input parameters:

- `cube_id` (string, required): SNB cube id, e.g. 'devkum' (monthly FX), 'zimoma' (money market rates); see list_snb_datasets
- `dimension_selection` (object): Dimension id → item ids, e.g. {"D0":["M0"],"D1":["EUR1"]}
- `from_date` (string): Start date, e.g. '2020-01' (monthly) or '2024-06-01' (daily)
- `language` (string): Label language: en or de (default en)
- `limit` (integer): Max series returned (default 20)
- `to_date` (string): End date, same format as from_date
- `values_per_series` (integer): Most recent observations kept per series (default 24; trimmed further if the output would exceed the 50 KB response cap)

### `get_public_holidays` (~72 tokens)

Public holidays

Public holidays in Switzerland for a year, optionally scoped to a canton (two-letter code). Includes nationwide and cantonal holidays.

Input parameters:

- `canton` (string): Canton code, e.g. 'ZH', 'GE' (default: whole country)
- `year` (integer): Year (default: current year)

### `get_school_holidays` (~54 tokens)

School holidays

School holiday periods for a Swiss canton and year.

Input parameters:

- `canton` (string, required): Canton code, e.g. 'ZH', 'BE', 'VD'
- `year` (integer): Year (default: current year)

### `is_holiday_today` (~85 tokens)

Is today a holiday?

Check whether today (Swiss local date) or a given date is a public holiday in a canton, or — without a canton — whether it is a nationwide public holiday (cantonal-only holidays are listed separately and do not count).

Input parameters:

- `canton` (string): Canton code (default: nationwide check)
- `date` (string): Date YYYY-MM-DD (default: today)

### `get_waste_collection` (~93 tokens)

Next waste collection dates

Upcoming waste and recycling collection dates for a Zürich-region ZIP code. Types: waste (household), cardboard, paper, organic (green), special, textile, metal, cargotram, etram, glass.

Input parameters:

- `limit` (integer)
- `waste_type` (string): Filter by one waste type
- `zip` (string, required): ZIP code in the Zürich region, e.g. '8001'

### `list_waste_types` (~22 tokens)

List waste collection types

All waste/recycling collection types supported by the waste calendar.

### `get_swiss_news` (~75 tokens)

Latest Swiss news headlines

Latest Swiss news headlines from SRF with links and publication times. Optionally filter by keyword. Returns titles, links and dates only — no summaries or article text (these stay at the source, per licence).

Input parameters:

- `keyword` (string): Filter headlines by keyword (matched against the headline)
- `limit` (integer)

### `query_lindas` (~133 tokens)

SPARQL query on LINDAS

Run a read-only SPARQL SELECT query against lindas.admin.ch, the Swiss federal linked-data service. Useful graphs include <https://lindas.admin.ch/elcom/electricityprice> (energy prices), ELI legislation, the municipality register (ld.admin.ch/municipality/{BFS}), and cube.link statistical cubes. A top-level LIMIT of 100 is added if none is given and larger limits are clamped to 200; SERVICE (federation) and update operations are rejected; max 10000 characters.

Input parameters:

- `query` (string, required): SPARQL SELECT query (read-only)

### `list_data_portals` (~126 tokens)

List Swiss Opendatasoft data portals

Registry of Swiss open-data portals that run on Opendatasoft and can be searched/queried with search_portal_datasets, get_portal_dataset and query_portal_records: SBB (data.sbb.ch — station passenger frequency, rolling stock, actual train times), Basel-Stadt (real-time parking, Rhine temperature, air quality, elections), Basel-Landschaft, Canton & City of St. Gallen, Graubünden, Thurgau. Returns id, name, operator, domain, licence note, platform confidence and what each portal is good for.

### `search_portal_datasets` (~253 tokens)

Search datasets on Swiss Opendatasoft portals

Full-text search of dataset catalogues on SBB and cantonal/city Opendatasoft portals — one portal or all in parallel (per-portal errors are reported, not fatal). Returns portal, dataset_id, title, short description, record count, last-modified date and themes; pass portal + dataset_id to get_portal_dataset / query_portal_records. Examples: {query:'passagierfrequenz', portal:'sbb'} (passengers per station), {query:'rollmaterial', portal:'sbb'}, {query:'Parkhaus'} (real-time parking), {query:'Rhein Temperatur', portal:'basel-stadt'}, {query:'Wahlen'}. Metadata is mostly German — use German terms. Omit query (with a portal) to list its most recently modified datasets.

Input parameters:

- `limit` (integer): Max results per portal (capped at 15 when searching all portals)
- `portal` (string): Optional portal (id/alias/domain). Omit to search all registered portals in parallel.
- `query` (string): Search terms, e.g. 'Parkhaus', 'Luftqualität', 'Haltestellen', 'Bevölkerung'

### `get_portal_dataset` (~263 tokens)

Get Opendatasoft dataset schema & licence

Schema and metadata of one dataset on a Swiss Opendatasoft portal (SBB, Basel, St. Gallen, Thurgau…): fields (name, label, type, description, facet), record count, licence, publisher, attributions, themes, last modified, and the geo_point field usable for radius search. Call this before query_portal_records to learn field names for where/select/order_by. Example: {portal:'sbb', dataset_id:'passagierfrequenz'}.

Input parameters:

- `dataset_id` (string, required): Dataset id from search_portal_datasets, e.g. 'passagierfrequenz' (SBB) or '100088' (Basel-Stadt ids are numeric)
- `portal` (string, required): Portal id, alias or domain: 'sbb' (data.sbb.ch), 'basel-stadt' (data.bs.ch), 'basel-landschaft' (data.bl.ch), 'st-gallen' (daten.sg.ch), 'stadt-st-gallen' (daten.stadt.sg.ch), 'graubuenden' (data.gr.…

### `query_portal_records` (~577 tokens)

Query records of an Opendatasoft dataset

Fetch records from a dataset on a Swiss Opendatasoft portal with ODSQL: where (e.g. "kanton = 'BS'", "jahr >= 2020", "search(name, 'Bahnhof')"), select (e.g. 'bahnhof_haltestelle, dtv, jahr'), order_by (e.g. 'dtv desc'), group_by with aggregates (select 'kanton, count(*) as n, sum(dtv) as total', group_by 'kanton'), limit/offset. Convenience `near` {lat, lon, radius_m} finds the dataset's geo_point_2d field and returns only records within the radius, sorted by distance (e.g. parking garages within 800 m of Basel SBB: portal 'basel-stadt', near {lat:47.5476, lon:7.5896, radius_m:800}). Real-time datasets (parking occupancy, SBB data) are cached only 10 min. Get field names first with get_portal_dataset.

Input parameters:

- `dataset_id` (string, required): Dataset id from search_portal_datasets
- `geo_field` (string): geo_point_2d field to use for `near` (auto-detected if omitted)
- `group_by` (string): e.g. 'kanton' or 'year(datum)'; combine with aggregates in select
- `lang` (string): Language for localized values where the portal supports it
- `limit` (integer): Records to return (max 100)
- `near` (object): Radius search around a WGS84 point, e.g. {lat: 47.5476, lon: 7.5896, radius_m: 500}
- `offset` (integer): Paging offset (offset + limit ≤ 10000)
- `order_by` (string): e.g. 'dtv desc' or 'n desc'
- `portal` (string, required): Portal id, alias or domain: 'sbb' (data.sbb.ch), 'basel-stadt' (data.bs.ch), 'basel-landschaft' (data.bl.ch), 'st-gallen' (daten.sg.ch), 'stadt-st-gallen' (daten.stadt.sg.ch), 'graubuenden' (data.gr.…
- `select` (string): Fields/expressions to return, e.g. 'name, belegung, geo_point_2d' or 'kanton, count(*) as n'
- `where` (string): ODSQL filter, e.g. "jahr = 2023 AND dtv > 10000" (string literals in single or double quotes)

### `get_shared_vehicles_nearby` (~283 tokens)

Shared bikes, e-scooters and cars near a point

Live shared-mobility availability near WGS84 coordinates from sharedmobility.ch (SFOE national aggregator: PubliBike, Donkey Republic, Bolt, Voi, Tier, Mobility car sharing, carvelo cargo bikes, …). Returns free-floating vehicles and docking stations (with vehicles/docks available) sorted by distance, each with provider name, vehicle types, distance_m and battery range where published. Filter with vehicle_type: bike | e-bike | cargo_bike | scooter | moped | car. Example: {lat: 47.3779, lon: 8.5403, radius_m: 300, vehicle_type: 'scooter'} (Zürich HB). Use geocode first to turn an address into coordinates.

Input parameters:

- `kind` (string): Free-floating vehicles, docking stations, or both
- `lat` (number, required): WGS84 latitude, e.g. 46.9488 (Bern)
- `limit` (integer)
- `lon` (number, required): WGS84 longitude, e.g. 7.4391
- `only_available` (boolean): Hide reserved/disabled vehicles and empty stations
- `radius_m` (integer): Search radius in metres (default 500)
- `vehicle_type` (string): Only this kind of vehicle ('bike' = non-electric)

### `list_shared_mobility_providers` (~128 tokens)

Swiss shared-mobility providers

All bike/e-bike/e-scooter/moped/car/cargo-bike sharing providers in the sharedmobility.ch national aggregator: provider_id, name, vehicle types, website and Android/iOS app links. Filter by name substring (query: 'publibike') or vehicle_type ('car'). Provider names match the 'provider' field of get_shared_vehicles_nearby.

Input parameters:

- `limit` (integer)
- `query` (string): Substring of provider name or id, e.g. 'mobility', 'voi'
- `vehicle_type` (string)

### `get_transport_disruptions` (~237 tokens)

Current public-transport disruptions (Switzerland)

Current and planned disruptions on Swiss public transport (trains, trams, buses, boats) from opentransportdata.swiss service alerts: title, description, cause/effect, validity periods, affected operators/lines/stops. Filter by free text (text: 'Bauarbeiten'), operator (agency id like '11' for SBB, or name), or station (name or UIC number, e.g. 'Olten' or '8500218'). Requires the server env var OPENTRANSPORTDATA_API_KEY (free key); otherwise returns instructions. Example: {station: 'Luzern', lang: 'de'}.

Input parameters:

- `active_only` (boolean): Only disruptions whose validity covers now
- `lang` (string)
- `limit` (integer)
- `operator` (string): GTFS agency id (e.g. '11' = SBB) or operator name
- `station` (string): Station name or 7-digit UIC number
- `text` (string): Substring in title/description, e.g. 'Streckenunterbruch'

### `get_realtime_delays` (~179 tokens)

Realtime delays at a station (GTFS-RT)

Realtime arrival/departure delays and cancellations at one Swiss station from the national GTFS-RT trip-update feed (opentransportdata.swiss). Input the 7-digit UIC station number (use search_stations to find it; e.g. 8503000 = Zürich HB, 8507000 = Bern). Returns GTFS trip_id/route_id, delay in minutes and status (CANCELED/SKIPPED). Requires env OPENTRANSPORTDATA_API_KEY (free). For line names and platforms prefer get_departures.

Input parameters:

- `limit` (integer)
- `min_delay_minutes` (number): Only trips delayed at least this much (cancellations always shown)
- `station_id` (string, required): 7-digit UIC/DiDok number, e.g. '8503000'

### `lookup_uid` (~155 tokens)

Look up a Swiss UID

Look up one entity in the federal UID register (BFS) by its UID — e.g. 'CHE-107.028.276', 'CHE107028276', '107028276' or a VAT number 'CHE-107.028.276 MWST'. Validates the check digit first (offline). Returns name, legal form, address, UID status, VAT register status (registered yes/no, VAT number, entry date) and commercial-register status. Covers ALL UID holders incl. associations, foundations, sole proprietors and public bodies that are not in ZEFIX.

Input parameters:

- `uid` (string, required): UID in any format, e.g. 'CHE-107.028.276' or '107028276'

### `search_uid_register` (~165 tokens)

Search the UID register by name

Search the federal UID register (BFS) by entity name — covers every UID holder (companies, associations, foundations, sole proprietors, public administrations), not just commercial-register entries. Optionally narrow by canton ('ZH') or postcode ('8001'); these filters are applied to the returned candidates. Returns UID, name, legal form, address, VAT and commercial-register status. Example: name='Pro Natura', name='Gemeinde Köniz'.

Input parameters:

- `canton` (string): Optional canton filter, e.g. 'BE'
- `limit` (integer)
- `name` (string, required): Entity name or fragment, e.g. 'Migros', 'Verein Pro Velo'
- `postcode` (string): Optional Swiss postcode filter, e.g. '3001'

### `validate_vat_number` (~150 tokens)

Validate a Swiss VAT number

Check whether a Swiss VAT number (MWST/TVA/IVA) is valid and active in the federal VAT register via the UID register, e.g. 'CHE-107.028.276 MWST', 'CHE107028276TVA' or '107028276'. Returns valid true/false, the normalised VAT number and (with include_details) the holder's name, address and VAT entry date — use it for supplier/invoice checks.

Input parameters:

- `include_details` (boolean): Also fetch the holder's name/address/VAT dates (one extra request)
- `vat_number` (string, required): Swiss VAT number, e.g. 'CHE-107.028.276 MWST'

### `search_court_decisions` (~318 tokens)

Search Swiss court decisions

Full-text search across Swiss court decisions aggregated by entscheidsuche.ch: Federal Supreme Court (BGer/BGE), Federal Administrative Court (BVGer), Federal Criminal Court (BStGer), Federal Patent Court and the courts of all 26 cantons. Returns docket/reference number, decision date, court, canton, title, abstract snippet, matching text excerpts and a link to the decision (PDF/HTML). Query syntax: words are AND-ed; use "quotes" for phrases, | for OR, - to exclude. Examples: query='Mietzins Kündigung' canton='ZH'; query='"Art. 336 OR"' court='BGer' date_from='2020'; query='5A_123/2020'.

Input parameters:

- `canton` (string): Canton code, e.g. 'ZH'; 'CH' = federal courts
- `court` (string): Court: 'BGer', 'BGE', 'BVGer', 'BStGer', 'BPatGer', or an index code like 'ZH_OG' / 'CH_BGer'
- `date_from` (string): Earliest decision date, e.g. '2020' or '2020-01-31'
- `date_to` (string): Latest decision date
- `language` (string): Preferred language for titles/abstracts (boosted, not filtered)
- `limit` (integer)
- `query` (string, required): Search terms, a legal provision or a docket number
- `sort` (string)

### `get_court_decision` (~131 tokens)

Get a Swiss court decision

Fetch one court decision from entscheidsuche.ch by its id (from search_court_decisions, e.g. 'CH_BGer_005_5A-123-2020_2020-06-15'). Returns metadata (reference, date, court, canton, title, abstract), the document link and a plain-text excerpt of the decision (up to ~20 KB).

Input parameters:

- `id` (string, required): Decision id from search_court_decisions
- `language` (string): Preferred language for title/abstract
- `max_chars` (integer): Maximum excerpt length in characters

### `search_wikidata` (~205 tokens)

Search Wikidata entities

Find Wikidata items (Q-ids) by name — the universal join key for Swiss municipalities, cantons, mountains, lakes, rivers, companies, people and institutions. Returns id, label, description and match. Set swiss_only=true to keep only items whose country (P17) or citizenship (P27) is Switzerland (Q39). Examples: 'Matterhorn', 'Lac Léman', 'Nestlé', 'ETH Zürich', 'Winterthur' (swiss_only=true). Follow up with get_wikidata_entity.

Input parameters:

- `language` (string): Search/label language: de, fr, it, rm or en (default en)
- `limit` (integer): Max results (1-50, default 10)
- `query` (string, required): Name or label to search, e.g. 'Matterhorn', 'Roche', 'Aare'
- `swiss_only` (boolean): Restrict to items with country or citizenship = Switzerland

### `get_wikidata_entity` (~208 tokens)

Wikidata entity details

Read one Wikidata item by Q-id: labels in de/fr/it/rm/en, description, the key statements with values resolved to labels (instance of, country, located in, coordinates, population, area, elevation, website, inception, headquarters, industry, …; up to max_properties), Swiss identifiers (BFS municipality code P771, HLS/DHS id P902, parliament id P1307), and de/fr/it/rm/en Wikipedia links. Examples: 'Q72' (Zürich), 'Q1374' (Matterhorn), 'Q11943' (ETH Zürich).

Input parameters:

- `id` (string, required): Wikidata Q-id, e.g. 'Q72', or an entity URI
- `language` (string): Language for resolved value labels (default en)
- `max_properties` (integer): Max properties to include (default 30)
- `max_values_per_property` (integer): Max values per property (default 5)

### `query_wikidata` (~197 tokens)

SPARQL query on Wikidata

Run a read-only SPARQL SELECT (or ASK) against the Wikidata Query Service. Prefixes wd:, wdt:, p:, ps:, pq:, rdfs:, schema:, wikibase:, bd: are predefined; use SERVICE wikibase:label { bd:serviceParam wikibase:language "de,fr,en". } for labels. Swiss hooks: wd:Q39 = Switzerland, wdt:P771 = BFS municipality code, wdt:P17 = country, wdt:P131 = located in. Example: SELECT ?m ?mLabel ?bfs WHERE { ?m wdt:P771 ?bfs . SERVICE wikibase:label { bd:serviceParam wikibase:language "de". } }. LIMIT 100 is injected when absent; larger LIMITs are clamped to 1000. 60 s timeout.

Input parameters:

- `query` (string, required): SPARQL SELECT/ASK query (read-only)

### `get_swiss_municipality_facts` (~206 tokens)

Swiss municipality facts (Wikidata)

Wikidata facts for a Swiss municipality by name or BFS number (P771): Q-id, labels, canton, population (latest, with date), area km², elevation m, coordinates, postal codes, official website, coat of arms image, HLS/DHS id and Wikipedia link. Examples: bfs_number=261 (Zürich), name='Lugano', name='Val de Bagnes'. For official BFS statistics prefer get_population / get_municipality; use this for the Q-id join key and enrichment.

Input parameters:

- `bfs_number` (integer): BFS municipality number, e.g. 261 (Zürich), 351 (Bern)
- `include_former` (boolean): Also match dissolved/merged municipalities
- `language` (string): Language for labels and the Wikipedia link (default en)
- `name` (string): Municipality name in any national language, e.g. 'Bern', 'Genève', 'Chur'

### `search_bfs_tables` (~191 tokens)

Search BFS STAT-TAB statistical tables

Find Federal Statistical Office (BFS) tables on STAT-TAB by keywords: population, births, deaths, migration, tourism overnight stays, crime, students, vehicles, buildings, enterprises and hundreds more. Returns table ids (e.g. 'px-x-0102010000_101') with titles, to pass to get_bfs_table_metadata then query_bfs_table. Titles are in the chosen language, so use matching search terms (e.g. lang='de', query 'Logiernächte Kanton'). Examples: {query:'population commune age'}, {query:'hotel overnight stays', lang:'en'}.

Input parameters:

- `lang` (string): Language of titles/labels: de, fr, it or en (default en)
- `limit` (integer)
- `query` (string, required): Keywords, e.g. 'population canton', 'Straftaten', 'overnight stays'

### `browse_bfs_tables` (~196 tokens)

Browse the BFS STAT-TAB table tree

List entries of the BFS PXWeb database tree. Without 'path' lists all STAT-TAB databases (at BFS each is one table, id like 'px-x-1003020000_101', with its title); with 'path' lists that node's children (type level/table, text, updated). Use 'filter' to substring-match titles. Examples: {filter:'Wohnbevölkerung', lang:'de'}, {path:'px-x-0102010000_101'}.

Input parameters:

- `filter` (string): Case/diacritic-insensitive substring filter on titles or ids
- `lang` (string): Language of titles/labels: de, fr, it or en (default en)
- `limit` (integer)
- `offset` (integer)
- `path` (string): Node path, e.g. 'px-x-0102010000_101'. Omit for the root listing.

### `get_bfs_table_metadata` (~244 tokens)

Describe a BFS STAT-TAB table

Dimensions of one STAT-TAB table: each variable's code, label, number of values, first values (code + label), which one is time (with range), the default used when unspecified, and the cell count. Pass 'variable' to list (and 'value_filter' to search) all values of one dimension, e.g. to find a commune code. Examples: {table_id:'px-x-0102010000_101'}, {table_id:'px-x-0102010000_101', variable:'Kanton', value_filter:'Bern'}.

Input parameters:

- `lang` (string): Language of titles/labels: de, fr, it or en (default en)
- `limit` (integer): With 'variable': max values listed
- `max_values` (integer): Values shown per variable
- `table_id` (string, required): Table id like 'px-x-0102010000_101' (or its API path / STAT-TAB URL)
- `value_filter` (string): With 'variable': substring filter on value codes/labels
- `variable` (string): List values of this variable only (code or label)

### `query_bfs_table` (~276 tokens)

Query data from a BFS STAT-TAB table

Fetch labelled figures from any STAT-TAB table. 'selection' maps variables (code or label, case/accents ignored) to values (codes or labels); '*' = all values, 'latest' / 'latest:5' = last period(s), '2015-2020' = year range. Unspecified variables default to their total (e.g. 'Schweiz', 'Total') or the latest period, and the response lists every default applied. Max 5000 cells per query. Returns rows like {Kanton:'Zürich', value:1605508} plus 'fixed' for single-valued dimensions. Example: {table_id:'px-x-0102010000_101', selection:{Jahr:['latest'], Kanton:['Zürich','Bern'], Geschlecht:['*']}}.

Input parameters:

- `include_codes` (boolean): Also return value codes next to labels
- `lang` (string): Language of titles/labels: de, fr, it or en (default en)
- `limit` (integer): Max rows returned
- `selection` (object): Map variable → values, e.g. {"Jahr": ["latest"], "Kanton": ["*"]}
- `table_id` (string, required): Table id like 'px-x-0102010000_101'

### `search_data_cubes` (~280 tokens)

Search LINDAS statistical data cubes

Keyword search over the federal statistical data cubes on LINDAS (the data behind visualize.admin.ch): electricity prices (ElCom), energy statistics (BFE), environment/air/water (BAFU), agriculture (FOAG), traffic counts (ASTRA), population and economy (BFS) and more. Every word must appear (case-insensitive) in the cube's name, description, publisher or IRI, in any language (German terms often match best, e.g. 'Strompreis', 'Luft', 'Verkehr'). Returns cube IRI, name, trimmed description, publisher, last-modified date and a visualize.admin.ch link. Deprecated cube versions are excluded; published cubes shown on visualize.admin.ch rank first. Next step: describe_data_cube {cube: <IRI>}. Examples: {query: 'electricity price'}, {query: 'Treibhausgas', lang: 'de'}, {query: 'bfe energie', limit: 10}.

Input parameters:

- `lang` (string): Preferred language for names/descriptions (falls back to de/fr/it/en)
- `limit` (integer)
- `offset` (integer)
- `published_only` (boolean): Exclude cubes whose status is Draft
- `query` (string): Keywords (all must match). Empty lists the most recently modified cubes.

### `describe_data_cube` (~183 tokens)

Describe a LINDAS data cube

Show the structure of one LINDAS statistical cube so you can query it: title, publisher, licence, status, dates, and every dimension with its IRI, label, role (key dimension vs measure), unit, datatype, min/max, and up to N example values with labels (sampled from the cube's value lists and observations). Use the dimension labels and example value labels as filters in query_data_cube. Example: {cube: 'https://energy.ld.admin.ch/elcom/electricityprice'}, {cube: '<IRI from search_data_cubes>', examples: 20, lang: 'de'}.

Input parameters:

- `cube` (string, required): Cube IRI from search_data_cubes (or a visualize.admin.ch ?dataset= link)
- `examples` (integer): Example values per key dimension (0 = skip)
- `lang` (string)

### `query_data_cube` (~320 tokens)

Query observations from a LINDAS data cube

Fetch observations from a LINDAS statistical cube as flat rows keyed by dimension labels (IRI values replaced by their human labels; numbers as numbers). Optional filters map a dimension (label, IRI or IRI local name) to one value or a list of values (label, literal such as a year, or IRI) — matching is exact and case-insensitive; get valid values from describe_data_cube. Returns columns (with role and unit), rows and row_count. limit default 100, max 1000 (large results are trimmed to fit 50 KB). Examples: {cube: 'https://energy.ld.admin.ch/elcom/electricityprice', filters: {'Period': '2025', 'Category': 'H4'}, limit: 50}, {cube: '<IRI>', filters: {'Canton': ['Zürich', 'Bern']}}.

Input parameters:

- `cube` (string, required): Cube IRI from search_data_cubes
- `filters` (object): {dimension label/IRI: value label/IRI or array of them}. Max 10 filters.
- `include_iris` (boolean): Also return the raw IRI of each IRI-valued cell as '<column> IRI'
- `include_sparql` (boolean): Return the generated SPARQL (to adapt with query_lindas)
- `lang` (string)
- `limit` (integer)
- `offset` (integer): Skip observations for paging (stable order; max 10000 — use filters to reach deeper data)

### `search_map_layers` (~189 tokens)

Search the geo.admin.ch map layer catalogue

Full-text search over the ~900 federal map layers on geo.admin.ch (noise, natural hazards, radon, zoning, protected areas, energy, transport, geology, …). Returns layer ids (e.g. 'ch.bafu.laerm-strassenlaerm_tag') with titles. Next: get_layer_info for fields/metadata, or query_layer_at_point to read values at a location. Examples: query='Strassenlärm', 'radon', 'Grundwasserschutz', 'solar', 'Bauzonen'.

Input parameters:

- `lang` (string): Language for labels/attributes: de, fr, it, rm or en (default en)
- `limit` (integer): Max layers (default 15, max 30)
- `query` (string, required): Keywords (any national language or English), e.g. 'noise', 'Hochwasser', 'antennas'

### `get_layer_info` (~150 tokens)

Get a geo.admin.ch layer's fields and metadata

Describe one geo.admin.ch layer: title, abstract, data owner, whether it is queryable (identify/find work), time-enabled, attribute fields (name/alias/type + sample values) and legend/map links. Use before find_layer_features (to pick a search field) or to interpret query_layer_at_point attributes. Example: layer_id='ch.bag.radonkarte'.

Input parameters:

- `lang` (string): Language for labels/attributes: de, fr, it, rm or en (default en)
- `layer_id` (string, required): geo.admin.ch layer id (BOD id), e.g. 'ch.bafu.laerm-strassenlaerm_tag' — find ids with search_map_layers

### `query_layer_at_point` (~409 tokens)

Query up to 15 geo.admin.ch layers at a point, radius or bbox

Read the attributes of any federal map layers at a WGS84 location: point-in-polygon (radius_m=0), everything within a radius in metres (e.g. antennas within 300 m), or everything inside a bbox. Up to 15 layers per call; results grouped per layer, with per-layer errors isolated if a layer id is bad. Examples: layers='ch.bafu.laerm-strassenlaerm_tag,ch.bag.radonkarte', lat=46.948, lon=7.4474; layers='ch.bakom.standorte-mobilfunkanlagen', radius_m=300, return_geometry=true. Use search_map_layers to find layer ids; for a ready-made multi-layer summary use get_location_report.

Input parameters:

- `bbox` (array): Alternative to lat/lon: WGS84 bbox [minLon,minLat,maxLon,maxLat], max ~5 km per side
- `lang` (string): Language for labels/attributes: de, fr, it, rm or en (default en)
- `lat` (number): WGS84 latitude, e.g. 46.9480 (Switzerland ≈ 45.8–47.8)
- `layers` (string, required): Comma-separated layer ids (max 15), e.g. 'ch.bafu.laerm-strassenlaerm_tag,ch.are.bauzonen'
- `lon` (number): WGS84 longitude, e.g. 7.4474 (Switzerland ≈ 5.9–10.5)
- `per_layer_limit` (integer): Max features returned per layer (default 5)
- `radius_m` (number): Search radius in metres around lat/lon (0 = exactly at the point; max 2000)
- `return_geometry` (boolean): Include a WGS84 anchor point per feature (useful with radius/bbox)
- `time_instant` (integer): Year for time-enabled layers (see get_layer_info)

### `find_layer_features` (~231 tokens)

Search a geo.admin.ch layer by attribute value

Attribute search within one geo.admin.ch layer (MapServer/find): returns features whose field contains (or equals) the text. Examples: layer_id='ch.bfs.gebaeude_wohnungs_register', search_field='egid', search_text='1231641', contains=false; layer_id='ch.bafu.bundesinventare-bln', search_field='bln_name', search_text='Aletsch'. Use get_layer_info to see field names.

Input parameters:

- `contains` (boolean): true = substring match (default), false = exact match
- `lang` (string): Language for labels/attributes: de, fr, it, rm or en (default en)
- `layer_id` (string, required): geo.admin.ch layer id (BOD id), e.g. 'ch.bafu.laerm-strassenlaerm_tag' — find ids with search_map_layers
- `limit` (integer): Max features (default 10)
- `search_field` (string, required): Attribute field to search (see get_layer_info 'fields')
- `search_text` (string, required): Value or substring to look for

### `get_layer_feature` (~172 tokens)

Get geo.admin.ch feature(s) by id

Fetch the full attributes of one or more features of a geo.admin.ch layer by feature id (ids come from query_layer_at_point or find_layer_features). Example: layer_id='ch.bfs.gebaeude_wohnungs_register', feature_id='1231641_0'. Up to 10 comma-separated ids.

Input parameters:

- `feature_id` (string, required): Feature id, or up to 10 comma-separated ids
- `lang` (string): Language for labels/attributes: de, fr, it, rm or en (default en)
- `layer_id` (string, required): geo.admin.ch layer id (BOD id), e.g. 'ch.bafu.laerm-strassenlaerm_tag' — find ids with search_map_layers
- `return_geometry` (boolean): Include a WGS84 anchor point

### `get_location_report` (~320 tokens)

Federal geodata report for a Swiss address or point

One-call location due-diligence: geocodes an address (or takes lat/lon) and queries ~20 curated federal layers in parallel — municipality & postcode, registered buildings (GWR), building zone, public-transport quality class, road & rail noise day/night, radon, surface-runoff flooding, seismic subsoil class, groundwater protection zones, contaminated sites, mobile antennas within 300 m, ISOS townscape, BLN landscape, roof solar suitability and district heating networks. Each layer reports status match/no_match/error independently. Examples: address='Bundesplatz 3, Bern'; lat=47.3769, lon=8.5417, topics=['noise','hazards'].

Input parameters:

- `address` (string): Swiss address or place, e.g. 'Bahnhofstrasse 1, Zürich'
- `extra_layers` (string): Up to 5 additional comma-separated layer ids to include (point query)
- `lang` (string): Language for labels/attributes: de, fr, it, rm or en (default en)
- `lat` (number): WGS84 latitude, e.g. 46.9480 (Switzerland ≈ 45.8–47.8)
- `lon` (number): WGS84 longitude, e.g. 7.4474 (Switzerland ≈ 5.9–10.5)
- `topics` (array): Restrict to topics: admin, buildings, mobility, noise, hazards, environment, heritage, energy (default all)

### `search_geodata_collections` (~212 tokens)

Search the geo.admin.ch STAC data catalogue

Keyword search over the downloadable federal geodata collections on data.geo.admin.ch (STAC): swisstopo elevation/imagery/maps, BAFU/BFE/ARE datasets and MeteoSwiss open data — e.g. 'ch.meteoschweiz.ogd-smn' (SwissMetNet automatic weather stations), 'ch.meteoschweiz.ogd-nime' (manual precipitation), 'ch.meteoschweiz.ogd-pollen'. Returns collection ids, titles, licence, providers and time extent. Next: get_geodata_collection_items. Examples: query='meteoschweiz', 'swissalti3d', 'Lärm'. Omit query to page through all collections.

Input parameters:

- `limit` (integer): Max collections (default 20)
- `offset` (integer): Skip this many matches (paging)
- `query` (string): Keywords matched against id, title, description, keywords and providers (all must match)

### `get_geodata_collection_items` (~399 tokens)

List items and downloadable assets of a STAC collection

List the items (tiles, stations, time slices) of a data.geo.admin.ch STAC collection with their downloadable assets (href, media type, size), plus collection-level assets (e.g. MeteoSwiss station/parameter metadata CSVs). Filter by WGS84 bbox, datetime or a single item id; asset_filter narrows asset keys. Examples: collection='ch.meteoschweiz.ogd-smn', item_id='ber' (Bern-Zollikofen station), asset_filter='_d_' (daily data); collection='ch.swisstopo.swissalti3d', bbox=[7.43,46.94,7.46,46.96]. Next: read_geodata_asset on a CSV/JSON href.

Input parameters:

- `asset_filter` (string): Only assets whose key/title contains this text, e.g. '.csv', '_h_recent', '2m'
- `bbox` (array): WGS84 bbox [minLon, minLat, maxLon, maxLat], e.g. [7.43, 46.94, 7.46, 46.96]
- `collection` (string, required): STAC collection id
- `datetime` (string): RFC 3339 instant or interval, e.g. '2023-01-01T00:00:00Z/2023-12-31T23:59:59Z' or '2024-01-01T00:00:00Z/..'
- `include_collection_assets` (boolean): Also list collection-level assets (metadata files)
- `item_id` (string): Fetch one item by id (e.g. a MeteoSwiss station abbreviation in lower case, 'ber')
- `limit` (integer): Items per page (default 10)
- `page_url` (string): The 'next_page_url' from a previous call, to continue paging

### `read_geodata_asset` (~340 tokens)

Read and query a CSV/JSON data file from data.geo.admin.ch

Download a CSV or JSON asset from data.geo.admin.ch (href from get_geodata_collection_items) and return it as rows you can filter, sort and page — e.g. MeteoSwiss SwissMetNet station files. Filters: where={column: value} (exact), '~text' (substring), '>n'/'<n' (numeric). tail=true returns the latest rows of a time series. Example: url='https://data.geo.admin.ch/ch.meteoschweiz.ogd-smn/ber/ogd-smn_ber_d_recent.csv', tail=true, limit=7, columns=['reference_timestamp','tre200d0','rre150d0']. Large historical files may exceed max_mb — prefer '_recent' or '_now' files.

Input parameters:

- `columns` (array): Columns to return (default all; max 40)
- `limit` (integer): Max rows (default 50)
- `max_mb` (number): Download size cap in MB (default 8, max 20)
- `offset` (integer): Skip this many matching rows (ignored with tail)
- `search` (string): Case-insensitive text search across all columns
- `sort` (string): Sort column; prefix '-' for descending
- `tail` (boolean): Return the LAST matching rows (latest values of a time series)
- `url` (string, required): Asset href on https://data.geo.admin.ch/ (CSV, TXT or JSON/GeoJSON)
- `where` (object): Column filters, e.g. {"station_abbr": "BER"} or {"tre200d0": ">25"}

### `search_sanctions_list` (~259 tokens)

Search the Swiss sanctions list

Screen a person, company or vessel name against the Swiss consolidated sanctions list (SECO, all embargo programmes: Russia/Ukraine, Belarus, Iran, Syria, North Korea, ISIL/Al-Qaida, …). Matching is case- and diacritic-insensitive over primary names, aliases and Latin transliterations; all query words must match (as words or word prefixes). Returns current listings only unless include_delisted=true. A hit is a lead, not a legal determination: compare birth dates, nationality and documents via get_sanctions_entry. Example: {name: 'Rotenberg'}, {name: 'Aeroflot', type: 'entity'}.

Input parameters:

- `include_delisted` (boolean): Also return entries that have since been de-listed
- `limit` (integer)
- `name` (string, required): Name or name fragment, e.g. 'Arkady Rotenberg', 'Sovcomflot'
- `program` (string): Restrict to a sanctions programme, e.g. 'Ukraine', 'Iran', 'Syria' (see list_sanctions_programs)
- `type` (string): Restrict to individuals, entities (companies/organisations) or objects (vessels, aircraft)

### `get_sanctions_entry` (~84 tokens)

Sanctions list entry

Full SECO sanctions-list entry by id (from search_sanctions_list): all names and transliterations, birth dates and places, nationalities, addresses, identity documents, justification, legal basis (programme and annex), related entries and listing status/history.

Input parameters:

- `id` (string, required): Entry id from search_sanctions_list, e.g. '5142'

### `list_sanctions_programs` (~57 tokens)

Swiss sanctions programmes

All Swiss sanctions programmes (embargo ordinances) on the SECO list with their legal basis, origin (UN/EU/CH), annexes/measure sets and the number of currently listed individuals, entities and objects.

### `search_public_tenders` (~344 tokens)

Search Swiss public tenders & awards

Search procurement projects on simap.ch (Confederation, cantons, municipalities, public companies). Filter by text, cantons of performance, project type, latest notice type (e.g. 'tender' = open calls, 'award_tender' = awarded contracts) and publication date. Needs `query` (3+ chars) or at least one filter. Results are newest first; pass `next_cursor` back as `cursor` for the next page. Example: {query: 'Schulhaus', cantons: ['ZH'], notice_types: ['tender']}.

Input parameters:

- `cantons` (array): Cantons where the contract is performed, e.g. ['ZH','AG']
- `cpv_codes` (array): 8-digit CPV codes (see search_cpv_codes), e.g. ['45233140']
- `cursor` (string): Pagination cursor (`next_cursor` from the previous page)
- `lang` (string): Language for titles and texts (falls back to the notice's original language)
- `notice_types` (array): Type of the newest notice: tender (open call), award_tender (award), direct_award, advance_notice, revocation, …
- `project_types` (array): construction | service | supply | *_competition | *_study | request_for_information
- `published_from` (string): Newest notice on/after this date (YYYY-MM-DD)
- `published_until` (string): Newest notice on/before this date (YYYY-MM-DD)
- `query` (string): Search text (title, description), e.g. 'Reinigung', 'Software', 'Brücke'

### `get_tender_details` (~122 tokens)

Public tender / award notice details

Full simap.ch notice: contracting authority and contact, description, place of performance, CPV codes, procedure, offer deadline, lots and — for award notices — the award decision (winning vendors, awarded price, number of offers, justification). Use project_id + publication_id from search_public_tenders.

Input parameters:

- `lang` (string): Language for titles and texts (falls back to the notice's original language)
- `project_id` (string, required): project_id from search_public_tenders
- `publication_id` (string, required): publication_id from search_public_tenders

### `search_cpv_codes` (~94 tokens)

Find CPV procurement codes

Look up Common Procurement Vocabulary (CPV) codes by keyword or partial number, e.g. 'Strassenbau', 'software', '4523'. Use the 8-digit codes as `cpv_codes` in search_public_tenders.

Input parameters:

- `lang` (string): Language for titles and texts (falls back to the notice's original language)
- `limit` (integer)
- `query` (string, required)

### `list_disease_surveillance_topics` (~44 tokens)

FOPH disease surveillance topics

Topics available from the FOPH infectious-disease dashboard (id, disease, surveillance system, time resolution). Use the id with get_disease_surveillance.

### `get_disease_surveillance` (~360 tokens)

Infectious disease cases & incidence

Latest surveillance data for one FOPH topic and region: reported cases (or GP consultations / detections / wastewater load) per week, month or year, with incidence per 100'000 and trend where published. region: 'CHFL' (Switzerland + Liechtenstein, default for mandatory reporting), 'CH', a canton code ('ZH'), or a wastewater plant (e.g. 'basel'). breakdown: 'agegroup', 'sex', 'pathogen' or 'subtype' (variants) to split the totals. Recent periods are provisional. Example: {topic: 'influenza', region: 'ZH', last_periods: 8}.

Input parameters:

- `breakdown` (string): Split totals by this dimension
- `filters` (object): Pin other dimensions, e.g. {pathogen: 'influenza'}
- `from` (string): Return all periods from this one on instead, e.g. '2025-W40', '2024-M01', '2025-10-01'
- `last_periods` (integer): Number of most recent periods (weeks/months/years) to return
- `region` (string): CHFL, CH, FL, a canton code (ZH, BE, …) or a wastewater plant name
- `topic` (string, required): Topic id from list_disease_surveillance_topics, e.g. 'influenza', 'covid19', 'tbe', 'respiratory_viruses_wastewater'
- `value_category` (string): Measure, e.g. 'cases', 'consultations', 'detections', or a virus for wastewater ('influenza_a', 'sars-cov-2'); defaults to the main one

### `search_local_parliaments` (~131 tokens)

Find cantonal/municipal parliaments

Find Swiss cantons, cities and municipalities in OpenParlData and whether their parliament is covered; returns the body_key used by the other local-politics tools. Example: {query: 'Winterthur'} or {canton: 'BE', with_parliament: true}.

Input parameters:

- `canton` (string): Only bodies in this canton
- `lang` (string)
- `limit` (integer)
- `query` (string): Name of a canton, city or municipality
- `type` (string)
- `with_parliament` (boolean): Only bodies whose parliament data is covered

### `search_local_parliament_business` (~178 tokens)

Cantonal/municipal parliamentary business

Search motions, postulates, interpellations, questions and bills in cantonal and municipal parliaments, newest first. Filter by parliament (body_key) and text. Example: {query: 'Velo', body_key: 'ZH'} or {body_key: '261'} for the latest business of Zürich city parliament.

Input parameters:

- `body_key` (string): Parliament: canton code ('ZH', 'VD') or BFS municipality number ('261' = City of Zürich); see search_local_parliaments
- `full_text` (boolean): Also search in documents and texts (slower)
- `lang` (string)
- `limit` (integer)
- `offset` (integer)
- `query` (string): Words in the title/metadata, e.g. 'Tempo 30', 'Wohnungsnot'

### `get_local_parliament_business` (~64 tokens)

Cantonal/municipal business details

One item of cantonal/municipal parliamentary business by id: title, type, status, dates, authors (contributors), documents and votes where available.

Input parameters:

- `id` (integer, required): Business id from search_local_parliament_business
- `lang` (string)

### `search_local_politicians` (~121 tokens)

Cantonal/municipal politicians

Find members of cantonal and municipal parliaments by name, optionally in one parliament: party, electoral district, occupation. Example: {query: 'Meier', body_key: 'ZH'}.

Input parameters:

- `body_key` (string): Parliament: canton code ('ZH', 'VD') or BFS municipality number ('261' = City of Zürich); see search_local_parliaments
- `lang` (string)
- `limit` (integer)
- `offset` (integer)
- `query` (string): Name or part of it

### `search_federal_metadata` (~149 tokens)

Search the federal data catalogue (I14Y)

Search I14Y, the Swiss federal interoperability platform: datasets (incl. non-public registers, with their access rights), data services/APIs, public services and concepts/code lists from federal, cantonal and municipal bodies. Use it to find which authority holds what data, or the identifier of an official code list. Example: {query: 'NOGA', types: ['Concept']}, {query: 'Gebäude', types: ['Dataset']}.

Input parameters:

- `lang` (string)
- `limit` (integer)
- `query` (string, required)
- `types` (array): Restrict to Dataset, DataService, Concept (incl. code lists), PublicService, MappingTable

### `lookup_code_list` (~157 tokens)

Look up an official code list (I14Y)

Search the entries of an official Swiss code list on I14Y by code or text, e.g. NOGA industry classification ({codelist: 'NOGA_CLASS', query: 'bank'} or {codelist: 'NOGA_CLASS', query: '6419'}), NOGA levels NOGA_SECTION/NOGA_DIVISION/NOGA_GROUP/NOGA_CLASS/NOGA_TYPE, or any code list found with search_federal_metadata (pass its identifier or id).

Input parameters:

- `codelist` (string, required): Code list identifier (e.g. 'NOGA_CLASS') or concept id (UUID)
- `lang` (string)
- `limit` (integer)
- `query` (string, required): Code or words to search for

### `search_library_catalogue` (~155 tokens)

Search Swiss academic libraries (swisscovery)

Search the swisscovery union catalogue of Swiss academic libraries by keywords, title, author, subject or ISBN (fields are combined with AND). Returns bibliographic records (title, creators, publisher, year, ISBN, subjects, online links) and a swisscovery link to check holdings/availability. Example: {author: 'Spyri', title: 'Heidi'}, {subject: 'Gletscher', keywords: 'Klimawandel'}.

Input parameters:

- `author` (string)
- `isbn` (string)
- `keywords` (string): Free-text keywords (all fields)
- `limit` (integer)
- `offset` (integer)
- `subject` (string)
- `title` (string)

### `list_glaciers` (~96 tokens)

Swiss monitored glaciers (GLAMOS)

Glaciers in the Swiss monitoring network with SGI id, area (km²), coordinates and which measurement series exist (length change, mass balance, volume change). Filter by name; sorted by area. Example: {query: 'Aletsch'}.

Input parameters:

- `limit` (integer)
- `query` (string): Name fragment, e.g. 'Rhone', 'Aletsch', 'Morteratsch'

### `get_glacier_changes` (~139 tokens)

Glacier length, mass and volume change (GLAMOS)

Measured changes of one Swiss glacier: front variation per survey interval (m) with cumulative retreat, annual/winter/summer mass balance (mm water equivalent) with ELA, and geodetic volume change (km³, mean thickness change). Give a name or SGI id. Example: {glacier: 'Rhonegletscher'}, {glacier: 'B43-03', series: 'length'}.

Input parameters:

- `glacier` (string, required): Glacier name (or part) or SGI id from list_glaciers
- `last` (integer): Most recent N observations per series
- `series` (string)

### `get_land_restrictions` (~204 tokens)

Public-law restrictions on a parcel (ÖREB)

ÖREB cadastre extract for the land parcel at a point (WGS84) or by EGRID: which restriction themes concern the parcel (land-use zoning, building lines, noise sensitivity, groundwater protection, contaminated sites, …), each restriction with legend text, legal status, affected area/percentage and links to the legal provisions; plus the themes that do NOT concern it. Includes the link to the official PDF extract (the only legally binding version). Use geocode first for an address. Example: {lat: 47.3769, lon: 8.5417}.

Input parameters:

- `egrid` (string): Federal parcel id (EGRID), e.g. 'CH399977799134'
- `lang` (string): Language of the extract (cantons publish de/fr/it; others fall back)
- `lat` (number): WGS84 latitude inside the parcel
- `lon` (number): WGS84 longitude inside the parcel

### `search_dams` (~190 tokens)

Search and rank Swiss dams

Search the federal dam register (SFOE, ~225 dams) by dam, reservoir or facility name, purpose (hydroelectricity, flood protection, irrigation, …) or dam type (arch, gravity, embankment, …), ranked by height, volume, crest length or year built. With no filters it ranks all dams, e.g. the tallest or largest. Examples: {query:'Dixence'}, {sort_by:'volume'}, {purpose:'flood'}.

Input parameters:

- `limit` (integer)
- `order` (string)
- `purpose` (string): e.g. hydroelectricity, flood protection, irrigation, drinking water
- `query` (string): Dam, reservoir or facility name (partial, accents optional)
- `sort_by` (string)
- `type` (string): e.g. arch, gravity, embankment, buttress

### `get_dams_nearby` (~97 tokens)

Dams near a point

Dams under federal supervision within radius_km of a WGS84 point, nearest first, with exact distances. Example: {lat: 46.08, lon: 7.40, radius_km: 15}.

Input parameters:

- `lat` (number, required): WGS84 latitude
- `limit` (integer)
- `lon` (number, required): WGS84 longitude
- `radius_km` (number)

### `get_traffic_counts` (~204 tokens)

Road traffic counts by station, road or canton

Annual average traffic from FEDRO's automatic counting stations: vehicles per day (all days and weekdays), morning and evening peak hours, day and night hourly averages, and heavy-goods share. Filter by station or place name, road (A1, A 2, H 18) or canton (UR, GR, …); sorted by daily volume or heavy-goods share. With no filter it ranks the busiest stations nationwide. Examples: {station:'Gotthard'}, {road:'A1', canton:'ZH'}, {sort_by:'heavy_share'}.

Input parameters:

- `canton` (string): Two-letter canton code, e.g. UR
- `limit` (integer)
- `road` (string): Road designation, e.g. A1, A 13, H 18
- `sort_by` (string)
- `station` (string): Station or place name, partial (e.g. 'Gotthard', 'Muttenz')

### `get_traffic_counts_nearby` (~102 tokens)

Traffic counting stations near a point

FEDRO counting stations within radius_km of a WGS84 point, nearest first, with exact distances and their annual traffic figures. Example: {lat: 47.05, lon: 8.31, radius_km: 10}.

Input parameters:

- `lat` (number, required): WGS84 latitude
- `limit` (integer)
- `lon` (number, required): WGS84 longitude
- `radius_km` (number)

### `get_station_ridership` (~110 tokens)

Passengers per day at an SBB station

Average daily boardings and alightings at an SBB station (all days, weekdays, weekends), by year, with the change against the previous year. Use the official station name; close matches are suggested if it is not exact. Example: {station:'Zürich HB'}.

Input parameters:

- `station` (string, required): Official station name, e.g. 'Bern', 'Zürich HB', 'Lausanne'
- `years` (integer): How many recent years to return

### `get_station_punctuality` (~136 tokens)

Yesterday's punctuality at an SBB station

Punctuality at a station on the previous operating day, from SBB's published actual times: number of stops, share of on-time arrivals and departures (SBB's delay threshold, about 3 minutes), cancellations, and the lines with the most delayed arrivals. Optional line filter (e.g. 'IC1', 'S3'). Example: {station:'Olten'}.

Input parameters:

- `line` (string): Only this line, e.g. IC1, IR15, S3
- `station` (string, required): Official stop name, e.g. 'Olten', 'Zürich HB'

### `get_station_platforms` (~77 tokens)

Platforms and track-free access at an SBB station

The platforms of an SBB station: number, type, length in metres, and whether passengers can reach them without crossing tracks (underpass, overpass or level access). Useful for accessibility and for long trains. Example: {station:'Bern'}.

Input parameters:

- `station` (string, required): Official station name, e.g. 'Bern'

### `get_property_price_index` (~151 tokens)

Swiss residential property price index

The FSO residential property price index (IMPI, Q4 2019 = 100), quarterly from 2017: all residential property, single-family houses and owner-occupied apartments, with year-on-year change and change over the selected period. Purchase prices, not rents. Examples: {} (latest 8 quarters), {from:'2020', to:'2025-Q2'}.

Input parameters:

- `from` (string): First period, e.g. 2020 or 2020-Q1
- `last` (integer): Quarters to return when from/to are not given
- `to` (string): Last period, e.g. 2025 or 2025-Q2

### `find_data` (~229 tokens)

Find Swiss data across every catalogue

START HERE for any Swiss data question not obviously covered by a specific tool. Searches all connected catalogues at once — opendata.swiss (12'000+ datasets), the federal geodata layers (geo.admin.ch, ~900 layers + STAC), BFS STAT-TAB statistical tables, LINDAS statistical cubes, cantonal/SBB Opendatasoft portals, SNB data — and returns ranked hits. Every hit includes `next`: the exact tool and arguments that fetch the actual data (invoke it directly, or via call_tool if that tool isn't loaded). Example queries: 'rent prices Zürich', 'Strassenlärm', 'Übernachtungen Hotels', 'parking Basel', 'Radon'. German terms often match best.

Input parameters:

- `catalogues` (array): Optional subset of catalogue names to search (see the `catalogues_searched` field of a previous result)
- `lang` (string)
- `limit` (integer)
- `query` (string, required): What you are looking for, e.g. 'bicycle counts', 'Mietpreise', 'noise map'

### `find_tools` (~108 tokens)

Find the right Swissyphus tool

Keyword search over all Swissyphus tools this server exposes (with the 'discovery' preset: every module, loaded or not). Returns tool names, what they do, and whether they are loaded. Use describe_tool for the argument schema and call_tool to invoke a tool that is not loaded. Example: 'avalanche danger', 'company VAT', 'train delays', 'court decision'.

Input parameters:

- `limit` (integer)
- `query` (string, required): What you want to do

### `describe_tool` (~49 tokens)

Describe a tool's arguments

Full description and JSON Schema of the arguments of any Swissyphus tool this server exposes, for use with call_tool.

Input parameters:

- `name` (string, required): Tool name, e.g. 'query_dataset'

### `call_tool` (~92 tokens)

Invoke any Swissyphus tool by name

Invoke any Swissyphus tool this server exposes by name — with the 'discovery' preset that includes every module, so the context stays small while the full catalogue is reachable. Arguments are validated against the tool's schema (see describe_tool). Returns exactly what the tool returns.

Input parameters:

- `arguments` (object): Arguments object for that tool
- `name` (string, required): Tool name from find_tools / find_data

### `list_sources` (~41 tokens)

Licence & source register

The machine-readable register of every data source behind the active Swissyphus modules: operator, licence, attribution string, update frequency, cache TTL and caveats.

### `check_source_health` (~64 tokens)

Live source health check

Ping every upstream Swiss data source behind the active modules and report status and latency — Swissyphus's built-in status page. Use when another tool reports a source as unavailable.

Input parameters:

- `module` (string): Optionally check only one module, e.g. 'transport'

### `about_swissyphus` (~45 tokens)

What can Swissyphus do?

Orientation for agents: lists the active modules, what each covers, and example questions each can answer. Call this first if unsure which tool fits a Swiss data question.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus#diagnostics

## Score history

- 2026-11-21: 75
- 2026-11-20: 74
- 2026-11-19: 74
- 2026-11-18: 73
- 2026-11-17: 73
- 2026-11-16: 72
- 2026-11-15: 69
- 2026-11-14: 69
- 2026-11-13: 69
- 2026-11-12: 69
- 2026-11-11: 69
- 2026-11-10: 69
- 2026-11-09: 49

## Common questions

### What is the Swissyphus MCP server?

Swissyphus is an MCP server listed in the public MCP registry as io.github.cwellbournewood/swissyphus. Swiss public-data rollup for AI agents: 151 tools, 66 sources, zero keys, every answer cited. This page covers its npm package (swissyphus).

### Is the Swissyphus MCP server safe to use?

Swissyphus scores 75 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Swissyphus MCP server expose?

Swissyphus exposes 151 tools: search_companies, get_company, list_legal_forms, list_cantons, search_sogc_publications, and 146 more. Their descriptions and schemas cost roughly 23,422 tokens of context every time the server is loaded.

### Is the Swissyphus MCP server still maintained?

Swissyphus is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Swissyphus MCP server under?

Swissyphus declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Swissyphus MCP server?

VerifyMCP ran 16 checks on Swissyphus, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/swissyphus
- Socket report: https://socket.dev/npm/package/swissyphus
- Repository: https://github.com/cwellbournewood/swissyphus
- Changelog RSS feed: https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus.xml
- Changelog JSON feed: https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus.json
- HTML version of this page: https://verifymcp.io/servers/cwellbournewood-swissyphus/swissyphus
