Nominatim Connector for AI agents.

5 live capabilities

Turn addresses into coordinates and explore global geographic data instantly.

Live agent request Nominatim / Connector

Waiting for input…

AI Agent

Why people use Nominatim

Nominatim Geocoding for Location-Based Data Projects

This Connector lets your agent do that work in one go. Just tell your agent to find the coordinates for these five addresses, and it handles the lookup, pulls the data, and presents it to you. You get a clean list of results without leaving your chat interface.

What Vinkius changes

You get instant access to global geographic data without managing any API keys.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Mapping a store list

A developer needs to map 100 stores.
Real-world use case 02

Identifying GPS points

A traveler wants to know what is at a specific set of coordinates.
Real-world use case 03

Finding regional boundaries

A researcher needs a city's boundary.

Complete set · 5capabilities

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.

01 Capability
Get details
Pulls the full name, coordinates, and hierarchy for a specific OpenStreetMap object. This is useful for getting deep data on a known ID.
02 Capability
Lookup osm
Fetches display names and properties for specific OSM IDs like nodes, ways, or relations. Use this when you already have an OSM identifier.
03 Capability
Reverse geocode
Turns a pair of coordinates into a readable address with different zoom levels for detail. It helps identify what is at a specific spot.

Capability set02 / 02

04—05

2 capabilities in this set.

Part of 5 available through Nominatim.

04 Capability
Search
Finds places by name or address and returns coordinates along with structured address components. This is the primary way to find new locations.
05 Capability
Get status
Checks if the Nominatim service is up and running before you start your requests. It helps verify connectivity quickly.

Set up in minutes

One URL. Then ask Nominatim to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Nominatim from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Nominatim, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Nominatim for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Nominatim URL.
Step 03

Save and start

Save the connection and enable Nominatim in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nominatim": {
      "url": "https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Nominatim

Open Agent mode in chat and ask: "Using Nominatim, help me...". 5 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nominatim": {
      "url": "https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Nominatim

Ask Copilot: "Using Nominatim, help me...". 5 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nominatim": {
      "url": "https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Nominatim

Open Cascade and ask: "Using Nominatim, help me...". 5 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "nominatim": {
      "url": "https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Nominatim

Ask Cline: "Using Nominatim, help me...". 5 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add nominatim --transport http "https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Nominatim

Ask Claude: "Using Nominatim, show me...". 5 tools are ready

Where the request belongs

Work Nominatim can move forward.

Built around the request

This is for the developer tired of paying for geocoding APIs, the data analyst cleaning up location lists, and the researcher mapping out spatial boundaries.

Data Analyst

Cleaning up a CSV of 500 addresses and turning them into usable coordinates for a report.

App Developer

Building a local delivery or travel app that needs to find nearby points of interest.

GIS Researcher

Mapping out administrative boundaries and place hierarchies for a geographic study.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 10 capabilities

Pelias Geocoder

Map geospatial structures via Pelias APIs. convert coordinates, perform reverse geocoding, autocomplete POIs, and retrieve addresses natively by AI logs.

View Connector

02 10 capabilities

LocationIQ (Geocoding & Maps)

Build with location data via LocationIQ. geocode addresses, calculate routes, and perform reverse lookups.

View Connector

03 2 capabilities

OpenCage Geocoder

Convert addresses to coordinates and coordinates to addresses worldwide with the OpenCage Geocoding API.

View Connector

04 10 capabilities

Mapbox (Maps & Geospatial)

Build with location data via Mapbox. geocode addresses, calculate routes, and solve trip optimization.

View Connector

05 6 capabilities

TomTom

Access global mapping, geocoding, and routing services. Search for addresses, calculate optimal routes, and retrieve map tiles directly through AI.

View Connector

06 7 capabilities

LocationIQ

Convert addresses to coordinates, find places nearby, and calculate routes with LocationIQ's geocoding and mapping capabilities.

View Connector

Bring your own AI

Change the model, client or framework. Keep Nominatim connected.

Claude
ChatGPT
Gemini
Cursor
VS Code
Windsurf
ZCode
Cline
Zed
Continue
Kiro
Roo Code
Zencoder
Goose
Void
Augment Code
Amp
Qodo
Tabnine
Pieces
Sourcegraph Cody
JetBrains
Warp
Amazon Q
Antigravity
BoltAI
Raycast
Jan
LM Studio
AnythingLLM
Open WebUI
Msty
Cherry Studio
LibreChat
TypingMind
Chorus
5ire
n8n
LangChain
LlamaIndex
CrewAI
Vercel AI SDK

Before you connect

Questions about Nominatim.

The practical details behind the request, access and result.

Does the Nominatim MCP require an API key to work?

No, you do not need an API key. This Connector connects you directly to the OpenStreetMap data, so you can start geocoding and looking up locations immediately after connecting it to your AI client.

Can I use Nominatim MCP to find landmarks by name?

Yes, you can ask your agent to find any landmark, restaurant, or school by name. It will return the coordinates, full address, and other relevant geographic details.

Is there a limit on how many locations I can search with Nominatim MCP?

The service is rate-limited to 1 request per second. This is great for individual tasks and data cleaning, but if you need to process millions of locations at once, you might need a different approach.

Can Nominatim MCP convert GPS coordinates back into a street address?

Yes, it supports reverse geocoding. You can give your agent a set of coordinates, and it will tell you the nearest street address, city, state, and country.

What kind of data does Nominatim MCP provide for a city?

It provides detailed information including the display name, coordinates, bounding boxes, and administrative hierarchies, all pulled from the OpenStreetMap community database.

Can I use Nominatim MCP for international addresses?

Yes, it supports global geographic data. You can even ask for place names in different languages to help with internationalized projects.

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.

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.

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.

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.

One connection away

Give your agent a direct line to Nominatim.

Connect Nominatim once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available

Nominatim Geocoding for Location-Based Data Projects

You get instant access to global geographic data without managing any API keys.

Mapping a store list

Identifying GPS points

Finding regional boundaries

Get details

Lookup osm

Reverse geocode

Search

Get status

Open Connectors

Add the URL

Turn it on in chat

Open MCP settings

Add the URL

Save and start

Open MCP Settings

Add the server config

Save the file

Start using Nominatim

Create MCP config

Add the server config

Enable Agent mode

Start using Nominatim

Open MCP Settings

Add the server

Save and reload

Start using Nominatim

Open Cline MCP Settings

Add remote server

Enable the server

Start using Nominatim

Install Claude Code

Add the Connector

Verify the connection

Start using Nominatim

Data Analyst

App Developer

GIS Researcher

Pelias Geocoder

LocationIQ (Geocoding & Maps)

OpenCage Geocoder

Mapbox (Maps & Geospatial)

TomTom

LocationIQ

Give your agent a direct line to Nominatim.