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

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

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 recent community 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
My IP HelpA
com.myiphelp
IP geolocation, ASN and a 0-100 risk score (VPN, proxy, Tor, datacenter) for any IP address.
Location Services Security
51
https://www.myiphelp.com/mcp/v1
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
11
https://ip-geo-production.up.railway.app/mcp

Related MCP Servers

mcp-ipinfo
Location Services Open Data
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.
Updated 4 days ago (2026-11-09 14:11 UTC)
144 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
C
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)
12 npm
MIT