Overture Maps MCP server
A read-only local MCP server for querying Overture Maps places, divisions, and buildings with compact, token-efficient results.
Search places/POIs by latitude/longitude plus radius, with optional country, category, taxonomy, brand, contact, and confidence filters.
List available place categories and all covered countries with place/brand counts.
Search administrative divisions by name or location, filtering by country, subtype, or admin level, with optional boundary geometry.
Find building footprints near a point, returning compact summaries such as ID, distance, height, or levels.
Use a demo API key for light testing in selected cities; country-wide place searches require a paid plan.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Overture Maps MCP server Find Italian restaurants in Rome"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Overture Maps MCP server
Query Overture Maps data — places (POIs), buildings and administrative divisions — directly from Claude and other MCP-compatible LLM tools.
This is a local (stdio) MCP server that wraps the Overture Maps API. Responses are compact summaries rather than full GeoJSON, so they stay token-efficient, and the tools steer toward cheap, well-scoped queries.
Tools
Tool | What it does |
| Search POIs/businesses by lat/lng+radius (country-wide on paid plans), filtered by category, taxonomy, brand or contact details. |
| List available place categories (with counts) for a country or area — use to find valid |
| List every country in the dataset with place/brand counts. |
| Look up administrative divisions (countries, regions, counties, localities) by name or location. |
| Find building footprints near a point (id, distance, height/levels). |
Every tool is read-only: each declares readOnlyHint, destructiveHint: false, idempotentHint and openWorldHint, so clients can call them without a confirmation step.
Related MCP server: geo-mcp
Get an API key
Sign up at app.overturemapsapi.com for a free API key and set it as OVERTURE_API_KEY. The public DEMO-API-KEY works for light testing near a few demo cities (New York, London, Paris, Bondi Beach). Country-wide place searches (a country with no lat/lng) need a paid plan.
Note: the Free tier is for non-commercial use. Commercial use needs a paid plan.
Use with Claude Desktop
Add this to your claude_desktop_config.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"overture-maps": {
"command": "npx",
"args": ["-y", "@thatapicompany/overture-maps-mcp"],
"env": {
"OVERTURE_API_KEY": "your-api-key-here"
}
}
}
}Restart Claude Desktop. You can then ask things like:
"Find cafes within 500m of the Eiffel Tower."
"List every used car dealer in the UK that has a website."
"What administrative region is Springfield in?"
"How many places does Overture have for Bermuda?"
Use with other MCP clients
Any client that supports local stdio MCP servers works the same way — run npx -y @thatapicompany/overture-maps-mcp with OVERTURE_API_KEY in the environment.
Local development
npm install
npm run build
npm test
OVERTURE_API_KEY=your-key node dist/index.jsReleasing
Releases publish to npm from GitHub Actions with trusted publishing, so no npm token is needed, and then list the same version in the official MCP Registry as io.github.thatapicompany/overture-maps-mcp (GitHub OIDC, no secret needed; metadata in server.json). Bump version in package.json, merge to main, then publish a GitHub release tagged v<version> (for example v0.1.3). The workflow checks the tag matches, builds, runs the tests and publishes with provenance.
Environment variables
Variable | Default | Purpose |
|
| Your Overture Maps API key. |
|
| Override for staging/self-hosted deployments. |
License
Available Tools
5 toolsfind_buildingsARead-onlyIdempotent
Find building footprints near a location from Overture Maps. Requires lat+lng; returns compact building summaries (id, distance, height/levels where known) without full geometry.
Inputs: lat (required), lng (required), limit, radius.
list_place_categoriesARead-onlyIdempotent
List the place categories available in Overture Maps data for a country (or a lat/lng/radius area), with how many places each has. Use this to find valid categories values before calling search_places.
Inputs: lat, lng, radius, country.
list_place_countriesARead-onlyIdempotent
List every country present in Overture Maps places data, with the number of places (and brands) in each. Useful to check coverage before searching.
Inputs: no named parameters.
search_divisionsARead-onlyIdempotent
Look up administrative divisions (countries, regions, counties, localities) in Overture Maps. Search by name (e.g. 'Springfield'), optionally narrowed by country, subtype (country, region, county, locality, ...) or admin_level. Geometry is omitted by default to save space; set include_geometry=true only if you specifically need the boundary polygon.
Inputs: lat, lng, name, limit, +5 more.
search_placesARead-onlyIdempotent
Search for places (points of interest / businesses) in Overture Maps data. Scope every search with a lat+lng and a radius (up to 25 km); geocode a named town or city to coordinates first. A country-wide search (country with no lat/lng) is only available on paid plans; country can always be added alongside lat/lng as an extra filter. Filter by categories (e.g. restaurant, cafe, bakery — use list_place_categories to discover valid values), brand_name (e.g. Starbucks), or has_contact to only return places with a website/phone. Returns compact summaries (name, category, location, website, phone), not full geometry.
Inputs: lat, lng, page, limit, +7 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct entity type or listing purpose: two list tools (categories vs countries), a place search, a division lookup, and a building-footprint finder. Descriptions explicitly cross-reference each other (use list_place_categories before search_places), leaving no realistic chance of misselection.
Predictable verb_noun snake_case pattern (list_*, search_*, find_*). Minor deviations: 'find_buildings' uses a different verb than the other spatial search tools, and 'list_place_categories'/'list_place_countries' carry an extra noun compared to 'list_*' elsewhere.
Five tools is compact and each earns its place for a places/POI workflow, with no redundancy. It sits slightly on the thin side for a dataset as broad as Overture, but nothing extraneous is present.
Core discovery-and-search flow is covered, but every search returns compact summaries only, and there is no get_place_details / fetch-by-id tool to retrieve full records or geometry — a dead end after a search. Overture's addresses/transportation themes are also absent, though that may be out of scope.
Maintenance
Related MCP Connectors
Overture Maps places — business and point-of-interest locations (name, category, confidence…
Routing, geocoding, places, matrix and map tools for location-aware AI workflows.
Geocoding, routing, isochrones, traffic, weather, and place search for AI agents. 19 MCP tools.
Verifiable geospatial tools: distances, topology, isochrones, Overture Maps, with sources.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that provides AI agents with geospatial analytics by querying Overture Maps data directly from S3, enabling place analytics, building composition, land use classification, and transportation analysis.135MIT
- FlicenseAqualityDmaintenanceOSM-backed multimodal navigation MCP server enabling geocoding, route planning, POI discovery, and urban layout analysis. It provides a structured city graph to LLM apps without proprietary map APIs.8-
- AlicenseAqualityDmaintenanceAn OpenStreetMap MCP server that provides location-based services including geocoding, route directions, points of interest search, and neighborhood analysis to enhance LLMs with geospatial capabilities.121MIT
- AlicenseAqualityDmaintenanceAn OpenStreetMap MCP server providing geocoding, routing, points of interest, map tiles, public transport, and energy infrastructure tools to enhance LLM location-based capabilities.16MIT