overpass.ch MCP server

Hosted Overpass API with an MCP server. AI assistants connected to it query OpenStreetMap data for the whole planet, find places by name, look up heights, and answer from current data.

The data covers every street, shop, building and place mapped in OpenStreetMap and is updated every minute. The Medium and Large plans can also query the map at a past date, back to September 2012.

This repository holds the documentation and the registry entry of the hosted server at https://api.overpass.ch/mcp (sign-in) and https://api.overpass.ch/v1/mcp (API key). There is nothing to install.

• Website: https://overpass.ch
• Claude directory: https://claude.ai/directory/overpass-ch
• Setup guide: https://overpass.ch/guides/overpass-mcp-server
• Docs: https://overpass.ch/docs#mcp
• Official MCP Registry: ch.overpass/overpass

Setup

In Claude, add overpass.ch from the Claude directory. Claude Code, ChatGPT and other assistants that sign in take https://api.overpass.ch/mcp as a remote MCP server, then open overpass.ch for you to sign in (OAuth). The free plan works too.

Clients that do not sign in send an API key:

1. Create a free account and an API key at https://overpass.ch/signup.

2. Add the server to your assistant, either as a URL with the key in it:

   https://api.overpass.ch/v1/YOUR_API_KEY/mcp
   

   or as https://api.overpass.ch/v1/mcp with the key in the X-API-Key header (or Authorization: Bearer YOUR_API_KEY).

Transport: Streamable HTTP. Protocol versions 2026-07-28 and 2025-03-26 to 2025-11-25. Listing the tools does not need a key. Create a separate key for each assistant, so that you can revoke it on its own.

Claude (web, desktop and mobile apps)

Open overpass.ch in the Claude directory and add it, then sign in to overpass.ch and click Allow. In a Team or Enterprise organisation, an owner first adds it under Organization settings → Connectors.

With a key: Customize → Connectors → + Add → Add custom connector. Name: overpass.ch. URL: the URL with your key. Authentication: No sign in.

ChatGPT

Open https://chatgpt.com/plugins, select + and Add custom MCP server. Enter a name, the URL https://api.overpass.ch/mcp under Connection, and OAuth as authentication. Confirm the warning, select Create as a plugin, then sign in to overpass.ch and click Allow. With a key: the URL with your key and no authentication. Your ChatGPT plan or workspace has to allow custom MCP servers.

Claude Code

claude mcp add --transport http overpass https://api.overpass.ch/mcp

Then type /mcp in Claude Code, select overpass and sign in to overpass.ch in the browser. With a key:

claude mcp add --transport http overpass https://api.overpass.ch/v1/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Cursor

~/.cursor/mcp.json, with the key in the environment variable OVERPASS_KEY:

{
  "mcpServers": {
    "overpass": {
      "url": "https://api.overpass.ch/v1/mcp",
      "headers": { "X-API-Key": "${env:OVERPASS_KEY}" }
    }
  }
}

VS Code

.vscode/mcp.json. VS Code asks for the key the first time and stores it:

{
  "inputs": [
    { "type": "promptString", "id": "overpass-key", "description": "overpass.ch API key", "password": true }
  ],
  "servers": {
    "overpass": {
      "type": "http",
      "url": "https://api.overpass.ch/v1/mcp",
      "headers": { "X-API-Key": "${input:overpass-key}" }
    }
  }
}

Other clients

Other clients that speak MCP over Streamable HTTP take the URL with the key, or the URL without it and the X-API-Key header.

... View full README on GitHub