MCP

Geolocation Mcp

7mza/geolocation-mcp

HTTPregistry active

Summary

Connects to MaxMind's GeoLite2 databases and live threat intelligence feeds to give Claude two tools for IP geolocation lookups. The single lookup returns city, coordinates, timezone, ASN details, and flags for datacenters, Tor exit nodes, and VPNs. The bulk lookup handles multiple IPs without failing on bad input. Data refreshes daily from Tor Project and X4BNet's VPN lists. Runs as a Docker container with persistent storage for the geolocation databases. Reach for this when you need Claude to analyze IP addresses for security investigations, traffic analysis, or compliance checks where knowing if an IP is from a datacenter or VPN matters.

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Monitor with ease. Code with confidence.

Start Free Trial →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

Put your SEO on autopilot

An agent that runs the SEO playbooks that move rankings and ships PRs you control.

Get founding access →

Vibe Prospecting MCP

Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.

Try For Free →

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Monitor with ease. Code with confidence.

Start Free Trial →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

Put your SEO on autopilot

An agent that runs the SEO playbooks that move rankings and ships PRs you control.

Get founding access →

Vibe Prospecting MCP

Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.

Try For Free →

Featured

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Monitor with ease. Code with confidence.

Start Free Trial →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

Put your SEO on autopilot

An agent that runs the SEO playbooks that move rankings and ships PRs you control.

Get founding access →

Vibe Prospecting MCP

Connect Claude to +800M contacts, +150M companies. Find & Enrich leads in chat.

Try For Free →

Categories

Data & Analytics

Registryactive

Package7mza/geolocation-mcp:0.0.1

TransportHTTP

UpdatedJun 9, 2026

GeoLocation MCP Server

Coverage

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

Demo

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

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.