io.github.cyanheads

openstreetmap-mcp-server

Geocode, reverse geocode, and run Overpass spatial queries on OpenStreetMap data.

Hosted
communityservice

Deployment

Hosted
streamable-httphttps://openstreetmap.caseyjhand.com/mcp

Package Details

Transportstdio
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:stdio

Environment Variables

OSM_NOMINATIM_BASE_URL(str)
Default:https://nominatim.openstreetmap.org

Nominatim API base URL. Override to use a private or mirror instance.

OSM_USER_AGENT(str)
Default:openstreetmap-mcp-server/0.2.0

User-Agent sent to Nominatim and Overpass. Required by usage policy.

OSM_OVERPASS_BASE_URL(str)
Default:https://overpass-api.de/api/interpreter

Overpass API endpoint URL. Override to use a mirror or private instance.

MCP_LOG_LEVEL(str)
Default:info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

TransportStreamable HTTP
Runtimebun

Package Arguments

Positional
Position 0
run
Position 1
start:http

Environment Variables

MCP_HTTP_HOST(str)
Default:127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORT(str)
Default:3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATH(str)
Default:/mcp

The endpoint path for the MCP server.

MCP_PUBLIC_URL(str)

Public origin override for deployments behind a TLS-terminating reverse proxy (e.g. https://mcp.example.com).

MCP_AUTH_MODE(str)
Default:none

Authentication mode to use: 'none', 'jwt', or 'oauth'.

OSM_NOMINATIM_BASE_URL(str)
Default:https://nominatim.openstreetmap.org

Nominatim API base URL. Override to use a private or mirror instance.

OSM_USER_AGENT(str)
Default:openstreetmap-mcp-server/0.2.0

User-Agent sent to Nominatim and Overpass. Required by usage policy.

OSM_OVERPASS_BASE_URL(str)
Default:https://overpass-api.de/api/interpreter

Overpass API endpoint URL. Override to use a mirror or private instance.

MCP_LOG_LEVEL(str)
Default:info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').