Chuk MCP Geocoder

You can run and use the Chuk MCP Geocoder to translate place names to coordinates, discover nearby places, and fetch administrative boundaries by querying OpenStreetMap data via Nominatim. It works with other MCP geospatial servers to provide geocoding as a service for your mapping and location-based workflows.

How to use

You access this geocoder server by connecting your MCP client to either a remote public instance or a local/standalone server you run yourself. You can use forward and reverse geocoding, fetch bounding boxes for map tools, discover nearby places, perform batch geocoding, compute route waypoints, and obtain distance matrices. Use the HTTP endpoints for hosted access or run a local MCP client configuration that talks to a local stdio or HTTP server.

How to install

Prerequisites depend on how you want to run the server. You can use the Ultralight deployment method with uvx for zero-install usage, install via uv for development, or install with pip for a traditional Python setup.

Additional notes

Data is sourced from OpenStreetMap through the Nominatim API. The public API has rate limits and caching is used to improve responsiveness. You can configure the Nominatim endpoint and contact email to comply with usage policies.

Available tools

geocode

Convert a place name to geographic coordinates (lat, lon), bounding box, and address details.

reverse_geocode

Convert coordinates back to a place name and address information.

bbox_from_place

Derive a west, south, east, north bounding box for a given place name to support DEM/STAC tools.

nearby_places

Identify places near a given coordinate across multiple distance scales.

admin_boundaries

Retrieve administrative hierarchy data such as country, state, county, city, and suburb.

batch_geocode

Geocode multiple place names in a single request.

route_waypoints

Geocode waypoints in order and compute route distances between them.

distance_matrix

Compute haversine distance matrix between several points.

geocoder_status

Check server status and inspect cache statistics.

geocoder_capabilities

Provide a full capabilities listing and guidance for use.