IP Geolocation MCP Server

An MCP (Model Context Protocol) server that provides IP geolocation data using ipinfo.io (free tier — no API key required, 50,000 lookups/month).

Tools

ip_lookup(ip)

Look up geolocation data for a specific IP address.

Parameters:

Returns: city, region, country, org (ISP), timezone, postal code, latitude, longitude.

ip_lookup_own()

Get geolocation data for your own public IP address. No arguments needed.

ip_batch(ips)

Batch lookup up to 10 IP addresses at once.

Parameters:

Returns: Array of geolocation objects, one per IP.

Usage

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ip-geolocation": {
      "command": "python",
      "args": ["path/to/server.py"],
      "env": {}
    }
  }
}

Or via uv (recommended for dependency management):

{
  "mcpServers": {
    "ip-geolocation": {
      "command": "uv",
      "args": [
        "--directory", "path/to/ip-geolocation-mcp",
        "run", "server.py"
      ]
    }
  }
}

Any MCP Client

pip install -r requirements.txt
python server.py

Pricing

Subscribe to Pro

Deployment

Smithery

This server is compatible with Smithery.ai. See smithery.yaml for configuration.

Data Fields

Each lookup returns:

License

MIT