Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Nominatim with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Geocode addresses, reverse geocode coordinates and explore OpenStreetMap data. no API key required.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 5 capabilities

The complete Nominatim capability set.

These are the exact actions your AI can choose when you ask it to work with Nominatim.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 5 available through Nominatim.

  1. 01

    Reverse geocode

    Returns the nearest address, city, state, country and other location details. Supports different zoom levels for varying detail granularity. Convert coordinates to an address

  2. 02

    Get details

    Returns the object's full name, display name, place rank, importance score, bounding box, parent place hierarchy, linked Wikipedia/Wikidata articles and optional extratags. OSM type: N (node), W (way), R (relation). Get detailed info for an OSM object

  3. 03

    Get status

    Returns status message and response latency. Useful for verifying the service is operational before making other requests. Get Nominatim server status

Capability set02 / 02

04-05

2 capabilities in this set.

Part of 5 available through Nominatim.

  1. 04

    Lookup osm

    IDs are formatted as "type{id}" where type is N (node), W (way) or R (relation). Multiple IDs are comma-separated. Returns the object's display name, coordinates, bounding box and properties. Look up OSM objects by ID

  2. 05

    Search

    Returns results with coordinates, bounding box, display name, address components and OSM type/id. Supports structured searches with country codes and viewbox for region prioritization. Rate limited to 1 request/second. Search for places by name or address

Observed, not estimated

843ms average. Fast in production.

Nominatim is checked daily against the live service.

Daily averagePeak 991ms
Aug 20Today
Fastest day
741ms
Slowest day
991ms
14-day trend
Slowing+6%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 5 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Nominatim, so you can see the experience inside your AI.

It does not authenticate your account with Nominatim. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Nominatim Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Nominatim capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "nominatim-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Nominatim owners ask.

  • 01

    Do I need an API key?

    No! Nominatim is completely free and requires no authentication. It's powered by the OpenStreetMap community. Just subscribe and start searching. Rate limit is 1 request per second.

  • 02

    How accurate is the geocoding?

    Nominatim uses OpenStreetMap data, which is crowd-sourced and varies by region. Urban areas typically have very accurate results. Use addressdetails=1 to get structured address components and namedetails=1 for multi-language names.

  • 03

    Can I convert coordinates to an address?

    Yes! Use reverse_geocode with latitude and longitude. Returns the nearest address with street name, house number, city, state, postal code and country. Supports different zoom levels for varying detail granularity.

  • 04

    What is an OSM ID and how do I use it?

    OSM IDs are unique identifiers for OpenStreetMap objects: N for nodes (points), W for ways (lines/areas), R for relations (groups). Use lookup_osm with IDs like 'W123456' or 'N987654'. Use get_details for comprehensive info on a single object.

Explore

More in Developer Tools

Suggestions