# Overpass (OpenStreetMap) MCP > Overpass (OpenStreetMap) lets you query the world's free geographic database directly through your AI client. You can search for anything from restaurants and hospitals to EV charging stations and specific retail tags across any global area, needing zero API keys or complex coding. ## Overview - **Category:** data-analytics - **Price:** Free - **Tags:** openstreetmap, geographic-data, spatial-query, location-intelligence, mapping ## Description Need to know what's actually on the ground in a city? This MCP connects your agent to OpenStreetMap, querying massive amounts of public geographic data. You don't need to write complicated queries; you just ask for what you need—like finding all hospitals within a specific neighborhood or locating every coffee shop near a university campus. The result is structured data containing names, addresses, and details for everything found. Whether you’re planning an urban development project, building a location-aware app, or just trying to find the nearest sushi place in Tokyo, this tool gives you instant access. Since Vinkius hosts this MCP, you connect once from your preferred AI client (Claude, Cursor, etc.) and gain immediate access to querying the world's most comprehensive map data source. ## Tools ### custom_query Allows you to execute any custom Overpass QL query against the entire OpenStreetMap database. ### search_amenities Searches for general amenities like restaurants, schools, and hospitals within a specified bounding box. ### search_atms Retrieves detailed information on ATM locations, including the bank operator and availability status, within a given area. ### search_by_name Finds specific OSM features by name while also allowing you to filter results with full details like phone numbers or websites. ### search_by_tag Narrows down search results by filtering elements based on specific OpenStreetMap key/value tags in a bounding box. ### search_charging_stations Locates and gathers details about EV charging stations, including connector types and charging speeds, within a specified area. ### search_fuel_stations Finds gas/fuel stations in a bounding box, providing information on fuel types offered and operating hours. ### search_hospitals Searches for hospitals and clinics within a defined area, returning details like specialties and emergency service contacts. ### search_hotels Locates hotels in a bounding box, providing key details such as star ratings and contact information. ### search_nearby Finds general OSM elements near a single GPS point without needing to define an entire search area. ### search_nearby_amenities Searches for specific amenities like banks or schools near a location, returning names and addresses. ### search_parks Identifies parks and green spaces within a bounding box, providing details on area size and features like playgrounds. ### search_pharmacies Locates pharmacies in a specified region, giving opening hours, phone numbers, and dispensing information. ### search_restaurants Searches for restaurants within an area, optionally filtering by cuisine type like Italian or Mexican. ### search_schools Finds schools in a bounding box, providing details on student capacity and contact information. ### search_shops Searches for various shops, including supermarkets or clothing stores, within a defined geographical area. ## Prompt Examples **Prompt:** ``` Find all restaurants in Lower Manhattan. ``` **Response:** ``` Found 250+ restaurants in Lower Manhattan (bbox: 40.70,-74.02,40.72,-73.98). Includes Italian, Chinese, Japanese, American, Mexican and many more cuisines. Names, addresses, phone numbers and opening hours included. ``` **Prompt:** ``` Find ATMs within 500m of Times Square (40.7580, -73.9855). ``` **Response:** ``` Found 18 ATMs within 500m of Times Square. Operators include Chase, Bank of America, Citibank, Wells Fargo and independent ATM networks. Locations include buildings, stores and subway stations. ``` **Prompt:** ``` Find EV charging stations in downtown San Francisco. ``` **Response:** ``` Found 45 EV charging stations in downtown SF. Includes Tesla Superchargers, ChargePoint, EVgo and Blink stations. Connector types, charging speeds and access info provided. ``` ## Capabilities ### Find specific amenities by type You can search for common points of interest like restaurants, schools, or pharmacies within a defined geographical area. ### Track infrastructure and services Locate critical utilities such as EV charging stations, fuel pumps, ATMs, and public parking spots across large regions. ### Deep dive into regional data Execute custom queries using Overpass QL syntax to retrieve highly specific OSM features not covered by standard searches. ### Analyze proximity to a point Find amenities or resources near a known GPS coordinate without needing to define an entire search box. ## Use Cases ### Analyzing neighborhood readiness An urban planner needs to assess if a new development site has enough infrastructure. They use the MCP to run `search_amenities` and gather counts for hospitals, schools, and pharmacies within the proposed boundaries, confirming it meets zoning requirements. ### Building a local guide app A developer needs to populate their prototype with POIs. They use `search_nearby_amenities` repeatedly around a central point to gather data on nearby banks and ATMs, then feed that structured list into the app's database. ### Planning an emergency response A coordinator needs to know where medical help is located. They run `search_hospitals` for a specific sector, prioritizing facilities based on their listed specialties and proximity details. ## Benefits - Don't waste time on manual map lookups. Instead of clicking through separate map layers for restaurants, you simply ask your agent to 'Find all Italian restaurants near 40.75 N.' and get a direct list from the `search_restaurants` tool. - It handles complex geography without code. You don't need to manually calculate bounding boxes for every search; tools like `search_nearby_amenities` let you pinpoint resources relative to any given coordinate. - The data is incredibly rich and structured. When you find a hotel using the `search_hotels` tool, you get star ratings, addresses, and phone numbers—not just a vague dot on a map. - You can analyze entire regions at once. If you need an infrastructure report for a neighborhood, running a custom query via `custom_query` aggregates data points like parks, schools, and commercial zones simultaneously. - It covers all the essentials of daily life. Need to check for medical services? Use `search_hospitals`. Looking for car repairs? Check `search_shops` with specific filters. It's a one-stop geographic intelligence tool. ## How It Works The bottom line is that you get clean, actionable location intelligence without writing a single API call yourself. 1. Subscribe to this MCP on Vinkius and connect your preferred AI client. 2. Tell your agent exactly what you need, providing necessary geographic boundaries or coordinates (e.g., 'Find all hospitals between these two points'). 3. The tool runs the query against OpenStreetMap and returns structured JSON data containing names, addresses, details, and locations of everything found. ## Frequently Asked Questions **How do I find nearby restaurants using Overpass (OpenStreetMap) MCP?** You use the `search_nearby_amenities` tool and specify 'restaurant' as the amenity type. You only need to provide your current location or coordinates, and the tool handles the rest. **Can I find specific shops using Overpass (OpenStreetMap) MCP?** Yes, you can use `search_shops` and filter by common types like 'electronics' or 'bakery.' It returns details for those shops within your specified area. **Is this good for finding medical facilities? Overpass (OpenStreetMap) MCP?** Absolutely. Use `search_hospitals` to find major care centers, or use `search_pharmacies` if you need local dispensing information and opening hours. **What if I want data that isn't listed in the search_amenities tool?** For specialized searches, always default to the `custom_query` tool. This lets you write specific Overpass QL syntax to pull out any unique OpenStreetMap feature. **Can I find EV charging stations for free? Using Overpass (OpenStreetMap) MCP?** Yes, the `search_charging_stations` tool queries this public data. It provides names, addresses, and crucial details like connector types within your bounding box.