Skip to main content
Glama
7mza

geolocation-mcp

by 7mza
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Remote

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: location-mcp

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.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-ipinfo

    pipeworx-io
    A
    license
    Not graded
    quality
    C
    maintenance
    Provides IP geolocation data via ipinfo.io, enabling querying IP addresses for location, ISP, and other details through natural language.
    2 npm
    MIT

  • location-mcp

    atorresg
    A
    license
    A
    quality
    C
    maintenance
    A Model Context Protocol server that enables LLMs to perform IP geolocation, reverse geocoding, and detect the host's public IP without requiring API keys.
    3
    5 npm
    MIT

  • mcp-ip2location

    eweley95
    A
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to perform IP geolocation, proxy detection, and domain WHOIS lookups using IP2Location.io and IP2WHOIS data.
    5
    MIT