# IP Geolocation — Country, City, ISP, VPN Detection

IP Geolocation — Country, City, ISP, VPN Detection is an MCP server for Claude Code that checks IP location, ISP, and VPN status for access control and traffic inspection.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 4543 installs
- Author: axel-belfort
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/axel-belfort/ip-geolocation
- Updated: 2026-04-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/ip-geolocation-country-city-isp-vpn-detection

## What it does

This remote server exposes endpoints to inspect IPv4 and IPv6 network records. Query responses yield structured JSON containing coordinates, country code, city, administrative region, timezone, ASN, service provider, alongside flags indicating Tor, proxy, or VPN infrastructure.

Two specific operations are exposed: `ip_lookup_geolocation` handles single lookups, whereas `ip_lookup_geolocation_batch` takes multiple targets up to an upper bound of 20 items per request. It does not inspect domain-level metadata; the author suggests `domain_lookup_intelligence` for hostnames.

You do not configure standard API keys. Instead, transactions rely on x402 micropayments priced at $0.003 per execution on Base L2.

## Requirements
- Remote server: `https://ip-geolocation--axel-belfort.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http ip-geolocation https://ip-geolocation--axel-belfort.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add ip-geolocation-country-city-isp-vpn-detection --url https://ip-geolocation--axel-belfort.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "ip-geolocation-country-city-isp-vpn-detection": {
            "url": "https://ip-geolocation--axel-belfort.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "ip-geolocation-country-city-isp-vpn-detection": {
            "type": "http",
            "url": "https://ip-geolocation--axel-belfort.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http ip-geolocation-country-city-isp-vpn-detection https://ip-geolocation--axel-belfort.run.tools
```

## When to use it
- inspect IPv4 or IPv6 records for country, city, and coordinates
- detect incoming traffic routed through VPNs, proxies, or Tor exit nodes
- process up to 20 client IPs simultaneously to enrich logs
- identify ASN details and ISPs behind suspicious connections

## Example prompts
- Call `ip_lookup_geolocation` on IP `198.51.100.42` to check for active proxy or VPN flags
- Retrieve the timezone, city, and ISP for the IPv6 address `2001:db8::1`
- Pass the IP list from `access.log` to `ip_lookup_geolocation_batch`

## Similar
- [VPNDetection](https://affpapa.org/en/nevibecode/mcp/vpndetection.md) — MCP server · ★ 1 repo stars
- [add-geolocation](https://affpapa.org/en/nevibecode/skills/add-geolocation.md) — skill · ★ 1167 repo stars
- [yourvpndead-vpn-detection](https://affpapa.org/en/nevibecode/skills/yourvpndead-vpn-detection.md) — skill · 479 installs
- [User Agent Parser — Browser, OS, Device Detection](https://affpapa.org/en/nevibecode/mcp/user-agent-parser-browser-os-device-detection.md) — MCP server · 3295 installs
- [Token Holder Analysis — Distribution & Whale Detection](https://affpapa.org/en/nevibecode/mcp/token-holder-analysis-distribution-whale-detection.md) — MCP server · 5218 installs
- [sc-vpn](https://affpapa.org/en/nevibecode/skills/sc-vpn.md) — skill · 146 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
