vedurstofa-mcp

MCP server for Icelandic weather, forecasts, warnings, and earthquakes. Data comes from the Icelandic Meteorological Office (Veðurstofa Íslands, vedur.is). Works with Claude Desktop, Claude Code, and any other MCP client.

What it does

Six tools:

Station inputs accept IDs ("1470") or names with or without diacritics ("Reykjavík", "reykjavik"). Unknown names return a typo-tolerant "did you mean..." error.

For agents

Read this section if you're an AI agent picking tools from this server.

• No auth, no API key, no setup. Just run npx vedurstofa-mcp over stdio.
• All data is Icelandic. If the user asks about weather outside Iceland, stop — this server can't help.
• Every response is a JSON envelope with attribution, source, fetched_at, data, and optionally errors, degraded, truncated. Always cite the attribution field when surfacing data to users.
• Units are metric. °C, m/s, hPa, mm, km. Convert only when the user asks.
• Timestamps are ISO 8601 UTC. Iceland is on UTC year-round (no DST).

Tool selection guide

Multi-tool workflows

• "What's the weather like in Iceland today?" → get_weather_now for the user's city + get_weather_warnings to surface any active alerts. Add get_weather_text with category: "national" only if the user wants a narrative.
• "Should I drive from Reykjavík to Akureyri tomorrow?" → get_weather_forecast for both endpoints + get_weather_warnings. Don't pull get_weather_now unless the user asks about right now.
• "Are there any earthquakes near me?" → get_earthquakes with region preset if the user names a volcanic system (Reykjanes, Katla, etc.), otherwise near: { lat, lon, radius_km }.

Degraded responses

get_weather_forecast scrapes HTML and can fail when the upstream site changes. When this happens, the response carries degraded: true and degraded_reason, and falls back to the national text forecast. Surface this to the user rather than pretending the structured forecast is available.

Install & run

Node 18+ required.

# Latest
npx -y vedurstofa-mcp

# Version-pinned (recommended for configs that shouldn't drift)
npx -y vedurstofa-mcp@1.0.0

The server speaks MCP over stdio, so you won't see interactive output. Plug it into a client.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "vedurstofa": {
      "command": "npx",
      "args": ["vedurstofa-mcp"]
    }
  }
}

Claude Code

claude mcp add 

... [View full README on GitHub](https://github.com/sandsower/vedurstofa-mcp#readme)