Trafikverket MCP Server

A Model Context Protocol (MCP) server providing real-time access to Swedish road weather, traffic cameras, road conditions, and traffic flow data from Trafikverket (Swedish Transport Administration).

Features

• Real-time weather data from 850+ Swedish road weather stations

• Traffic camera access with live images and geographic search

• Traffic situations including accidents, roadwork, and closures

• Traffic flow data with vehicle counts and average speeds

• Road surface conditions including ice, snow, and water depth

• Geographic proximity search for cameras and weather stations

• County-based filtering for regional queries

Related MCP server: mcp-swedish-weather

Available Tools

Weather Tools

get_weather_station

Get current weather data for a specific station by name.

Returns: Air/road temperatures, humidity, visibility, wind, precipitation, road conditions.

list_weather_stations

List available weather stations with optional filtering.

get_weather_stations_near_location

Find weather stations near geographic coordinates.

get_weather_observations

Get historical weather observations for trend analysis.

Camera Tools

get_cameras

Get traffic cameras with optional filtering.

Returns: Camera locations, GPS coordinates, bearings, photo URLs.

get_cameras_near_location

Find cameras near geographic coordinates.

get_camera_image

Fetch the actual image from a traffic camera.

Returns: Base64-encoded camera image.

Traffic Tools

get_traffic_situations

Get current traffic incidents, accidents, roadwork, and closures.

Supports SQL-style wildcards: E% matches E4, E20, etc.

get_traffic_flow

Get real-time traffic density and speed data.

get_road_conditions

Get road surface conditions including ice, snow, and water.

Swedish County Reference

Installation

Prerequisites

• Node.js 18+

• Trafikverket API key (free from api.trafikinfo.trafikverket.se)

Setup

# Clone the repository
git clone https://github.com/hniska/trafikverket-mcp.git
cd trafikverket-mcp

# Install dependencies
npm install

# Build
npm run build

Configuration

Claude Desktop / Claude Code

Add to your MCP configuration (use absolute paths):

Production (compiled JavaScript):

{
  "mcpServers": {
    "trafikverket": {
      "command": "node",
      "args": ["/path/to/trafikverket-mcp/dist/index.js"],
      "env": {
        "TRAFIKVERKET_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Development (TypeScript):

{
  "mcpServers": {
    "trafikverket": {
      "command": "npx",
      "args": ["tsx", "/path/to/trafikverket-mcp/src/index.ts"],
      "env": {
        "TRAFIKVERKET_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Restart Claude after updating configuration.

Usage Examples

# Weather queries
"What's the current weather at Kiruna?"
"List weather stations near Stockholm"
"Find weather stations within 50km of Gothenburg"

# Camera queries
"Show traffic cameras on E4"
"Get cameras near Skellefteå"
"Fetch the image from camera X"

# Traffic queries
"Any traffic incidents on E4?"
"Check road conditions in Norrbotten"
"What's the traffic flow like in Stockholm county?"

Development

Scripts

Project Structure

trafikverket-mcp/
├── src/
│   ├── index.ts                 # Entry point (STDIO transport)
│   ├── server.ts                # MCP server (tool handlers)
│   ├── lib/
│   │   ├── trafikverket-client.ts  # API client with caching
│   │   ├── xml-builder.ts          # XML query construction
│   │   ├── xml-parser.ts           # Response parsing
│   │   └── county-mapping.ts       # County code lookup
│   └── types/
│       └── trafikverket.ts      # TypeScript interfaces
├── design/
│   └── schemas/                 # Official Trafikverket XML schemas
└── dist/                        # Compiled output

Architecture

Claude (MCP Client)
    ↓ JSON-RPC over STDIO
MCP Server
    ↓ XML Request
Trafikverket API
    ↓ XML Response
Parser → TypeScript Types
    ↓ Formatted Response
Claude

Error Handling

• Invalid API key: Clear message with registration link

• Network errors: Timeout (10s) and connection failures

• API errors: Trafikverket error messages forwarded

• Validation errors: Zod schema validation with details

• Not found: Graceful handling for missing stations/cameras

Resources

• Trafikverket Open API

• Model Context Protocol

• MCP TypeScript SDK

License

MIT