OSM POI MCP
Provides tools for discovering OpenStreetMap points of interest and public places by friendly category or raw OSM tag, searching by area name, bounding box, or coordinates plus radius. Returns place details such as name, category, coordinates, address, opening hours, contact information, brand, cuisine, and an OpenStreetMap link.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
OSM POI MCP server
MCP server that lets an AI agent find businesses and public places from OpenStreetMap: restaurants, cafes, hotels, shops, pharmacies, ATMs, EV chargers and 40+ other categories, or any raw OSM tag. It can search by place name, bounding box or point plus radius, and it also geocodes and reverse-geocodes addresses. No API key is needed.
It is ported from the osm-poi-extractor Apify actor. The category map, query builder and row format are the same, but there is no Apify dependency.
Data © OpenStreetMap contributors, ODbL 1.0.
Tools
Tool | What it does |
| POIs for |
| Turns an address or place name into coordinates, a bounding box and a structured address (Nominatim). |
| Turns coordinates into the nearest address or place (Nominatim). |
| Lists the friendly category names and the OSM tags each one maps to. |
Example calls (arguments as JSON):
// find_places: cafes within 2 km of Chaweng, nearest first
{"categories": ["cafes"], "lat": 9.5357, "lon": 100.0627, "radius_m": 2000, "limit": 5}
// find_places: Starbucks in Lisbon (area name resolved through Nominatim)
{"categories": ["cafes"], "area": "Lisbon", "name_contains": "Starbucks", "limit": 5}
// find_places: Thai restaurants in a bbox (south,west,north,east)
{"tags": ["cuisine=thai"], "bbox": "52.49,13.38,52.52,13.43", "limit": 10}
// geocode
{"query": "Chaweng Beach, Koh Samui", "limit": 3, "country_codes": "th"}
// reverse_geocode
{"lat": 9.5357, "lon": 100.0627, "zoom": 18}A find_places result looks like this (fields are only present when tagged in OSM):
{"attribution": "© OpenStreetMap contributors, ODbL 1.0 (https://www.openstreetmap.org/copyright)",
"license": "ODbL 1.0 - https://opendatacommons.org/licenses/odbl/1-0/",
"scope": "area 'Lisbon, Portugal'", "count": 5, "truncated": true,
"places": [{"name": "Starbucks", "category": "cafes", "primaryTag": "amenity=cafe", "lat": 38.6975196, "lon": -9.2036756,
"fullAddress": "110 Rua de Belém, Lisboa, 1300-085", "brand": "Starbucks", "openingHours": "...",
"osmUrl": "https://www.openstreetmap.org/node/477853299"}]}Related MCP server: @cyanheads/openstreetmap-mcp-server
Run
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
PORT=8093 .venv/bin/python src/server.py # streamable-http on 0.0.0.0:8093/mcp
MCP_TRANSPORT=stdio .venv/bin/python src/server.py # stdioEnvironment variables:
Variable | Default | Purpose |
|
| Address the HTTP server listens on |
|
| Transport ( |
| Private.coffee, then VK Maps | Comma-separated Overpass interpreter URLs |
|
| Use your own Nominatim instance |
|
| Identifying User-Agent. Set one with your app's contact URL for production. |
Limits
find_placesreturns at most 200 results (default 50) and reportstruncatedwhen more matched.Radius search is capped at 20 km. In dense places it samples up to 5×limit matches inside the circle and returns the nearest of those.
Areas and bboxes larger than 25,000 km² are rejected.
Each call makes one Overpass query with a 25 s server timeout. Retries and endpoint switching are capped at about 75 s in total. Responses larger than 8 MB are refused.
Geocoding takes the first hit. Add the country or region to the name, or pass a bbox, when a name is ambiguous.
Data sources, licences and usage policies
OpenStreetMap data is © OpenStreetMap contributors and licensed under the Open Database License 1.0. Anywhere you show or use the data, credit "© OpenStreetMap contributors" with a link to https://www.openstreetmap.org/copyright. If you publicly distribute a derivative database built from it, that database must be ODbL too (share-alike). Every tool response carries an
attributionfield.Overpass API. The server uses public instances that allow general use: Private.coffee by default, with VK Maps as fallback. Under Private.coffee's terms the service must not be used for military or warfare projects.
overpass-api.deis not used by default because it asks commercial and heavy users to go elsewhere. Queries run one at a time per process with a pause between them. Endpoints that hang or rate-limit (429/406) are set aside for 5 minutes. For heavy use, pointOVERPASS_ENDPOINTSat your own instance.Nominatim (usage policy). The server sends at most 1 request per second per process, uses an identifying User-Agent and caches results in memory (500 entries). Bulk geocoding and autocomplete are not allowed on the public instance. For volume, set
NOMINATIM_URLto your own instance.OSM is community data. Coverage of addresses, hours and contacts varies by region. Contact fields describe businesses, but some list a personal phone or email, so use them lawfully (GDPR, PDPA, anti-spam rules).
Known limitations
Public Overpass servers are often overloaded and can return 504 or time out for a minute or more. The tool then returns
{"error": ...}and the agent can retry later. During testing, Private.coffee and overpass-api.de did not answer from this host, and VK Maps answered after a few 504 retries.Area resolution uses the administrative polygon when Nominatim returns one (an OSM relation or way). Otherwise it falls back to the place's bounding box.
Use with Claude Desktop or another MCP client
Local (stdio). Clone the repo, create the venv as above, then add this to claude_desktop_config.json
(or your client's MCP config), with the paths changed to where you cloned it:
{
"mcpServers": {
"osm-poi": {
"command": "/path/to/osm-poi-mcp/.venv/bin/python",
"args": ["/path/to/osm-poi-mcp/src/server.py"],
"env": {"MCP_TRANSPORT": "stdio"}
}
}
}Remote (streamable HTTP). Run .venv/bin/python src/server.py on a server and point any client that supports
remote MCP servers at http://<host>:8080/mcp. GET /health returns {"status": "healthy"}.
License
MIT, see LICENSE. The data returned by the tools stays under the terms of its sources (see above).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.
Places near any address: restaurants, pharmacies, hotels and more (OpenStreetMap). Free, no key.
Geocode, reverse-geocode, autocomplete, route and search places.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides forward/reverse geocoding, bounding box extraction, nearby places discovery, batch geocoding, route waypoints, and administrative boundary lookup using OpenStreetMap data.10Apache 2.0
- AlicenseNot gradedqualityAmaintenanceGeocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data via MCP.802 npm9Apache 2.0
- AlicenseAqualityDmaintenanceProvides location-based services and geospatial data from OpenStreetMap, enabling geocoding, route directions, nearby place search, and neighborhood analysis through natural language.12MIT
- AlicenseAqualityCmaintenanceEnables LLMs to geocode and reverse geocode places, find nearby points of interest, search categories within an area, get turn-by-turn routing, suggest meeting points, and analyze neighborhoods, commutes, schools, EV charging, and parking through OpenStreetMap data services. It also serves place and map tile resources over stdio, SSE, or Streamable HTTP transports.12MIT