@dennisk2025/ip-geolocation-lookup

ip-geolocation-lookup MCP Server

Looks up the approximate geographic location (country, city, latitude, longitude, region) of any IP address using the public ip-api.com API. Great for learning about IPs, or adding location context to data.

Installation

With npx

npx @dennisk2025/ip-geolocation-lookup

Or global/local install

npm install @dennisk2025/ip-geolocation-lookup

Adding to Claude Desktop

Add the following to your Claude Desktop config file:

claude_desktop_config.json

{
  "mcpServers": {
    "ip-geo": {
      "command": "npx",
      "args": ["@dennisk2025/ip-geolocation-lookup"]
    }
  }
}

Add this to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Available Tools

lookup_ip_location

Returns the geolocation details for the given IPv4 or IPv6 address. Results include country, region, city, latitude, longitude, timezone, and ISP data where available.

Input Parameters:

• ip (string, required): IPv4 or IPv6 address to lookup. You can use 'me' to fetch the location of the calling client.

Example tool call:

{
  "name": "lookup_ip_location",
  "arguments": {
    "ip": "8.8.8.8"
  }
}

Example "me" lookup:

{
  "name": "lookup_ip_location",
  "arguments": {
    "ip": "me"
  }
}

Sample successful result:

{
  "ip": "8.8.8.8",
  "country": "United States",
  "region": "California",
  "region_code": "CA",
  "city": "Mountain View",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "timezone": "America/Los_Angeles",
  "isp": "Google LLC"
}

Error Handling

• If the IP is invalid or the service is temporarily unavailable, an informative error message will be returned.

Tool Reference

Tool Name	Parameters	Description
lookup_ip_location	ip (string, required)	Returns the geolocation details for the provided IP