Cursor Integration Guide

This guide explains how to configure Cursor to use the TomTom MCP Server for location-based queries.

Prerequisites

• Cursor installed
• Node.js 22+ (For STDIO)
• Docker Setup Required (For HTTP)
• A valid TomTom API key

Setup

1. Navigate to Cursor Settings > Tools & Integrations, then click Add Custom MCP and add the following configuration::
   Copy{ "mcpServers": { "tomtom-mcp": { "command": "npx", "args": ["-y", "@tomtom-org/tomtom-mcp@latest"], "env": { "TOMTOM_API_KEY": "<your_API_KEY>" } } } }

   1{
   2    "mcpServers": {
   3        "tomtom-mcp": {
   4            "command": "npx",
   5            "args": ["-y", "@tomtom-org/tomtom-mcp@latest"],
   6            "env": {
   7             "TOMTOM_API_KEY": "<your_API_KEY>"
   8            }
   9        }
   10    }
   11}

Alternative Setup: HTTP Mode

You can also run TomTom MCP in HTTP mode separately and connect to it from Cursor:

1. Run TomTom MCP in HTTP mode using one of these methods:

   Using Docker

   Copy# Run using Docker docker run -p 3000:3000 ghcr.io/tomtom-international/tomtom-mcp:latest # Or with Docker Compose (after cloning the repository) docker compose up

   1# Run using Docker
   2docker run -p 3000:3000 ghcr.io/tomtom-international/tomtom-mcp:latest
   3
   4# Or with Docker Compose (after cloning the repository)
   5docker compose up

2. Configure Cursor to connect to the HTTP server: Navigate to Cursor Settings > Tools & Integrations, then click Add Custom MCP and add the following configuration:

   Copy{ "mcpServers": { "tomtom-mcp": { "url": "http://localhost:3000/mcp", "headers": { "tomtom-api-key": "your_api_key_here" } } } }

   1{
   2  "mcpServers": {
   3    "tomtom-mcp": {
   4      "url": "http://localhost:3000/mcp",
   5      "headers": {
   6        "tomtom-api-key": "your_api_key_here"
   7      }
   8    }
   9  }
   10}

3. You can see the TomTom MCP tools in Cursor tools menu.

Troubleshooting

• Ensure TOMTOM_API_KEY is valid and active
• Check that the MCP server is running
• Review logs for connection errors
• For HTTP mode, verify your connection URL and port are correct
• When using Docker, make sure the container is running with docker ps