anwb-mcp

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.

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.

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.