AI Integration & MCP

Every Maptoolkit API — maps, routing, search, elevation, static images, and more — works out of the box with any major LLM. Whether you’re building with Claude, ChatGPT, Gemini, or an AI-powered IDE like Cursor or Windsurf, you can go from idea to working map code in a single prompt.

The recommended way to connect your AI tool to Maptoolkit is via our MCP Server.

You can use the Maptoolkit MCP Server on Localhost as well as all APIs without API key. You can start right away.

What is the Maptoolkit MCP?

Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and APIs. Once connected, your AI assistant knows about all Maptoolkit endpoints, parameters, and capabilities — no copy-pasting of API documentation required.

Connect the Maptoolkit MCP Server

The Maptoolkit MCP server is available as a remote server — no installation needed, just add the URL to your AI tool.

https://mcp.maptoolkit.net

Select your tool below for setup instructions:

Claude.ai (web & desktop)

Open Claude.ai and go to Settings → Connectors
Click Add custom connector
Enter the server URL: https://mcp.maptoolkit.net
Save — the connector is now available in all Claude clients (web, desktop, mobile)

→ Claude MCP setup guide

Gemini CLI

Open or create ~/.gemini/settings.json
Add the Maptoolkit server to the mcpServers section:

{
  "mcpServers": {
    "maptoolkit": {
      "url": "https://mcp.maptoolkit.net"
    }
  }
}

→ Gemini CLI MCP setup guide

Cursor

Open Cursor Settings (Cmd+, / Ctrl+,) and go to Features → MCP
Click + Add New MCP Server
Choose transport type streamable-http and enter: https://mcp.maptoolkit.net

Alternatively, add it to .cursor/mcp.json in your project root or ~/.cursor/mcp.json globally:

{
  "mcpServers": {
    "maptoolkit": {
      "url": "https://mcp.maptoolkit.net"
    }
  }
}

→ Cursor MCP setup guide

Windsurf

Open Windsurf and click the MCP icon in the Cascade panel (or go to Settings → Cascade → MCP Servers)
Click Add MCP Server and enter: https://mcp.maptoolkit.net

Alternatively, edit ~/.codeium/windsurf/mcp_config.json directly:

{
  "mcpServers": {
    "maptoolkit": {
      "url": "https://mcp.maptoolkit.net"
    }
  }
}

→ Windsurf MCP setup guide

Using Prompts from the Documentation

Throughout this documentation you’ll find ready-to-use prompts alongside code examples. Each prompt is written to produce the shown result when used with an MCP-connected AI assistant.

Look for the Prompt tab in code examples — copy it directly into your AI tool and it will generate working map code, complete with your API key placeholder and the correct Maptoolkit endpoints.

Example: On Vector Tiles → Leaflet, MapLibre & Mapbox you’ll find prompts that produce a full MapLibre map with 3D terrain in one shot.

What the MCP Server Knows

Once connected, your AI assistant has access to:

All Maptoolkit API endpoints with full parameter documentation
Authentication requirements and API key usage
Tile URL formats for vector and raster tiles
Routing, isochrone, geocoding, and elevation APIs
Style URLs and configuration options

No need to paste documentation into your prompt — just ask.

Example Prompts to Get Started

Once the MCP server is connected, try these:

Show me a full-page MapLibre map using Maptoolkit vector tiles
with the terrain style, centered on Vienna.

Create a routing example that finds the fastest route between
two coordinates and displays it on a Maptoolkit map.

Build a geocoding search box that shows results on an
interactive Maptoolkit map.