# SMHI MCP Server

[![smhi-mcp-server MCP server](https://glama.ai/mcp/servers/LittleAndi/smhi-mcp-server/badges/card.svg)](https://glama.ai/mcp/servers/LittleAndi/smhi-mcp-server)

[![CI](https://github.com/LittleAndi/smhi-mcp-server/actions/workflows/ci.yml/badge.svg)](https://github.com/LittleAndi/smhi-mcp-server/actions/workflows/ci.yml)


MCP server for Swedish Meteorological and Hydrological Institute (SMHI) weather data, built on SMHI's current `snow1g` point-forecast API.

> SMHI retired its older `pmp3g` forecast API on 2026-03-31 in favor of `snow1g`. This project is a fresh implementation against the current API.

## Features

- **get_forecast** - Full ~10-day forecast with all parameters
- **get_current_weather** - Current conditions (temperature, wind, precipitation)
- **get_hourly_forecast** - Next 1-48 hours hourly
- **get_daily_summary** - Daily high/low for up to 10 days
- **get_fire_risk** - Wildfire/forest fire risk forecast (Canadian FWI system)
- **get_radar_image** - Latest observed precipitation radar composite for Sweden
- **get_weather_warnings** - Active official SMHI weather warnings/alerts (wind, rain, snow, thunder, flooding, fire risk, etc.)
- **get_weather_analysis** - Past ~24h gridded meteorological analysis ("what's actually happening"), not a forecast

## Coverage

Sweden, Norway, Finland, Denmark, Estonia, and parts of Latvia/Lithuania. `get_radar_image` and `get_weather_warnings` are Sweden-only.

## Installation

### Claude Code

Add to your Claude Code settings (`~/.claude/settings.json`):

```json
{
  "mcpServers": {
    "smhi": {
      "command": "node",
      "args": ["/path/to/smhi-mcp-server/dist/index.js"]
    }
  }
}
```

### Build from source

```bash
npm install
npm run build
```

## Usage Examples

### Get current weather in Stockholm

```
Tool: get_current_weather
Input: { "latitude": 59.3293, "longitude": 18.0686 }
```

### Get weekly forecast for Gothenburg

```
Tool: get_daily_summary
Input: { "latitude": 57.7089, "longitude": 11.9746, "days": 7 }
```

### Check if it will rain in Oslo

```
Tool: get_hourly_forecast
Input: { "latitude": 59.9139, "longitude": 10.7522, "hours": 12 }
```

### Check wildfire risk near Norrköping

```
Tool: get_fire_risk
Input: { "latitude": 58.5877, "longitude": 16.1924, "period": "daily" }
```

### See what's actually raining right now

```
Tool: get_radar_image
Input: {}
```

### Check for active storm warnings in Stockholm county

```
Tool: get_weather_warnings
Input: { "county": "Stockholm", "minSeverity": "YELLOW" }
```

### See what's actually happened in Malmö over the last few hours

```
Tool: get_weather_analysis
Input: { "latitude": 55.6050, "longitude": 13.0038, "hours": 6 }
```

## API Reference

### get_forecast

Get complete ~10-day forecast with all SMHI parameters.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| latitude | number | Yes | -90 to 90 |
| longitude | number | Yes | -180 to 180 |

### get_current_weather

Get current weather conditions.

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| latitude | number | Yes | -90 to 90 |
| longitude | number | Yes | -180 to 180 |

Returns: temperature (°C), humidity (%), wind (m/s), pressure (hPa), visibility (km), cloud cover (%), precipitation (mm), weather description.

### get_hourly_forecast

Get hourly forecast.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| latitude | number | Yes | - | -90 to 90 |
| longitude | number | Yes | - | -180 to 180 |
| hours | number | No | 24 | 1-48 |

### get_daily_summary

Get daily weather summary.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| latitude | number | Yes | - | -90 to 90 |
| longitude | number | Yes | - | -180 to 180 |
| days | number | No | 7 | 1-10 |

Returns: date, high/low temperature (°C), dominant weather, precipitation sum (mm), max wind speed (m/s).

### get_fire_risk

Get wildfire/forest fire risk forecast, based on the Canadian Fire Weather Index (FWI) system as run by SMHI (`fwif1g` API). Calibrated for Swedish forest and grass fuels.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| latitude | number | Yes | - | -90 to 90 |
| longitude | number | Yes | - | -180 to 180 |
| period | string | No | daily | `daily` (~6 days ahead, afternoon fire risk) or `hourly` (next 48 hours) |

Returns per time step: fire risk class (1-6) and description, the underlying FWI/ISI/BUI/FFMC/DMC/DC indices (unitless), grass fire risk class, forest dryness class (`daily` only), temperature (°C)/wind (m/s)/humidity (%), and multi-day precipitation sums (mm).

### get_radar_image

Get the latest Swedish precipitation radar composite (mosaic of all Swedish radar stations, SMHI's radar `comp` product), updated roughly every 5 minutes. Unlike the forecast tools above, this reflects observed precipitation happening right now rather than a prediction.

No input parameters.

Returns the radar image (PNG) plus `area`, `product`, and `validTime`/`updated` timestamps. Coverage: Sweden only.

### get_weather_warnings

Get currently active official SMHI weather warnings (impact-based warnings, `ibwwarnings`/IBWwarnings API). Not coordinate-based — returns all active warnings for Sweden, each tagged with the county/area it affects; filter client-side by severity and/or county.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| language | string | No | en | `en` or `sv` |
| minSeverity | string | No | - | `RED`, `ORANGE`, `YELLOW`, or `MESSAGE` — only return warnings at or above this severity |
| county | string | No | - | Case-insensitive substring match against the warning's area name and affected counties, e.g. `"Stockholm"` |

Returns `count` plus a flat `warnings` array (one entry per warning area) with `event`, `severity`/`severityCode`, `areaName`, `affectedCounties`, `descriptions` (title/text pairs), `approximateStart`, and `published`. Coverage: Sweden only.

### get_weather_analysis

Get the past ~24 hours of gridded meteorological analysis (SMHI's `mesan2g`/Mesan2gv3 API): a "best current estimate" of conditions, blending observations with a short-range model on a ~2.5 km grid, not a forecast. Useful for nowcasting at a point without a nearby observation station, checking how a past forecast turned out, or "what was the weather really like" lookups.

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| latitude | number | Yes | - | -90 to 90 |
| longitude | number | Yes | - | -180 to 180 |
| hours | number | No | 24 | 1-24, most recent hours to return |

Returns hourly entries (most recent first): temperature (°C, plus min/max at some hours), dew point, wet-bulb temperature (°C), humidity (%), wind speed/direction/gust (m/s), pressure (hPa, sea-level and station), visibility (km), cloud cover (total/low/medium/high, %) and base/top altitude (m), precipitation over the last 1/3/12/24h (mm — the 3/12/24h windows are only populated at some hours), snow depth change over the last hour (cm), and a weather symbol/description.

## Development

```bash
npm install
npm run typecheck
npm test
npm run build
```

## Data Source

Data provided by [SMHI Open Data](https://opendata.smhi.se/) under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).

## License

MIT