TomTom MCP Server

What it does

TomTom MCP Server connects AI assistants to TomTom's complete suite of location APIs. Agents can geocode addresses, plan multi-stop routes, retrieve real-time traffic incidents, find nearby points of interest, and render interactive map images — all without leaving the chat interface. It supports both stdio (for desktop AI clients) and HTTP (for web apps and Docker deployments).

Key features

• Interactive map rendering — generates composited PNG maps server-side using skia-canvas, with markers, routes, polygons, and traffic overlays
• Full routing suite — point-to-point, multi-waypoint, reachable-range, and EV long-distance routing with charging stop optimisation (Orbis backend)
• Rich search — fuzzy search, POI category search, nearby search, and geometry-area search
• Real-time traffic — live incident data and visualization overlays
• Debug UI — built-in browser UI to test tools and preview map widgets without an AI client
• Dual backend — switch between TomTom Maps and TomTom Orbis Maps via a single env variable

Installation

Claude Desktop — add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "tomtom-mcp": {
      "command": "npx",
      "args": ["-y", "@tomtom-org/tomtom-mcp@latest"],
      "env": { "TOMTOM_API_KEY": "your_api_key" }
    }
  }
}

VS Code Copilot — add to .vscode/mcp.json:

{
  "servers": {
    "tomtom-mcp": {
      "command": "npx",
      "args": ["-y", "@tomtom-org/tomtom-mcp@latest"],
      "env": { "TOMTOM_API_KEY": "your_api_key" }
    }
  }
}

Cursor — add to ~/.cursor/mcp.json with the same structure as VS Code above.

Windsurf — add to mcp_config.json with the same server entry.

Docker (HTTP mode):

docker run -p 3000:3000 ghcr.io/tomtom-international/tomtom-mcp:latest

Pass API key via tomtom-api-key request header.

Supported hosts

Claude Desktop, VS Code Copilot, Cursor, Windsurf (all confirmed in README integration guides).