Ip2location IO MCP Server

by ip2locationio.github.ip2location/mcp-ip2location-iov1.1.1

IP Geolocation MCP server that query the geolocation information using IP2Location.io API.

16Pythonstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Ip2location IO MCP server

claude mcp add ip2location-io -e IP2LOCATION_API_KEY='<ip2location-api-key>' -- uvx mcp-ip2location-io

{
  "mcpServers": {
    "ip2location-io": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<ip2location-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "ip2location-io": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<ip2location-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "ip2location-io": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<ip2location-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "ip2location-io": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<ip2location-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
IP2LOCATION_API_KEY	yes	yes	Your IP2Location.io API key for detailed geolocation information.

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
2026-09-29 · 10d ago · GitHub · 1.1.2
Package published
no data · npm/PyPI
Registry entry updated
2026-05-26 · 5mo ago · official registry · v1.1.1

FAQ

›How do I install the Ip2location IO MCP server in Claude Code?

Run: claude mcp add ip2location-io -e IP2LOCATION_API_KEY='<ip2location-api-key>' -- uvx mcp-ip2location-io. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Ip2location IO require an API key?

Yes. It expects IP2LOCATION_API_KEY, of which 1 is a secret.

›Can I use Ip2location IO as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Ip2location IO in the official MCP registry?

Yes, as io.github.ip2location/mcp-ip2location-io.