Anleitung

Die Overpass API in Claude, ChatGPT und Cursor (MCP)

overpass.ch ist ein MCP-Server (Model Context Protocol). Ein KI-Assistent, der damit verbunden ist, führt selbst Overpass-Abfragen auf dem ganzen OpenStreetMap-Planeten aus, findet Orte, fragt Höhen ab und antwortet mit den aktuellen Daten.

Fügen Sie diese URL im Assistenten als entfernten MCP-Server oder eigenen Connector hinzu, mit Ihrem API-Schlüssel anstelle von IHR_API_SCHLÜSSEL:

https://api.overpass.ch/v1/IHR_API_SCHLÜSSEL/mcp

Wo der Assistent Header annimmt, verwenden Sie https://api.overpass.ch/v1/mcp und den Header X-API-Key. Der kostenlose Tarif funktioniert auch.

Einrichtung

Erstellen Sie auf der Seite API-Schlüssel für jeden Assistenten einen eigenen Schlüssel, benannt nach ihm, und lassen Sie seine erlaubten Referrer leer. Dann können Sie ihn einzeln widerrufen.

Claude (Web, Desktop- und Mobil-App)

Öffnen Sie Customize → Connectors, klicken Sie auf + Add und Add custom connector.
Name: overpass.ch. URL: die URL oben mit Ihrem Schlüssel.
Authentication: No sign in. Klicken Sie auf Add.

Kostenlose Konten von Claude können einen eigenen Connector hinzufügen. Die Aufrufe kommen von den Servern von Anthropic, deshalb funktioniert der Connector in der Desktop- und der Mobil-App gleich. In einer Organisation mit Team oder Enterprise fügt ein Owner den Connector hinzu, und alle, die ihn verwenden, teilen den Schlüssel.

ChatGPT

Öffnen Sie chatgpt.com/plugins, wählen Sie + und Add custom MCP server.
Geben Sie einen Namen und eine Beschreibung ein und unter Connection die URL oben mit Ihrem Schlüssel.
Wählen Sie keine Authentifizierung, bestätigen Sie die Warnung und wählen Sie Create as a plugin.

ChatGPT zeigt dann die gefundenen Werkzeuge. Ihr ChatGPT-Abo oder Ihr Workspace muss eigene MCP-Server erlauben. Vor Werkzeugen, die etwas ändern, fragt ChatGPT nach; die Werkzeuge von overpass.ch lesen nur Daten.

Claude Code

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

In Claude Code heissen die Werkzeuge mcp__overpass__overpass_query und so weiter.

Cursor

In ~/.cursor/mcp.json, mit dem Schlüssel in der Umgebungsvariablen OVERPASS_KEY:

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

VS Code

In .vscode/mcp.json. VS Code fragt beim ersten Mal nach dem Schlüssel und speichert ihn:

{
  "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}" }
    }
  }
}

Andere Programme, die MCP über Streamable HTTP sprechen, funktionieren genauso. Der Server spricht die Protokollversion 2026-07-28 und die Versionen von 2025-03-26 bis 2025-11-25.

Was Sie fragen können

Fragen Sie in normaler Sprache. Der Assistent wählt die Werkzeuge; das sind die Aufrufe, zu denen drei Fragen führten.

«Wie viele Apotheken in Zürich liegen höchstens 200 m von einer Tramhaltestelle entfernt?»

geocode mit Zürich und kind city liefert die Stadt, Relation 1682248, mit der overpass_area_id 3601682248.

overpass_query zählt:

[out:json][timeout:25];
area(id:3601682248)->.a;
node["railway"="tram_stop"](area.a)->.stops;
nwr["amenity"="pharmacy"](around.stops:200)(area.a);
out count;

Die Antwort am 4. November 2026: 87 der 103 Apotheken der Stadt. Zwei Aufrufe: eine Geocoding-Anfrage und eine Overpass-Anfrage.

«Welche Berghütten im Wallis liegen über 2500 m?»

geocode findet den Kanton (overpass_area_id 3601686699), und overpass_query listet seine 124 Hütten mit add_elevation, das die Höhe jedes Punkts aus dem 2-m-Raster von swisstopo hinzufügt. Der Assistent sortiert und filtert die Liste dann.

«Wie viele Cafés hatte Lausanne 2015, und wie viele heute?»

