@ipgeolocationapi/mcp

MCP server for ipgeolocationapi.io: IP intelligence as native tools for Claude Desktop, Cursor, and any MCP-compatible AI.

Ask "where is this visitor from, and is the IP a VPN?" and the AI fetches live data directly. No custom code.

Install (30 seconds)

Add to claude_desktop_config.json (Claude Desktop > Settings > Developer):

{
  "mcpServers": {
    "ipgeolocationapi": {
      "command": "npx",
      "args": ["-y", "@ipgeolocationapi/mcp"],
      "env": {
        "IPGEO_API_KEY": "ipa_optional_paid_key"
      }
    }
  }
}

Restart Claude Desktop. Done. The first run creates a small Python runtime (one time); macOS and Linux ship with a compatible Python by default.

Cursor and other MCP hosts: same shape, point the command at this package.

Related MCP server: geolocation-mcp

The 10 tools

Free tier: 5,000 calls/day, no key, no signup. Paid modules (security, company, bulk) need a Business or Max key from the dashboard.

Environment variables

• IPGEO_API_KEY - optional. Unlocks the paid tools.

• IPGEO_BASE - optional. Defaults to https://ipgeolocationapi.io.

• IPGEO_PYTHON - optional. Explicit Python 3.10+ interpreter path.

Plain Python (no npm)

curl -O https://ipgeolocationapi.io/mcp/mcp_server.py
pip install "mcp==1.26.0" httpx
python mcp_server.py

License

MIT. The API terms apply to the data: https://ipgeolocationapi.io/terms