How do I use geolocation-mcp?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

geolocation-mcp

by 7mza

Overview Schema Source Related Servers Discussions Admin

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

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

mcp-ip-geolocation
io.github.geekmarine
Resolves IP autonomous system numbers (ASN) and geographic coordinates.
Location Services Networking & Infrastructure
1
https://mcp-ip-geolocation.stubby76.workers.dev/mcp
GeoIP
io.github.OlsOls4
IP geolocation: country, continent, ASN and ISP lookup
Location Services Networking & Infrastructure
1
https://geoip-ip-geolocation-asn-isp-lookup.p.rapidapi.com/mcp
IP Country & Network Lookup (DB-IP Lite)A
io.github.pcp183
Look up the country and ASN of IP addresses (DB-IP Lite). $0.001/call via x402.
Location Services Networking & Infrastructure Open Data
1
https://ip-geo-production.up.railway.app/mcp
Ipinfo A
io.github.pipeworx-io
IPInfo MCP — wraps ipinfo.io (free tier, no auth required for basic usage)
Location Services Networking & Infrastructure Search
462
https://gateway.pipeworx.io/ipinfo/mcp

Related MCP Servers

mcp-ipinfo
Location Services Open Data
pipeworx-io
A
license
Not graded
quality
B
maintenance
Provides IP geolocation data via ipinfo.io, enabling querying IP addresses for location, ISP, and other details through natural language.
Updated 3 days ago (2026-11-02 02:56 UTC)
483 npm
MIT
mcp-ip2location
Location Services Security
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.
Updated 5 months ago (2026-06-17 14:55 UTC)
5
MIT
IPRout MCP Server
Networking & Infrastructure Location Services
IProut2026
A
license
A
quality
D
maintenance
Provides GeoIP and ASN intelligence lookup for IP addresses, enabling AI agents to retrieve location and network information via the IPRout API.
Updated 5 months ago (2026-06-18 02:16 UTC)
2
MIT
@ipgeolocationapi/mcp
Location Services Security
thebigasif
A
license
Not graded
quality
B
maintenance
Enables AI assistants to query IP intelligence tools such as geolocation, VPN/security checks, ASN, timezone, astronomy, user-agent parsing, abuse contacts, and bulk lookups via natural language.
Updated 2 months ago (2026-09-11 07:35 UTC)
9 npm
MIT