🌦️ MeteoSwiss LLM Tools

Swiss weather data for AI assistants — powered by MeteoSwiss Open Government Data (OGD), 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.

This repo is also a working answer to a design question: how should you give AI agents access to a public dataset? It implements the same MeteoSwiss data access twice — as an agent skill (markdown instructions plus bash scripts, no server) and as an MCP server (structured tools, fuzzy matching, caching, hosted). The two approaches are compared honestly in the skill vs. MCP case study.

A third piece, meteoswiss-forecast-evals, demonstrates eval-driven interface design: a promptfoo suite measuring how well 13 LLMs read the forecast JSON, which settled a real design decision — local-time timestamps beat UTC, with hour-level lookups scoring ~100% vs. ~0%.

What the tools provide:

• Multi-day forecasts for ~6000 Swiss locations (postal codes, stations, place names)
• Real-time measurements from ~300 stations (~160 full weather + ~140 precipitation-only), updated every 10 minutes
• Station discovery by name, canton, or GPS coordinates
• Pollen monitoring from ~15 stations across Switzerland
• Climate series from the National Basic Climatic Network (NBCN), going back decades
• MeteoSwiss website search and content retrieval

What this repo demonstrates

• An agent skill — teach an agent to fetch open data directly with curl/awk/jq: ~630 lines of markdown and bash, zero infrastructure. → packages/meteoswiss-skills
• An MCP server — the same data as structured, validated tools with fuzzy station matching, geocoding, TTL-tiered caching, a real test suite, Docker, and a hosted instance. → packages/meteoswiss-mcp
• Eval-driven interface design — treat tool output as an interface for a language model, and measure its legibility before shipping. → packages/meteoswiss-forecast-evals

Read the comparison: Skill vs. MCP Server: Two Ways to Give AI Agents the Same Data.

Choose your approach

Both approaches answer the same weather questions. Which to install depends on your agent:

| | MCP Server | Agent Skill | |---|---|---| | What it is | Standalone server exposing 7 structured tools via MCP | Markdown instructions + 5 bash scripts the agent runs directly | | Works with | Claude Desktop, Claude.ai, Cursor, any MCP client | Claude Code, Cursor, any agent with shell access | | Coverage | Forecasts, current weather, stations, pollen, climate series, website search | Forecasts, current weather, stations, pollen | | Extras | Fuzzy matching, geocoding, caching, DE/FR/IT prompts, structured JSON | No server, no Node.js — just curl, awk, jq | | Size | ~6.6k lines TypeScript, tested in CI | ~630 lines markdown + bash | | Install | One-liner (hosted), npm, or Docker | Plugin marketplace, Skills CLI, or symlink |

Full comparison — parity matrix, engineering trade-offs, context cost, when to choose which: docs/skill-vs-mcp.md.

MCP server — quickstart

Use the hosted instance (no installation):

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

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:

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

Or with the Skills CLI:

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 | | meteoswissClimateData | NBCN climate series — temperature, precipitation, sunshine, and climate indicators going back decades | | 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 | | meteoswiss-forecast-evals | — | LLM eval suite for the forecast JSON format (standalone, not a workspace member) |

Documentation

• Skill vs. MCP case study — the honest comparison of the two approaches
• Eval results: forecast JSON comprehension — the local-time-vs-UTC sweep
• MCP server user guide
• Documentation index

Development

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.

Manual, point-in-time test reports (e.g. live MCP tool test passes) live in docs/test-reports/.

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