How to Use the Nominatim MCP in VS Code Copilot

Q: How do I share the Nominatim MCP Server with my team in VS Code Copilot?

Add the server configuration to .vscode/mcp.json and commit it to your Git repository. Every team member using VS Code Copilot will instantly have access to the spatial tools in their chat.

Q: How do I confirm the geocoding endpoint is currently active?

Your agent runs getstatus to check the response latency, verifying the server is fully operational before executing long-running geocoding tasks.

Share OpenStreetMap geocoding and reverse lookup tools across your entire engineering team in VS Code Copilot.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Nominatim MCP to VS Code Copilot

Create your Vinkius account to connect Nominatim to VS Code Copilot and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Nominatim with VS Code Copilot

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Geocode addresses within shared VS Code Copilot sessions

`search` converts physical address strings into geographic coordinates directly inside your VS Code Copilot chat window. When your team commits `.vscode/mcp.json` to the repository, every developer gets instant access to structured location lookup tools. This team-wide MCP Server ensures that everyone uses the same geocoding interface. Your agent can instantly verify physical boundaries and country codes without requiring individual API keys or private developer accounts.

Reverse geocode coordinates in VS Code Copilot

`reverse_geocode` translates raw latitude and longitude variables into structured addresses right inside your active editor. If you are debugging a mapping feature, your agent calls this tool to resolve coordinates to their administrative boundaries. You can customize the precision of the output by adjusting the zoom level parameters of the query. The tool returns the exact street, city, and postal code, making it easy to write accurate unit tests.

Look up OSM identifiers inside VS Code Copilot

`lookup_osm` retrieves spatial properties and bounding boxes for specific node, way, or relation IDs directly in your editor using this MCP tool. Your agent uses this tool to check geographic geometries before writing database migration scripts. For deeper inspections, `get_details` exposes the place hierarchy and Wikipedia links of the target area. This allows your team to validate geographic relationships directly within VS Code Copilot.

Setup guide

Set up Nominatim MCP in VS Code Copilot

Prerequisites

VS Code 1.99 or later with GitHub Copilot extension
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and run "MCP: Add Server". Select HTTP (Streamable) as the server type. VS Code will create .vscode/mcp.json in your workspace.
2

Add the Nominatim MCP

Paste the JSON snippet shown on the right into your .vscode/mcp.json. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Switch to Agent mode

Open Copilot Chat (Cmd+Shift+I / Ctrl+Shift+I) and switch to Agent mode using the dropdown. MCP tools are only available in Agent mode — they do not appear in Edit or Ask modes.
4

Verify the connection

In the Copilot Chat input, type # to list available tools. You should see the Nominatim tools listed. Try asking: "List my recent Nominatim transactions" and Copilot will invoke them automatically.

.vscode/mcp.json

{
  "mcpServers": {
    "nominatim-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Nominatim. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Nominatim now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Nominatim MCP in VS Code Copilot

Add the server configuration to `.vscode/mcp.json` and commit it to your Git repository. Every team member using VS Code Copilot will instantly have access to the spatial tools in their chat.

The server enforces a strict limit of one request per second. The MCP Server manages this delay under the hood, ensuring your VS Code Copilot queries don't trigger IP bans.

Yes, you can ask your VS Code Copilot agent to apply country codes and viewbox coordinates to narrow down the `search` results to your target region.

Your agent runs `get_status` to check the response latency, verifying the server is fully operational before executing long-running geocoding tasks.

Yes, the coordinates and address strings are sent directly to the public OpenStreetMap API over secure HTTPS. Vinkius runs the connector in an isolated sandbox, keeping your codebase and project files completely private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript