Overture Maps MCP

Python MCP server (2025-03-26 spec, streamable HTTP) for querying Overture Maps building footprint data.

Tools

Related MCP server: geocontext

Deployment

Railway (recommended)

1. Fork this repo or connect it to Railway

2. Set environment variables:

   • MCP_SERVER_SECRET — bearer token for API auth

   • PORT — automatically set by Railway (default 8000)

3. Railway builds the Dockerfile and deploys

Docker

docker build -t overture-mcp .
docker run -p 8000:8000 -e MCP_SERVER_SECRET=your-secret overture-mcp

Local development

pip install -e ".[dev]"
uvicorn src.overture_mcp.server:app --reload

API

• GET /health — health check (no auth required)

• POST /mcp — MCP streamable HTTP endpoint (requires Authorization: Bearer <token>)

Auth

Set MCP_SERVER_SECRET to require a bearer token on all MCP requests. Leave unset to disable auth (development only).

Data

Queries the Overture Maps 2026-05-20.0 release (~2.5B buildings globally) stored on AWS S3 (s3://overturemaps-us-west-2). DuckDB reads parquet files directly — no data is downloaded to the server.

Each query uses a bounding-box predicate for partition pruning, so typical requests scan only a small fraction of the dataset.

Connecting to Claude

Add to .claude/settings.json:

{
  "mcpServers": {
    "overture-maps": {
      "transport": "streamable-http",
      "url": "https://your-deployment.railway.app/mcp",
      "headers": {
        "Authorization": "Bearer your-secret"
      }
    }
  }
}