Back to Browse

Overture Maps MCP Server

Developer ToolsModerate7.3MCP RegistryLocal
Free

Server data from the Official MCP Registry

Overture Maps places (POIs), buildings and administrative boundaries, via the Overture Maps API.

About

Overture Maps places (POIs), buildings and administrative boundaries, via the Overture Maps API.

Security Report

7.3
Moderate7.3Low Risk

The Overture Maps MCP server is a read-only, stdio-based wrapper that calls the Overture Maps HTTP API with an API key read from the environment, and its network access matches its stated purpose. No malicious patterns, shell execution, or hardcoded secrets were found. The only notable items are low-severity: the API base URL and key are overridable via environment variables, and inputs such as coordinates are not range-validated. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

6 files analyzed · 7 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Overture Maps API key from https://account.overturemapsapi.com. Defaults to the public demo key.Required

Environment variable: OVERTURE_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "overture-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@thatapicompany/overture-maps-mcp@0.1.5"
      ],
      "env": {
        "OVERTURE_API_KEY": "your-overture-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

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

ToolWhat it does
search_placesSearch POIs/businesses by lat/lng+radius (country-wide on paid plans), filtered by category, taxonomy, brand or contact details.
list_place_categoriesList available place categories (with counts) for a country or area — use to find valid categories values.
list_place_countriesList every country in the dataset with place/brand counts.
search_divisionsLook up administrative divisions (countries, regions, counties, localities) by name or location.
find_buildingsFind 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.

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

VariableDefaultPurpose
OVERTURE_API_KEYDEMO-API-KEYYour Overture Maps API key.
OVERTURE_API_BASEhttps://api.overturemapsapi.comOverride for staging/self-hosted deployments.

License

MIT

Reviews

No reviews yet

Be the first to review this server!