Zwei Abfragen desselben Gebiets, eine mit [date:"2015-01-01T00:00:00Z"] in der Einstellungszeile. Verlaufsabfragen brauchen den Tarif Medium oder Large; bei den anderen Tarifen antwortet das Werkzeug das, mit einem Link zu den Preisen.

Wenn die passende Abfrage nicht auf der Hand liegt, kann der Assistent overpass_examples aufrufen, das die Abfragebeispiele nach Thema durchsucht.

Die Werkzeuge

Werkzeug	Was es tut	Zählt als
`overpass_query`	Führt eine Abfrage in Overpass QL oder XML auf dem ganzen Planeten aus	1 Anfrage
`overpass_examples`	Findet geprüfte Beispielabfragen zu einem Thema	kostenlos
`geocode`	Orte und Adressen nach Namen, mit `overpass_area_id`	1 Geocoding-Anfrage
`reverse_geocode`	Die Adresse, Strasse, Stadt oder das Land an einem Punkt	1 Geocoding-Anfrage
`elevation`	Höhen von Punkten	1 Abfrage pro Punkt
`elevation_profile`	Distanz, Aufstieg, Abstieg und Höhen entlang eines Pfads	1 Abfrage pro Stützpunkt
`account_status`	Tarif, Verbrauch in diesem Monat und Datenstand	kostenlos

Assistenten lesen Text, deshalb antwortet overpass_query mit einer ersten Zeile, die die Elemente nach Typ zählt und den Datenstand nennt, dann dem Hinweis zur ODbL und dann einem Element pro Zeile als kompaktes JSON. Eine Antwort über 30'000 Zeichen wird gekürzt; die erste Zeile nennt dann die Zahl der Elemente, und der Assistent kann mit offset den nächsten Teil abfragen, max_chars bis 200'000 erhöhen oder die Abfrage eingrenzen. Jeder Aufruf zählt, auch ein gekürzter; out count; und out center 50; sparen also Anfragen.

Limits und Fehler

Werkzeugaufrufe zählen gegen die Limits Ihres Tarifs wie dieselben Aufrufe der REST-API. Die Liste der Werkzeuge ist kostenlos und funktioniert ohne Schlüssel.
Overpass-Abfragen über MCP enden nach höchstens 120 s und nach 25 s, wenn die Abfrage kein [timeout:] setzt. Die REST-API erlaubt das Maximum des Tarifs.
Der kostenlose Tarif führt eine Overpass-Abfrage aufs Mal aus und erlaubt 30 Anfragen pro Minute. Ein Assistent, der zwei Abfragen gleichzeitig sendet, erhält für die zweite eine Ablehnung.
Eine Ablehnung erreicht den Assistenten als Text: die Meldung der API, was zu tun ist, und die Sekunden bis zum nächsten Versuch. Der Assistent wird angewiesen, sie weiterzugeben und nicht in einer Schleife zu wiederholen.
Ein fehlender oder widerrufener Schlüssel ergibt beim ersten Werkzeugaufruf den Fehler unauthorized, mit der Adresse der Seite API-Schlüssel. Ein Schlüssel vom Typ «Nur Karten» funktioniert für Geocoding, nicht für Overpass und Höhen.

Schlüssel und Daten

Der Schlüssel in der URL landet in den Einstellungen des Assistenten, und in einem geteilten Workspace verwenden ihn alle, die den Connector nutzen. Widerrufen Sie ihn auf der Seite API-Schlüssel, wenn Sie den Connector entfernen; ein widerrufener Schlüssel ist sofort ungültig. overpass.ch protokolliert Werkzeugaufrufe wie API-Anfragen: die ID des Schlüssels, nie den Schlüssel, und Abfragen nur als Hash. Tag-Werte in den Antworten sind Text, den Mitwirkende von OpenStreetMap geschrieben haben, und der Assistent wird angewiesen, sie als Daten zu behandeln.

MCP-Server, die overpass-api.de verwenden

Ein MCP-Server, der seine Abfragen an den öffentlichen Server overpass-api.de sendet, unterliegt dessen Regeln. Für alles, was regelmässig läuft, erlaubt dessen Richtlinie im Wiki von OpenStreetMap etwa 100 Abfragen am Tag, er beantwortet Skripte ohne eigenen User-Agent mit 406 und sperrt Adressen nach wiederholten 429-Fehlern. Ein Assistent, der in einer Schleife wiederholt, stösst an diese Grenzen. Die Anleitung zu den Alternativen vergleicht die Möglichkeiten.

Kostenlosen Schlüssel holen MCP in der Dokumentation