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.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

ego lite browser

Fastest browser for AI agents to run web automation tasks, always free.

Download Free life-time →

CodeHealth MCP Server

Protect your code quality, stop the AI slop.

Try For Free →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

Open Steps

Free an open-source skills that make AI coding agents easier to understand, verify, and control.

Download for free →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Agent, connect blockchain

Connect your Claude agent to live crypto prices and trading routes via 1inch

Get the MCP →

Granola, the best AI meeting recorder

Notes, actions and memory. Without a meeting bot. First month 100% off.

Download for free →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

ego lite browser

Fastest browser for AI agents to run web automation tasks, always free.

Download Free life-time →

CodeHealth MCP Server

Protect your code quality, stop the AI slop.

Try For Free →

belt - the only tool your agent needs

belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...

one prompt install →

Open Steps

Free an open-source skills that make AI coding agents easier to understand, verify, and control.

Download for free →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Agent, connect blockchain

Connect your Claude agent to live crypto prices and trading routes via 1inch

Get the MCP →

Granola, the best AI meeting recorder

Notes, actions and memory. Without a meeting bot. First month 100% off.

Download for free →

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