Skip to main content
Glama
Overture Maps MCP server

Overture Maps MCP server

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_places

Search POIs/businesses by lat/lng+radius (country-wide on paid plans), filtered by category, taxonomy, brand or contact details.

list_place_categories

List available place categories (with counts) for a country or area — use to find valid categories values.

list_place_countries

List every country in the dataset with place/brand counts.

search_divisions

Look up administrative divisions (countries, regions, counties, localities) by name or location.

find_buildings

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.js

Releasing

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

OVERTURE_API_KEY

DEMO-API-KEY

Your Overture Maps API key.

OVERTURE_API_BASE

https://api.overturemapsapi.com

Override for staging/self-hosted deployments.

License

MIT

Available Tools

5 tools
find_buildingsA
Read-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_categoriesA
Read-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_countriesA
Read-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_divisionsA
Read-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_placesA
Read-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

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An 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.
      13
      5
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      OSM-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
      -