io.github.eins78/meteoswiss-mcp

Official7 tools

by eins78 · TypeScript

MeteoSwiss MCP Server

Swiss weather data for AI assistants — forecasts, measurements, stations, pollen.

Swiss weather forecasts, measurements, stations, and pollen data access.

Topics

claude-codeclaude-skillmcp-servermeteoswissopen-dataswitzerlandweather

Captured live from the server via tools/list.

search

Search MeteoSwiss website content in multiple languages (DE, FR, IT, EN). Returns relevant pages with URLs that can be passed to the fetch tool. Note: pagination may return duplicate results across pages (upstream API limitation).

Parameters (6)

querystringrequired
The search query string
languagestring
The language for search results
contentTypestring
Filter by content type. Defaults to "content" to exclude application pages. Use "publication" for official reports.
pageinteger
Page number for pagination (1-based)
pageSizeinteger
Number of results per page (max 100)
sortstring
Sort order for results. Note: date-asc severely degrades relevance — results are dominated by page age rather than query match.

fetch

Fetch full content from a MeteoSwiss webpage and convert to markdown or plain text. Use the search tool first to discover valid page URLs, then pass the full URL as the id parameter.

Parameters (3)

idstringrequired
Identifier of a MeteoSwiss page to fetch. For this server the id is a full URL returned by the search tool. Example: https://www.meteoschweiz.admin.ch/klima/klimawandel/steigende-temperaturen.html
formatstring
The output format for the content
includeMetadataboolean
Whether to include metadata in the response

meteoswissLocalForecast

Get a multi-day weather forecast for any Swiss location. Returns daily summaries with temperature, precipitation, and weather icons. This uses official MeteoSwiss Open Data — the same forecasts powering the MeteoSwiss app and website. Accepts: - Postal codes: "8001" (Zurich), "3000" (Bern), "1200" (Geneva) - Station abbreviations: "ZUE" (Zurich Fluntern), "BER" (Bern) - Place names: "Zurich", "Basel", "Lugano" Coverage: ~6000 Swiss locations (all postal codes + weather stations + mountain points). Forecast horizon: up to 9 days. Updated hourly.

Parameters (2)

locationstringrequired
Swiss location: postal code (e.g., "8001"), station abbreviation (e.g., "ZUE"), or place name (e.g., "Zurich")
daysinteger
Number of forecast days (1-9, default 5)

meteoswissCurrentWeather

Get real-time weather measurements from ~300 Swiss automatic weather stations (~160 full weather + ~140 precipitation-only). Returns temperature, precipitation, wind, humidity, pressure, sunshine, and more. Data updates every 10 minutes. Precipitation-only stations return only rainfall data. For 8 stations (Zurich, Basel, Chur, Sion, Altdorf, Säntis, Jungfraujoch, Grand St-Bernard), also includes daily visual observations: cloud cover, fog, rain, snowfall, hail, and snow coverage. Accepts station names ("Zurich"), abbreviations ("SMA"), addresses ("Bahnhofplatz 1 Bern"), or WGS84 coordinates. Automatically finds the nearest station.

Parameters (2)

stationstring
Swiss weather station or location: name (e.g., "Zurich"), abbreviation (e.g., "SMA"), or address (e.g., "Bahnhofplatz 1 Bern")
coordinatesobject
WGS84 coordinates (alternative to station name)

meteoswissStations

List and search MeteoSwiss automatic weather stations. Filter by name, canton, or browse the full network of ~160 stations across Switzerland.

Parameters (3)

searchstring
Search by station name or abbreviation
cantonstring
Filter by canton abbreviation (e.g., "ZH", "BE", "GR")
limitinteger
Maximum number of results (1-200, default 20)

meteoswissPollenData

Get current pollen concentration data from MeteoSwiss monitoring stations (~15 stations across Switzerland). Shows pollen levels by type (birch, grass, etc.). Useful for allergy sufferers.

Parameters (1)

stationstring
Pollen monitoring station name or abbreviation. Omit for an overview of all stations.

meteoswissClimateData

Get homogeneous climate measurement series from Switzerland's National Basic Climatic Network (NBCN). Returns temperature, precipitation, sunshine, radiation, wind, pressure, and climate indicators (frost days, summer days, heat days) going back decades. 29 climate stations + 46 precipitation stations with daily, monthly, and yearly resolution. Use cases: "What are typical January temperatures in Zurich?", "How has precipitation changed in Basel over 50 years?", "How many heat days did Lugano have last year?" Accepts station names ("Zurich", "Basel"), abbreviations ("SMA", "BAS"), or WGS84 coordinates.

