# mcp-ip2location-io

This MCP server looks up location and network details for IPv4 and IPv6 through IP2Location.io. Use it for log enrichment, traffic checks, or IP investigations.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: ip2location
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ip2location/mcp-ip2location-io
- Updated: 2026-09-29
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-ip2location-io

## What it does

mcp-ip2location-io sends an IP address to IP2Location.io and exposes location data, ASN, ISP, domain, network type, and proxy details. The response depends on the API plan. It accepts both IPv4 and IPv6, and can send several addresses through the Bulk API when that option is available.

The server connects to Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and other MCP clients. Its requests are asynchronous and use `httpx`. A local setup needs Python 3.13 or newer, `uv`, and the `IP2LOCATION_API_KEY` environment variable.

Bulk lookups require an eligible paid plan, so a free or unsupported plan limits that part of the workflow.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `IP2LOCATION_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-ip2location-io -e IP2LOCATION_API_KEY=<IP2LOCATION_API_KEY> -- uvx mcp-ip2location-io
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-ip2location-io <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-ip2location-io --env IP2LOCATION_API_KEY=<IP2LOCATION_API_KEY> -- uvx mcp-ip2location-io
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-ip2location-io <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-ip2location-io": {
            "command": "uvx",
            "args": [
                "mcp-ip2location-io"
            ],
            "env": {
                "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-ip2location-io <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-ip2location-io": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-ip2location-io"
            ],
            "env": {
                "IP2LOCATION_API_KEY": "<IP2LOCATION_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-ip2location-io <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e IP2LOCATION_API_KEY=<IP2LOCATION_API_KEY> mcp-ip2location-io uvx mcp-ip2location-io
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-ip2location-io <command>

## When to use it
- locate an IPv4 or IPv6 address
- identify an IP's ASN and ISP
- inspect an address for proxy signals
- look up several IPs through the Bulk API

## Example prompts
- Find the location of `8.8.8.8`.
- Show the ASN, ISP, and network type for `8.8.8.8`.
- Check these addresses together: `8.8.8.8`, `8.8.6.6`, and `9.9.9.9`.

## Similar
- [geofeed-tuner](https://affpapa.org/en/nevibecode/skills/geofeed-tuner.md) — skill · 1300 installs
- [InternetData](https://affpapa.org/en/nevibecode/mcp/internetdata.md) — MCP server · ★ 1
- [fastah-ip-geo-tools](https://affpapa.org/en/nevibecode/plugins/fastah-ip-geo-tools.md) — plugin · ★ 40451
- [neon-auth](https://affpapa.org/en/nevibecode/skills/neon-auth.md) — skill · 20300 installs
- [supabase-server](https://affpapa.org/en/nevibecode/skills/supabase-server.md) — skill · 9700 installs
- [nosql-injection](https://affpapa.org/en/nevibecode/skills/nosql-injection.md) — skill · 3500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md