WindsurfIDE

Why use Nominatim MCP Server with Windsurf?

Bring Geocoding
to Windsurf

Name: Nominatim MCP Server
Availability: InStock
Rating: 5.0 (1 reviews)
Author: Vinkius

Create your Vinkius account to connect Nominatim to Windsurf and start using all 5 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.

GDPR Free for Subscribers

Get DetailsGet StatusLookup OsmReverse GeocodeSearch

Ask AI about this MCP Server ChatGPT Claude Perplexity

Compatible with every major AI agent and IDE

Claude

ChatGPT

Cursor

Gemini

Windsurf

VS Code

JetBrains

Vercel

+ other MCP clients

What is the Nominatim MCP Server?

Connect to Nominatim and search the world's most comprehensive open-source geographic database through natural conversation — no API key needed.

What you can do

Address Search — Find any place by name, address or type of place (restaurants, schools, hospitals)
Reverse Geocoding — Convert GPS coordinates to human-readable addresses
OSM Lookup — Look up detailed info for any OpenStreetMap object by its ID
Structured Addresses — Get detailed address components (street, city, state, postal code, country)
Multi-language Names — Retrieve place names in different languages
Bounding Boxes — Get geographic boundaries for cities, countries and regions

How it works

Subscribe to this server
No API key needed — start searching immediately
Explore geographic data from Claude, Cursor, or any MCP-compatible client

No API key required — completely free, powered by OpenStreetMap community data.

Who is this for?

Developers — geocode addresses and convert coordinates without paid geocoding services
Travelers — find addresses and discover what's at any GPS coordinate
Researchers — explore OpenStreetMap object details, administrative boundaries and place hierarchies
Data Analysts — batch geocode addresses and extract structured location data

Built-in capabilities (5)

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

get_status

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

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

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

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

See what your AI agent can do with Nominatim

Why Windsurf?

Windsurf's Cascade agent chains multiple Nominatim tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 5 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.

—
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
—
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
—
JSON-based configuration means zero code changes: paste a URL, reload, and all 5 tools are immediately available
—
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts

See it in action

Nominatim in Windsurf

AI Agent→Vinkius

High Security·Kill Switch·Plug and Play

Enterprise Security

Why run Nominatim with Vinkius?

The Nominatim connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 5 tools are ready to work instantly without any complex setup.

You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

View full Nominatim details →

Fully ManagedNo server setup

Plug & PlayNo coding needed

SecurePrivacy protected

PrivateYour data is safe

Cost ControlBudget limits

Control1-click disconnect

Auto-UpdatesMaintenance free

High SpeedOptimized for AI

Reliable99.9% uptime

Your credentials and connection tokens are fully encrypted

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure

01 / Catalog

Over 4,000 integrations ready for AI agents

Explore a vast library of pre-built integrations, optimized and ready to deploy.

02 / Credentials

Connect securely in under 30 seconds

Generate tokens to authenticate and link external services in a single step.

03 / Guardian

Complete visibility into every agent action

Audit live requests, latency, success rates, and active security compliance policies.

04 / FinOps

Optimize spending and track token ROI

Analyze real-time token consumption and cost metrics detailed by connection.

Over 4,000 integrations ready for AI agents

Complete visibility into every agent action

Explore our live AI Agents Analytics dashboard to see it all working

This dashboard is included when you connect Nominatim using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.

Explore Analytics

Why Vinkius

Nominatim and 4,000+ other AI tools. No hosting, no code, ready to use.

Professionals who connect Nominatim to Windsurf through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.

4,000+MCP Integrations

<40msResponse time

100%Fully managed

	Raw MCP	Vinkius
Ready-to-use MCPs	Find and configure each manually	4,000+ MCPs ready to use
Connection Setup	Manual coding & server setup	1-click instant connection
Server Hosting	You host it yourself (needs 24/7 uptime)	100% hosted & managed by Vinkius
Security & Privacy	Stored in plaintext config files	Bank-grade encrypted vault
Activity Visibility	Blind execution (no logs or tracking)	Live dashboard with real-time logs
Cost Control	Runaway AI token spend risk	Automatic budget limits
Revoking Access	Must delete files or code to stop	1-click disconnect button

View step-by-step setup guide for Windsurf →

The Vinkius Advantage

How Vinkius secures
Nominatim for Windsurf

Every request between Windsurf and Nominatim is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.

< 40msCold start

Ed25519Signed audit chain

60%Token savings

FAQ

Frequently asked questions

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.

How does Windsurf discover MCP tools?

Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.

Can Cascade chain multiple MCP tool calls?

Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.

Does Windsurf support multiple MCP servers?

Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.