Parameters (6)

stationstring
Climate station name or abbreviation (e.g., "Zurich", "BAS", "Davos"). Part of the National Basic Climatic Network (29 climate + 46 precipitation stations).
coordinatesobject
WGS84 coordinates (alternative to station name)
resolutionstring
Data resolution: daily (temp min/max/mean), monthly (full climate summary), yearly (annual summary)
start_datestring
Start date filter (YYYY-MM-DD). Only rows on or after this date are returned.
end_datestring
End date filter (YYYY-MM-DD). Only rows on or before this date are returned.
limitinteger
Maximum number of data rows to return (default 30)

README.md5 KBView on GitHub

🌦️ MeteoSwiss LLM Tools

Swiss weather data for AI assistants — powered by MeteoSwiss Open Data, the same data behind the MeteoSwiss app and website. Free, no API key required.

meteoswiss-mcp.ars.is — try the hosted service instantly, no setup needed.

Multi-day forecasts for ~6000 Swiss locations (postal codes, stations, place names)
Real-time measurements from ~160 automatic weather stations, updated every 10 minutes
Station discovery by name, canton, or GPS coordinates
Pollen monitoring from ~15 stations across Switzerland
MeteoSwiss website search and content retrieval

Choose Your Approach

This monorepo offers two ways to bring Swiss weather data into AI assistants:

	MCP Server	Agent Skill
How it works	Standalone server exposing structured tools via MCP	Teaches agents to call MeteoSwiss APIs directly via HTTP
Best for	Claude Desktop, Claude.ai, any MCP client	Claude Code, Cursor, agents without MCP support
Features	Fuzzy station matching, geocoding, structured JSON, prompts	Lightweight, no server process, shell scripts included
Install	One-liner or Docker	Skill package or symlink
Requires	Node.js 22+ (or Docker)	`curl`, `awk`, `jq`

MCP Server — Quickstart

Use the hosted instance (no installation):

bash

# Claude Code
claude mcp add meteoswiss https://meteoswiss-mcp.ars.is/mcp

For Cursor, install from the Cursor Directory or add manually via Settings → MCP.

Or self-host with Docker:

bash

docker run -p 3000:3000 ghcr.io/eins78/meteoswiss-mcp:latest

See the meteoswiss-mcp README for Claude Desktop setup, environment variables, and full documentation.

Agent Skill — Quickstart

Install via the Claude Code plugin marketplace:

bash

/plugin marketplace add eins78/meteoswiss-llm-tools
/plugin install meteoswiss-skills@meteoswiss-marketplace

Or with the Skills CLI:

bash

pnpx skills add https://github.com/eins78/meteoswiss-llm-tools.git#packages/meteoswiss-skills --global --agent claude-code --all

See the meteoswiss-skills README for manual installation and details.

Available Tools (MCP Server)

Tool	Description
`meteoswissLocalForecast`	Multi-day forecasts by postal code, station, or place name
`meteoswissCurrentWeather`	Real-time measurements (temperature, wind, humidity, pressure)
`meteoswissStations`	Search station network by name, canton, or coordinates
`meteoswissPollenData`	Pollen concentration data from monitoring stations
`search`	Search MeteoSwiss website content (DE, FR, IT, EN)
`fetch`	Fetch full content from MeteoSwiss pages

Example Questions

Works with both approaches — just ask in any of Switzerland's four languages:

"What's the weather forecast for Zurich this week?"
"Wie wird das Wetter in Bern morgen?"
"Quelle est la météo à Genève?"
"Che tempo fa a Lugano?"

Packages

Package	Version	Description
`meteoswiss-mcp`		MCP server with structured tools, fuzzy matching, and geocoding
`meteoswiss-skills`	1.0.0	Agent skill — direct HTTP access, no server needed

Development

bash

git clone https://github.com/eins78/meteoswiss-llm-tools.git
cd meteoswiss-llm-tools
nvm use && pnpm install

See each package's README for package-specific commands. The repo uses changesets for versioning.

Data Source

All weather data comes from MeteoSwiss Open Government Data (OGD) — the official free data offering from Switzerland's Federal Office of Meteorology and Climatology. The same data powers the MeteoSwiss app and website.

License

CC0-1.0 — public domain

Install

claude_desktop_config.json

{
  "mcpServers": {
    "meteoswiss-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "meteoswiss-mcp@2.0.2"
      ]
    }
  }
}