TomTom MCP Server

The TomTom MCP Server simplifies geospatial development by providing seamless access to TomTom’s location services, including search, routing, traffic and static maps data. It enables easy integration of precise and accurate geolocation data into AI workflows and development environments.

Demo

TomTom MCP Demo

Quick Start

Prerequisites

Node.js 22+
TomTom API key

How to obtain a TomTom API key:

Create a developer account on TomTom Developer Portal
Go to API & SDK Keys in the left-hand menu.
Click the red Create Key button.
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

npm install @tomtom-org/tomtom-mcp@latest

# or run directly without installing
npx @tomtom-org/tomtom-mcp@latest

Configuration

Set your TomTom API key using one of the following methods:

# Option 1: Use a .env file (recommended)
echo "TOMTOM_API_KEY=your_api_key" > .env

# Option 2: Environment variable
export TOMTOM_API_KEY=your_api_key

# option 3: Pass as CLI argument
npx @tomtom-org/tomtom-mcp@latest --key your_api_key

Usage

# Start MCP server
npx @tomtom-org/tomtom-mcp@latest
# Get help
npx @tomtom-org/tomtom-mcp@latest --help

Integration Guides

TomTom 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 MCP server
VS Code Setup - Setting up a development environment in Visual Studio Code
Cursor AI Integration - Guide for integrating TomTom MCP server with Cursor AI
WinSurf Integration - Instructions for configuring WindSurf to use TomTom MCP server
Smolagents Integration - Example showing how to connect Smolagents AI agents to TomTom MCP server.

Available Tools

Tool	Description	Documentation
`tomtom-geocode`	Convert addresses to coordinates with global coverage	https://developer.tomtom.com/geocoding-api/documentation/geocode
`tomtom-reverse-geocode`	Get addresses from GPS coordinates	https://developer.tomtom.com/reverse-geocoding-api/documentation/reverse-geocode
`tomtom-fuzzy-search`	Intelligent search with typo tolerance	https://developer.tomtom.com/search-api/documentation/search-service/fuzzy-search
`tomtom-poi-search`	Find specific business categories	https://developer.tomtom.com/search-api/documentation/search-service/points-of-interest-search
`tomtom-nearby`	Discover services within a radius	https://developer.tomtom.com/search-api/documentation/search-service/nearby-search
`tomtom-routing`	Calculate optimal routes between locations	https://developer.tomtom.com/routing-api/documentation/tomtom-maps/calculate-route
`tomtom-waypoint-routing`	Multi-stop route planning Routing API	https://developer.tomtom.com/routing-api/documentation/tomtom-maps/calculate-route
`tomtom-reachable-range`	Determine coverage areas by time/distance	https://developer.tomtom.com/routing-api/documentation/tomtom-maps/calculate-reachable-range
`tomtom-traffic`	Real-time incidents data	https://developer.tomtom.com/traffic-api/documentation/traffic-incidents/traffic-incidents-service
`tomtom-static-map`	Generate custom map images	https://developer.tomtom.com/map-display-api/documentation/raster/static-image

Contributing & Local Development

Setup

git clone <repository>

cd tomtom-mcp

npm install

cp .env.example .env      # Add your API key in .env

npm run build             # Build TypeScript files

node ./bin/tomtom-mcp.js   # Start the MCP server

Testing

npm run build               # Build TypeScript
npm test                    # Run all tests
npm run test:unit           # Unit tests only
npm run test:comprehensive  # Integration tests

Testing Requirements

⚠️ Important: All tests require a valid API key in .env as they make real API calls (not mocked). This will consume your API quota.

Project Structure

src/
├── tools/             # MCP tool definitions
├── services/          # TomTom API wrappers
├── schemas/           # Validation schemas
├── utils/             # Utilities
└── createServer.ts    # MCP Server creation logic
└── index.ts           # Main entry point

Troubleshooting

API Key Issues

echo $TOMTOM_API_KEY  # Check if set

Test Failures

ls -la .env          # Verify .env exists
cat .env             # Check API key

Build Issues

npm run build            # Rebuild
npm cache clean --force  # Clear cache

Contributing & Feedback

We welcome contributions to the TomTom MCP Server! Please see CONTRIBUTING.md for details on how to submit pull requests, report issues, and suggest improvements.

All contributions must adhere to our Code of Conduct and be signed-off according to the Developer Certificate of Origin (DCO).

Open issues on the GitHub repo

Security

Please see our Security Policy for information on reporting security vulnerabilities and our security practices.

License

This project is licensed under the Apache License 2.0 - see the LICENSE.md file for details.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

Provides seamless access to TomTom's location services including search, routing, traffic and static maps data, enabling easy integration of precise geolocation data into AI workflows and development environments.

Related MCP Servers

Roam Research
2b3pro
A
security
A
license
A
quality
Provides comprehensive access to Roam Research's API functionality. This server enables AI assistants like Claude to interact with your Roam Research graph through a standardized interface.
Last updated -
18
16
57
TypeScript
MIT License
MCP IP Geolocation Server
tedlikeskix
-
security
F
license
-
quality
Provides IP geolocation services using IP-API.com without requiring an API key, enabling users to obtain detailed location and network information for any IP address in a clean, formatted output.
Last updated -
TypeScript
Travel Planner MCP Server
GongRzhe
A
security
A
license
A
quality
Enables LLMs to perform travel-related tasks by interacting with Google Maps and travel planning services including location search, place details, and travel time calculations.
Last updated -
5
36
21
JavaScript
MIT License
OpenStreetMap MCP Server
jagan-shanmugam
A
security
A
license
A
quality
Enhances LLM capabilities with location-based services and geospatial data, enabling users to geocode addresses, find nearby points of interest, get directions, optimize meeting points, and analyze neighborhoods.
Last updated -
12
77
Python
MIT License

View all related MCP servers

TomTom MCP Server