Skip to main content
Glama
7mza

geolocation-mcp

by 7mza

GeoLocation MCP Server

Coverage

Fast and up-to-date IP geolocation data for LLMs

demo

For public IPv4 / IPv6 address:

  • Flags: isDatacenter, isTorExitNode, isVPN

  • City name, region ISO code, latitude/longitude, accuracy radius, postal code, timezone

  • Country name, ISO code, EU membership/GDPR

  • ASN number, ISP/organization name, network CIDR

MCP tools

Tool

Description

getGeoLocationData

single IP lookup

getGeoLocationDataBulk

batch lookup, failed IPs don't block the rest

Related MCP server: mcp-ipinfo

Data sources

Data

Source

Refresh

City / ASN

GeoLite2 via P3TERX/GeoLite.mmdb

on startup if absent

Tor exit nodes

Tor Project

daily

VPN / Datacenter ranges

X4BNet/lists_vpn

daily

Usage

# named volume so DBs persist across restarts
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

or with compose

services:
  geolocation-mcp:
    image: 7mza/geolocation-mcp:latest
    ports:
      - '8891:8080'
    restart: unless-stopped
    volumes:
      - geolocation_data:/home/nonroot/.geolocation-mcp
volumes:
  geolocation_data:
    name: geolocation_data

Connect your LLM:

# example for claude
claude mcp add --transport http geolocation http://localhost:8891/mcp

Test with MCP inspector:

npm i && npm run mcp
# transport: streamable
# url: http://localhost:8891/mcp

Build from source

Requires SDKMAN and nvm.

nvm use && npm i && sdk env install

JVM:

./gradlew clean ktlintFormat ktlintCheck build
./gradlew bootRun

Native:

./gradlew clean ktlintFormat ktlintCheck build -PgenerateMetadata
./gradlew buildImage
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

License

GeoLite2 DBs are subject to the GeoLite2 EULA.

A
license - permissive license
-
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
Release cycle
1Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/7mza/geolocation-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server