{"_id":"@dennisk2025/ip-geolocation-lookup","name":"@dennisk2025/ip-geolocation-lookup","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/ip-geolocation-lookup","version":"1.0.0","description":"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.","type":"module","main":"index.js","bin":{"ip-geolocation-lookup":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/ip-geolocation-lookup@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-8yB9fFEH8D4FHFj/LZgQfcmgoEVCJxsUzhFol8ot5i5Dy2UtQP2jcMTaa40u70byRbH8XysdqO6QsIalRDQGmg==","shasum":"6e6aae6c265d8dc6c9acbd42acc6c8bb30404e59","tarball":"https://registry.npmjs.org/@dennisk2025/ip-geolocation-lookup/-/ip-geolocation-lookup-1.0.0.tgz","fileCount":3,"unpackedSize":6291,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDubs4NukyA5gzFxWyAt7HAjwXvupqJSwCCYzzXAxsCzAIhAINT2d8KV3UsTo5uLRE38m68rISll7UOoEQELuIemdgQ"}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/ip-geolocation-lookup_1.0.0_1761427058059_0.46658793419209155"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:17:38.008Z","1.0.0":"2025-10-25T21:17:38.339Z","modified":"2025-10-25T21:17:38.656Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"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.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# ip-geolocation-lookup MCP Server\n\nLooks 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.\n\n---\n\n## Installation\n\n### With npx\n\n    npx @dennisk2025/ip-geolocation-lookup\n\n### Or global/local install\n\n    npm install @dennisk2025/ip-geolocation-lookup\n\n---\n\n## Adding to Claude Desktop\n\nAdd the following to your Claude Desktop config file:\n\n    claude_desktop_config.json\n\n```json\n{\n  \"mcpServers\": {\n    \"ip-geo\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/ip-geolocation-lookup\"]\n    }\n  }\n}\n```\n\nAdd this to your Claude Desktop config file at:\n- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows:** `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n---\n\n## Available Tools\n\n### lookup_ip_location\nReturns the geolocation details for the given IPv4 or IPv6 address. Results include country, region, city, latitude, longitude, timezone, and ISP data where available.\n\n**Input Parameters:**\n- `ip` *(string, required)*: IPv4 or IPv6 address to lookup. You can use `'me'` to fetch the location of the calling client.\n\n**Example tool call:**\n```json\n{\n  \"name\": \"lookup_ip_location\",\n  \"arguments\": {\n    \"ip\": \"8.8.8.8\"\n  }\n}\n```\n\n**Example \"me\" lookup:**\n```json\n{\n  \"name\": \"lookup_ip_location\",\n  \"arguments\": {\n    \"ip\": \"me\"\n  }\n}\n```\n\n**Sample successful result:**\n```json\n{\n  \"ip\": \"8.8.8.8\",\n  \"country\": \"United States\",\n  \"region\": \"California\",\n  \"region_code\": \"CA\",\n  \"city\": \"Mountain View\",\n  \"latitude\": 37.4056,\n  \"longitude\": -122.0775,\n  \"timezone\": \"America/Los_Angeles\",\n  \"isp\": \"Google LLC\"\n}\n```\n\n---\n\n## Error Handling\n- If the IP is invalid or the service is temporarily unavailable, an informative error message will be returned.\n\n---\n\n## Tool Reference\n\n| Tool Name           | Parameters                       | Description                                      |\n|---------------------|----------------------------------|--------------------------------------------------|\n| lookup_ip_location  | ip (string, required)            | Returns the geolocation details for the provided IP|\n\n---\n","readmeFilename":"README.md","_rev":"1-849305c825073e2a0e36e9dd15f75d6c"}