wtronk avatar

Geolocation Mcp

wtronk/geolocation-mcp

This wraps the Jeleo Geolocation API and gives Claude two tools for location lookups. The reverse_geocode tool takes latitude and longitude coordinates and returns detailed location metadata including city, country, population metrics, and economic data. The batch_reverse_geocode tool handles multiple coordinates in one shot. You'll need a Jeleo API key from jeleo.zone.id to authenticate requests. Reach for this when you need structured geocoding without building your own lookup pipeline, especially if you're already processing coordinate data or IP addresses and want enriched location context for analysis or user features.

tools
2
auth
Secret needed
transport
STDIO
env vars
2
last updated
Mar 21, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

reverse_geocodeGet rich location metadata (city, country, population metrics, economic data) from latitude/longitude coordinates.

Get rich location metadata (city, country, population metrics, economic data) from latitude/longitude coordinates.

No parameter schema in public metadata yet.

batch_reverse_geocodeResolve a list of multiple geographic coordinates in a single request.

Resolve a list of multiple geographic coordinates in a single request.

No parameter schema in public metadata yet.

Sponsors

Configuration

YOUR_API_KEY*secret

Your API key for the service

JELEO_API_URLdefault: https://www.jeleo.zone.id/api/geolocation

Base URL for the Jeleo Geolocation API

Readme

geolocation-mcp

This is a Model Context Protocol (MCP) server that acts as a wrapper around the GeoLocation API. It provides tools for LLMs (like Claude) to perform fast reverse geocoding and batch reverse geocoding (via IP and coordinates).

Tools

  • reverse_geocode: Get rich location metadata (city, country, population metrics, economic data) from latitude/longitude coordinates.
  • batch_reverse_geocode: Resolve a list of multiple geographic coordinates in a single request.

Configuration

The MCP server requires an API Key and an API Base URL. You can retrieve them from https://jeleo.zone.id/. They are provided to the server as command-line arguments:

  • -apikey: Your Jeleo API Key
  • -url: Base URL for the Jeleo API (default: https://www.jeleo.zone.id/api/geolocation)

Building and Running Locally

The server runs on standard input/output (stdio), which is standard for MCP. It's designed to be run as an executable or via Docker.

Using Docker (Recommended for Registry)

To build the Docker image:

docker build -t geolocation-mcp .

To run it locally via Docker:


View the full README on GitHub

Details

Repository
github.com/wtronk/geolocation-mcp
Package
ghcr.io/wtronk/geolocation-mcp:v1.0.0
Transport
STDIO
Auth
Required
Registry
MCP registry, active