# Nominatim MCP for AI Agents AI Agent Connect > Nominatim lets you geocode addresses and reverse geocode coordinates using OpenStreetMap data. It works without an API key, making it a straightforward way to handle location-based data, find specific places by name, or grab bounding boxes for cities and regions. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_8IxlC9ctUCyetK3OIL7HGhxUdKZezmN5BOMtONYK/ai-agent-connect - **Tags:** geocoding, reverse-geocoding, openstreetmap, location-search, spatial-data ## Description Imagine you're building an app that needs to turn a list of street addresses into actual GPS coordinates. Usually, that means signing up for a paid service, managing keys, and worrying about rate limits. This Connector changes that by hooking your AI client directly into Nominatim. You can just ask your agent to find the coordinates for a specific landmark, look up what's at a set of GPS points, or pull the bounding boxes for a whole country. It handles the heavy lifting of searching the world's largest open-source geographic database so you don't have to. Whether you're cleaning up a messy dataset of locations or building a travel tool that needs to know what's nearby, this connection gives your agent spatial awareness. You'll find it's a lot easier to work with when you're browsing the Vinkius catalog and just want a tool that works out of the box without the overhead of extra credentials. ## Tools ### 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. ### 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. ### 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. ### search Finds places by name or address and returns coordinates along with structured address components. This is the primary way to find new locations. ### get_status Checks if the Nominatim service is up and running before you start your requests. It helps verify connectivity quickly. ## Prompt Examples **Prompt:** ``` What's the address for the coordinates 48.8584, 2.2945? ``` **Response:** ``` The coordinates **48.8584, 2.2945** correspond to: * **Place:** Eiffel Tower * **Address:** Champ de Mars, 5 Avenue Anatole France, 75007 Paris, France * **Type:** Park * **Region:** Paris, France ``` **Prompt:** ``` Can you find the bounding box for Tokyo? ``` **Response:** ``` I found the geographic boundaries for **Tokyo, Japan**: * **Bounding Box:** 35.6895 to 35.7769 (lat), 139.6503 to 139.8110 (lon) * **OSM ID:** W326168186 (way) * **Type:** City ``` **Prompt:** ``` Give me the coordinates and postal code for 1600 Pennsylvania Avenue NW, Washington, DC. ``` **Response:** ``` | Location | Coordinates | Postal Code | | :--- | :--- | :--- | | **White House** | 38.8977, -77.0365 | 20500 | * **Full Address:** 1600 Pennsylvania Avenue NW, Washington, DC 20500, United States ``` ## Capabilities ### Convert addresses to coordinates Turn a physical street address into precise latitude and longitude points. ### Turn coordinates into addresses Find out what human-readable location exists at a specific set of GPS coordinates. ### Look up OpenStreetMap objects Fetch specific details for any object in the OpenStreetMap database using its ID. ### Extract address components Break down a location into parts like street, city, state, and postal code. ### Get regional bounding boxes Retrieve the geographic boundaries for cities, countries, and other regions. ### Fetch multi-language names Get the names of places in different languages for internationalized projects. ## Use Cases ### Mapping a store list A developer needs to map 100 stores. The agent uses search to get coordinates for each one automatically. ### Identifying GPS points A traveler wants to know what is at a specific set of coordinates. The agent uses reverse_geocode to find the landmark. ### Finding regional boundaries A researcher needs a city's boundary. The agent uses search to find the bounding box for the area. ### Cleaning messy location data An analyst needs to clean a dataset of addresses. The agent uses search to get structured address parts for every row. ## Benefits - Stop paying for geocoding services by using Nominatim to get coordinates for free. - Get structured address components like postal codes and states using the search tool. - Find specific places by name or type without manual searching through maps. - Convert raw GPS coordinates into readable human addresses with reverse_geocode. - Retrieve bounding boxes for cities and regions to define geographic boundaries. - Access multi-language place names for internationalized location data. ## How It Works The bottom line is you get instant access to global geographic data without managing any API keys. 1. Subscribe to the Nominatim MCP on Vinkius. 2. Connect the Connector to your preferred AI client like Claude or Cursor. 3. Ask your agent to geocode addresses or find local landmarks. ## Frequently Asked Questions **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.