# VPNDetection

Classify an IP address or a list for VPN, proxy, Tor, hosting, and CDN signals. The server also reports database and license details.

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

## What it does

VPNDetection gives an agent read-only tools to classify IP addresses and inspect database access. It can process a single address or a list, splitting long lists into batches. Database files cannot be fetched through these tools.

Each lookup includes `coverage`, which identifies the fields returned under the current plan. A missing field is not a negative finding. That distinction matters when an agent interprets the result. There is no `my_ip` tool: with a hosted connection, the server sees the intermediary's address rather than the user's. Local use requires Node.js 22 or newer. Without an API key, lookups return only `ip` and `is_vpn`; additional fields depend on the key and plan.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.vpndetection.io/mcp`
- Environment variables: `VPNDETECTION_API_KEY`, `VPNDETECTION_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.vpndetection.io/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env VPNDETECTION_API_KEY=<VPNDETECTION_API_KEY> --env VPNDETECTION_BASE_URL=<VPNDETECTION_BASE_URL> --transport stdio vpndetection -- npx -y vpndetection-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add vpndetection --url https://mcp.vpndetection.io/mcp
```

2. **Platform CLI**
```bash
codex mcp add vpndetection --env VPNDETECTION_API_KEY=<VPNDETECTION_API_KEY> --env VPNDETECTION_BASE_URL=<VPNDETECTION_BASE_URL> -- npx -y vpndetection-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vpndetection": {
            "url": "https://mcp.vpndetection.io/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vpndetection": {
            "command": "npx",
            "args": [
                "-y",
                "vpndetection-mcp"
            ],
            "env": {
                "VPNDETECTION_API_KEY": "<VPNDETECTION_API_KEY>",
                "VPNDETECTION_BASE_URL": "<VPNDETECTION_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vpndetection": {
            "type": "http",
            "url": "https://mcp.vpndetection.io/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vpndetection": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "vpndetection-mcp"
            ],
            "env": {
                "VPNDETECTION_API_KEY": "<VPNDETECTION_API_KEY>",
                "VPNDETECTION_BASE_URL": "<VPNDETECTION_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http vpndetection https://mcp.vpndetection.io/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e VPNDETECTION_API_KEY=<VPNDETECTION_API_KEY> -e VPNDETECTION_BASE_URL=<VPNDETECTION_BASE_URL> vpndetection npx -y vpndetection-mcp
```
Replace <…> with your own values

## When to use it
- check whether an IP belongs to a VPN or proxy
- classify a list of addresses in one request
- inspect the fields available to an API key
- check an organization's database license status

## Example prompts
- Check `203.0.113.10` for VPN and proxy classification.
- Classify these IP addresses and return a result for each one.
- Show the fields my key can access and the database license statuses.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [mcp](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — MCP server · ★ 12110
- [Robin: AI-Powered Dark Web OSINT](https://affpapa.org/en/nevibecode/mcp/robin-ai-powered-dark-web-osint.md) — MCP server · ★ 7718
- [jshookmcp](https://affpapa.org/en/nevibecode/mcp/jshookmcp.md) — MCP server · ★ 2066
- [OpenOSINT](https://affpapa.org/en/nevibecode/mcp/openosint.md) — MCP server · ★ 1816

---
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