anwb-mcp

Een Model Context Protocol (MCP) server voor ANWB verkeersinformatie, routeplanning en locatiezoeken in Nederland. Krijg realtime file-informatie, bereken routes met stapsgewijze routebeschrijvingen en zoek locaties — allemaal via natuurlijke taal in je AI-app.

Let op: Dit is een onofficieel, community-onderhouden project en is niet verbonden aan of goedgekeurd door ANWB. Deze server gebruikt publiek toegankelijke ANWB API-endpoints — geen API-key nodig.

A community-built Model Context Protocol (MCP) server for ANWB traffic information, route planning, and location search in the Netherlands. Get real-time traffic incidents, calculate routes with turn-by-turn directions, and search for locations — all through natural language via any MCP-compatible AI client.

Note: This is an unofficial, community-maintained project and is not affiliated with or endorsed by ANWB. This server uses publicly accessible ANWB API endpoints — no API key required.

Snel starten

Je hoeft deze repo niet te clonen.

1. Zorg dat Node.js 20+ is geïnstalleerd (je AI-app draait npx op je machine)
2. Voeg de server toe als MCP server in je AI-app (kopieer onderstaande configuratie)
3. Stel vragen in gewoon Nederlands (zie Voorbeelden)

Quick Start (Non-Developers)

You do not need to clone this repo.

1. Make sure Node.js 20+ is installed (your AI app will run npx on your machine)
2. Add the server to your AI app as an MCP server (copy/paste config below)
3. Ask questions in plain language (see Example Usage)

Add To Claude Desktop (Also Works In Cowork)

Cowork runs inside Claude Desktop and uses the same connected MCP servers and permissions.

1. Open your Claude Desktop MCP config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
2. Add this server entry (or merge it into your existing mcpServers):

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

3. Restart Claude Desktop

Add To Other AI Apps

Most MCP apps have a screen like "Add MCP Server" where you can fill in:

• Command: npx
• Args: -y anwb-mcp

If your app wants JSON, paste this and adapt the top-level key name to your client (common ones are mcpServers, servers, or context_servers):

{
  "<servers-key>": {
    "anwb-mcp": {
      "command": "npx",
      "args": ["-y", "anwb-mcp"]
    }
  }
}

Troubleshooting

• Error: npx: command not found or server fails to start
  • Fix: install Node.js 20+ and restart your app.
• Empty results or connection errors
  • The ANWB API may be temporarily unavailable. Wait a moment and retry.

Features

• 6 tools across 3 categories covering traffic, routing, and location search
• Location search — find addresses, cities, streets, and points of interest with coordinates
• Route planning — calculate routes by car, caravan, bike (regular or e-bike), or on foot with distance, duration, turn-by-turn directions, toll info, and alternative routes
• EV route planning — plan electric vehicle routes with battery consumption, charging stops, and cost savings vs fuel
• EV car database — browse 1500+ electric vehicle models with battery specs for EV route planning
• Road avoidance — avoid toll roads, motorways, ferries, or unpaved roads
• Traffic incidents — real-time jams, road closures, roadworks, and speed camera locations on Dutch highways
• Traffic summary — compact overview of current traffic conditions across all highways
• No API key required — uses publicly accessible ANWB endpoints
• Input validation via Zod schemas on every tool for safe, predictable operations
• Response caching with configurable TTL (60s for routes and incidents, 300s for locations)
• Rate limit handling with exponential backoff and Retry-After header support
• Toolset filtering to expose only the tool categories you need
• Docker support for containerized deployments via GHCR
• Actionable error messages with context-aware recovery suggestions

Supported Clients

claude mcp add --scope user anwb-mcp -- npx -y anwb-mcp

codex mcp add anwb-mcp -- npx -y anwb-mcp

gemini mcp add anwb-mcp -- npx -y anwb-mcp

docker run -i --rm ghcr.io/bartwaardenburg/anwb-mcp

[mcp_servers.anwb-mcp]
command = "npx"
args = ["-y", "anwb-mcp"]

Configuration

No API key is required. The following optional environment variables are available:

Available Tools

Locations

Routes

Incidents

Toolset Filtering

Reduce context window usage by enabling only the tool categories you need. Set the ANWB_TOOLSETS environment variable to a comma-separated list:

ANWB_TOOLSETS=routes,incidents

When not set, all toolsets are enabled. Invalid names are ignored; if all names are invalid, all toolsets are enabled as a fallback.

Voorbeelden

Eenmaal verbonden kun je in gewoon Nederlands vragen stellen:

• "Zoek locaties in de buurt van Amsterdam"
• "Wat zijn de coördinaten van Eindhoven Centraal?"
• "Bereken een route van Amsterdam naar Eindhoven"
• "Plan een fietsroute van Utrecht Centraal naar De Uithof"
• "Hoe lang loop je van de Dam naar het Vondelpark?"
• "Wat is de snelste route van Utrecht naar Den Haag?"
• "Staan er files op de A2?"
• "Welke wegwerkzaamheden zijn er nu?"
• "Geef een verkeerssamenvatting"
• "Welke flitsers staan er op de A1?"
• "Plan een route van Ede naar Zwolle zonder tolwegen"
• "Bereken een caravanroute van Amsterdam naar de Veluwe"
• "Plan een e-bike route van Utrecht naar Amersfoort"
• "Welke elektrische auto's van Tesla zijn beschikbaar?"
• "Plan een EV-route van Amsterdam naar Maastricht met een Tesla Model 3"
• "Hoe lang duurt het rijden van Rotterdam naar Groningen zonder snelwegen?"

Example Usage

Once connected, you can interact with the ANWB API using natural language:

• "Search for locations near Amsterdam"
• "Find the coordinates of Eindhoven Centraal"
• "Calculate a route from Amsterdam to Eindhoven"
• "Plan a bike route from Utrecht Centraal to De Uithof"
• "How long does it take to walk from Dam Square to Vondelpark?"
• "What is the fastest route from Utrecht to Den Haag?"
• "Are there any traffic jams on the A2?"
• "Show me all current roadworks"
• "Give me a traffic summary"
• "What speed cameras are active on the A1?"
• "Plan a route from Ede to Zwolle avoiding tolls"
• "Calculate a caravan route from Amsterdam to the Veluwe"
• "Plan an e-bike route from Utrecht to Amersfoort"
• "What electric vehicles are available from Tesla?"
• "Plan an EV route from Amsterdam to Maastricht with a Tesla Model 3"
• "How long does it take to drive from Rotterdam to Groningen avoiding motorways?"

Community

• Support: SUPPORT.md
• Security reporting: SECURITY.md
• Contributing guidelines: CONTRIBUTING.md
• Bug reports and feature requests: Issues

Development

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

# Type check
pnpm typecheck

Project Structure

src/
  index.ts              # Entry point (stdio transport)
  server.ts             # MCP server setup and toolset filtering
  anwb-client.ts        # ANWB API HTTP client with caching and retry
  cache.ts              # TTL-based in-memory response cache
  types.ts              # TypeScript interfaces for ANWB API responses
  tool-result.ts        # Error formatting with recovery suggestions
  update-checker.ts     # NPM update notifications
  tools/
    locations.ts        # Location and address search
    routes.ts           # Route calculation with directions
    incidents.ts        # Traffic incidents and summary

Requirements

• Node.js >= 20

License

MIT - see LICENSE for details.