Tutorial: FMI Weather Warnings (Finland)

Environment

Data source: FMI (Finnish Meteorological Institute) via MeteoAlarm

Overview

FMI Weather Warnings (Finland) wraps FMI (Finnish Meteorological Institute) via MeteoAlarm, handling authentication, pagination, and rate limits for you. This tutorial covers all 3 tools with working code examples you can copy and run.

Prerequisites

Sign up at https://context.gnist.ai/signup for a free API key (100 calls/day).
Choose your integration method: MCP protocol or REST API.

Connect via MCP

Add to your MCP client config (Claude Desktop, Cursor, etc.):

MCP Config

{
  "mcpServers": {
    "gnist-fmi-warnings": {
      "url": "https://context.gnist.ai/mcp/fmi-warnings/",
      "headers": {
        "Gnist-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Tools (3)

`get_weather_warnings`

Get current FMI weather warnings for Finland. Returns active weather warnings from the Finnish Meteorological Institute (FMI) via MeteoAlarm. Warnings cover meteorological events (wind, snow, rain, thunder, fog, temperature extremes) and natural hazards (forest fire, avalanches, flooding, coastal events). Severity levels: yellow (moderate), orange (severe), red (extreme). Returns: List of warnings with severity, affected areas, and time periods.

Parameter	Type	Required	Description
`severity`	any	optional	Filter by severity level: yellow, orange, or red. Omit for all levels.
`awareness_type`	any	optional	Filter by awareness type: wind, snow-ice, thunderstorm, fog, high-temperature, low-temperature, coastal-event, forest-fire, avalanches, rain, flooding, rain-flood. Omit for all types.

curl -X POST "https://context.gnist.ai/mcp/fmi-warnings/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_weather_warnings", "arguments": {"severity": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/fmi-warnings/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'severity': 'example'},
            'name': 'get_weather_warnings'}},
)
print(resp.json())

`get_warning_metadata`

List available FMI warning severity levels and awareness types. Returns the full set of severity levels (yellow, orange, red) and awareness types (wind, snow-ice, thunderstorm, etc.) used in Finnish weather warnings. Useful for understanding the classification system before querying active warnings. Returns: Severity levels and awareness types with their descriptions.

curl -X POST "https://context.gnist.ai/mcp/fmi-warnings/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "get_warning_metadata", "arguments": {}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/fmi-warnings/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {}, 'name': 'get_warning_metadata'}},
)
print(resp.json())

`report_feedback`

Report a bug, feature request, or general feedback for this data source. Use this when something doesn't work as expected, when you'd like a new feature, or when you have suggestions for improvement. Args: feedback: Describe the issue or suggestion. feedback_type: One of 'bug', 'feature_request', or 'general'.

Parameter	Type	Required	Description
`feedback`	string	required
`feedback_type`	string	optional	(default: `general`)

curl -X POST "https://context.gnist.ai/mcp/fmi-warnings/" \
  -H "Content-Type: application/json" \
  -H "Gnist-API-Key: YOUR_API_KEY" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "id": 1, "params": {"name": "report_feedback", "arguments": {"feedback": "example"}}}'

import httpx

resp = httpx.post(
    "https://context.gnist.ai/mcp/fmi-warnings/",
    headers={"Gnist-API-Key": "YOUR_API_KEY"},
    json={'id': 1,
 'jsonrpc': '2.0',
 'method': 'tools/call',
 'params': {'arguments': {'feedback': 'example'}, 'name': 'report_feedback'}},
)
print(resp.json())

FAQ

What data does FMI Weather Warnings (Finland) provide?

Finnish weather warnings from FMI via MeteoAlarm — CAP-format alerts for meteorological and natural hazard events including wind, snow, rain, thunder, fog, forest fire, flooding, and coastal events. It exposes 3 tools: get_weather_warnings, get_warning_metadata, report_feedback.

What do I need to get started?

A Gnist API key (free tier: 100 calls/day). Sign up at https://context.gnist.ai/signup.

What format does the FMI Weather Warnings (Finland) API return?

JSON, via either MCP protocol (JSON-RPC 2.0) or REST API.