tomtom-international/tomtom-maps-mcp

The **TomTom Maps MCP Server** simplifies geospatial development by providing seamless access to TomTom’s location services, including search, routing, traffic and interactive maps. It enables easy integration of precise and accurate geolocation data into AI workflows and development environments.
Demo
Table of Contents
- Demo
- Security Notice
- Remote MCP Server (No Installation Required)
- Quick Start
- Prerequisites
- Installation
- Configuration
- Usage
- Integration Guides
- Available Tools
- How dynamic map tool works
- Getting geometry out of a tool response
- Debug UI
- Local Development
- Setup
- Testing
- Testing Requirements
- Project Structure
- Troubleshooting
- API Key Issues
- Test Failures
- Build Issues
- Contributing \& Feedback
- Security
- License
---
Remote MCP Server (No Installation Required)
> **Public Preview** — The TomTom Maps Remote MCP Server is currently in public preview.
The easiest way to get started is to connect directly to TomTom's hosted MCP Server — no Node.js, Docker, or local setup needed.
**Endpoint:**
**Prerequisites:**
- A valid TomTom API key with MCP Server access enabled (see API Key Management)
Generic MCP Client Configuration
Add the following to your MCP client configuration:
VS Code (GitHub Copilot)
Create or edit .vscode/mcp.json in your workspace:
Claude Desktop
The quickest option is to install the pre-built extension — see the Claude Desktop Setup guide for details.
Alternatively, configure Claude Desktop to use the remote server directly by editing your configuration file:
- **macOS**: ~/Library/Application Support/Claude/claude_desktop_config.json
- **Windows**: %APPDATA%\Claude\claude_desktop_config.json
> **Note:** If your MCP client does not support remote HTTP connections with custom headers, use the local setup instead.
---
Security Notice
Keeping local deployments of the TomTom Maps MCP Server up-to-date is the responsibility of the MCP client/operator. TomTom publishes updates to address known vulnerabilities, but failing to apply updates, patches, or recommended security configurations to your local instance may expose it to known vulnerabilities.
Quick Start
Prerequisites
- Node.js 22.x
- TomTom API key
**How to obtain a TomTom API key**:
1. Create a developer account on TomTom Developer Portal and Sign-in
2. Go to **API & SDK Keys** in the left-hand menu.
3. Click the **red Create Key** button.
4. Select all available APIs to ensure full access, assign a name to your key, and click **Create**.
For more details, visit the TomTom API Key Management Documentation.
Installation
---
Configuration
Set your TomTom API key using one of the following methods:
Environment Variables
| Variable | Description | Default |
|----------|-------------|---------|
| TOMTOM_API_KEY | Your TomTom API key | - |
| PORT | Port for the HTTP server | 3000 |
| LOG_LEVEL | Logging level: debug, info, warn, or error. Use debug for local development to see all logs | info |
| MCP_APPS | Stdio only. false gives the client only the data tools, without maps; true gives every tool. Unset, the client's initialize decides. Over HTTP, use ?apps= on the MCP URL (see Clients without MCP apps) | - |
---
Usage
**Stdio Mode (Default - for AI assistants like Claude):**
**HTTP Mode (for web applications and API integration):**
When running in HTTP mode, you need to include your API key in the tomtom-api-key header:
For example, to make a request using curl:
The Docker setup is also configured to use this HTTP mode with the same authentication method.
**Docker Mode (recommended):**
Both Docker options run the server in HTTP mode. Pass your API key via the tomtom-api-key header as shown in the HTTP Mode curl example above.
---
Integration Guides
TomTom Maps MCP Server can be easily integrated into various AI development environments and tools.
These guides help you integrate the MCP server with your tools and environments:
- Claude Desktop Setup - Instructions for configuring Claude Desktop to work with TomTom Maps MCP server
- VS Code Setup - Setting up a development environment in Visual Studio Code
- Cursor AI Integration - Guide for integrating TomTom Maps MCP server with Cursor AI