# geolocation-mcp [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/wtronk/geolocation-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/geolocation-mcp-2

## Description
Geolocation tools (reverse geocoding, ip lookup, etc) using Jeleo Geolocation API

## Tools
Capabilities this server exposes over MCP:

- **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.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "geolocation-mcp": {
    "url": "https://jeleo.zone.id/](https://jeleo.zone.id/"
  }
}
```

## Documentation & 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/](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:

```sh
docker build -t geolocation-mcp .
```

To run it locally via Docker:

```sh
docker run -i --rm geolocation-mcp -apikey YOUR_API_KEY
```

### Direct Execution

If you have Go installed, you can build and run it directly:

```sh
go build -o geolocation-mcp main.go
./geolocation-mcp -apikey YOUR_API_KEY
```

## Adding to an MCP Client (e.g. Claude Desktop)

If you have published the image to a container registry, or just using it locally, add it to your `claude_desktop_config.json`:

**Local Docker:**
```json
{
  "mcpServers": {
    "geolocation": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "geolocation-mcp", "-apikey", "YOUR_API_KEY", "-url", "https://www.jeleo.zone.id/api/geolocation"]
    }
  }
}
```