# Overture Maps

> Overture Maps is a freemium MCP server for maps and travel. Query Overture Maps places, buildings and boundaries from an AI assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $25 a month
- **Platforms:** CLI, API
- **Website:** https://www.overturemapsapi.com/docs/use-with-ai-tools
- **Repository:** https://github.com/thatapicompany/overture-maps-mcp
- **MCP Registry name:** io.github.thatapicompany/overture-maps-mcp
- **Categories:** maps and travel
- **Listing updated:** 2026-11-14

## About

The data underneath is Overture Maps: points of interest, building footprints and administrative divisions. This server keeps its answers small by returning compact summaries instead of full GeoJSON, and its tools steer an assistant toward cheap, well-scoped queries.

Five read-only tools cover the job. `search_places` finds businesses by latitude, longitude and radius, filtered by category, brand or contact details, and goes country-wide on paid plans. `list_place_categories` and `list_place_countries` stop the assistant guessing valid values, `search_divisions` looks up regions by name or location, and `find_buildings` returns footprints with distance and height.

It runs locally over stdio and wraps the Overture Maps API. A public demo key works for small searches near New York, London, Paris and Bondi Beach; a free key searches anywhere for non-commercial use. Free allows 100 requests a month, and paid plans start at $25 a month with a commercial licence.

## Features

- **Place search:** Find POIs by point and radius, filtered by category, brand or contact details.
- **Category discovery:** List valid categories and countries before searching.
- **Division lookup:** Resolve countries, regions, counties and localities by name or location.
- **Building footprints:** Return buildings near a point with distance and height or levels.
- **Compact responses:** Summaries instead of GeoJSON keep context usage low.
- **Read-only tools:** Every tool declares a read-only hint so clients can skip confirmation.

## Good for

- Find pharmacies near an address that have a website
- Work out which administrative region a place is in
- Estimate building heights around a landmark
- Build a local business list for a market study

## Install

### Claude Code (Terminal)

```sh
claude mcp add overture-maps-mcp --env OVERTURE_API_KEY='<OVERTURE_API_KEY>' -- npx -y @thatapicompany/overture-maps-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "overture-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@thatapicompany/overture-maps-mcp"
      ],
      "env": {
        "OVERTURE_API_KEY": "<OVERTURE_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "overture-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@thatapicompany/overture-maps-mcp"
      ],
      "env": {
        "OVERTURE_API_KEY": "<OVERTURE_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "overture-maps-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thatapicompany/overture-maps-mcp"
      ],
      "env": {
        "OVERTURE_API_KEY": "<OVERTURE_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "overture-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@thatapicompany/overture-maps-mcp"
      ],
      "env": {
        "OVERTURE_API_KEY": "<OVERTURE_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "overture-maps-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@thatapicompany/overture-maps-mcp"
      ],
      "env": {
        "OVERTURE_API_KEY": "<OVERTURE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `search_places`: Searches places and businesses by point and radius, or country-wide on paid plans.
- `list_place_categories`: Lists available place categories for a country or area.
- `list_place_countries`: Lists countries in the dataset with place and brand counts.
- `search_divisions`: Looks up administrative divisions by name or location.
- `find_buildings`: Finds building footprints near a point.

## FAQ

### Do I need an API key?

A public demo key works near a few cities; a free key searches anywhere.

### What do the plans cost?

Free is $0 for 100 requests a month; Premium $25, Growth $50 and Scale $100 a month.

### Can I use it commercially?

Free is non-commercial; paid plans include a commercial licence.

### Can I self-host the API?

Yes, the API is open source and deploys to your own Google Cloud project.

### Is Overture Maps free?

Overture Maps has a free plan, with paid plans for more usage or features. Paid plans start at $25 a month.

### How do I add Overture Maps to Claude Code?

Run this command in your terminal: claude mcp add overture-maps-mcp --env OVERTURE_API_KEY='<OVERTURE_API_KEY>' -- npx -y @thatapicompany/overture-maps-mcp

### What are the best alternatives to Overture Maps?

The closest alternatives to Overture Maps are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, Gangway AIS and Tickets: tours and event tickets in South America.

## Alternatives

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Big Data Insights for Regional Inflow in Korea](https://ai-powered.com/mcp/big-data-insights-for-regional-inflow-in-korea): Big Data Insights for Regional Inflow in Korea is a free MCP server for analytics and data.

---
Source: https://ai-powered.com/mcp/overture-maps
