# VPNDetection

> VPNDetection is a freemium MCP server for security. Look up whether an IP address is a VPN, proxy, Tor node, hosting range or CDN. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://vpndetection.io
- **Repository:** https://github.com/vpndetection-io/mcp
- **MCP Registry name:** io.vpndetection/mcp
- **Categories:** security
- **Listing updated:** 2026-11-14

## About

VPNDetection backs its flags with evidence rather than a bare yes or no. According to the site, each address is classified from four kinds of proof: a scan where the VPN's own protocol answered, a provider-published address, registry records, and inference. On a paid plan a flag comes with the operator behind it, the last day the address was seen in that role and a confidence level.

The server has seven read-only tools. They classify one address or a whole list, and also report the database catalog and where your organization's license for each stands. Coverage runs from VPNs and residential, datacenter, mobile and public proxies to Tor nodes, privacy relays, hosting providers and CDNs.

The free Unlimited plan has no daily or monthly cap and needs no key, though it returns fewer fields. Paid plans add hosting, CDN and proxy flags, provider names and confidence. The hosted endpoint signs in with a VPNDetection account, and the npm package runs locally on Node.js 22 or newer.

## Features

- **Anonymity flags:** Reports VPN, residential, datacenter, mobile and public proxy, Tor, relay, hosting and CDN.
- **Evidence behind flags:** Paid plans add operator, last-seen date and confidence.
- **Batch lookups:** Classifies a list of addresses in one call; larger lists on paid plans.
- **Database catalog:** Lists the downloadable databases and your license status for each.
- **Free tier:** Unlimited lookups without a key, with fewer fields.
- **Several clients:** Works with Claude, ChatGPT, Codex, Gemini CLI and other MCP clients.

## Good for

- Flag risky sign-ups from VPN or proxy addresses
- Tell a hosting range from a residential connection
- Review a list of IPs from server logs
- Check which databases your plan covers
- Add IP risk context to a fraud review

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.vpndetection.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.vpndetection.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.vpndetection.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.vpndetection.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.vpndetection.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.vpndetection.io/mcp"
    }
  }
}
```

## Tools

- `lookup_ip`: Classifies one IP address.
- `lookup_ips`: Classifies a list of addresses in one call.

## FAQ

### Do I need an API key?

No. The free Unlimited plan answers without a key, with no daily or monthly cap, but fewer fields.

### What does a paid plan add?

Hosting, CDN and proxy flags plus provider, confidence and last-seen detail.

### How do I sign in to the hosted server?

With your VPNDetection account, so the assistant never sees your API key.

### What Node.js version does the package need?

Node.js 22 or newer.

### Is VPNDetection free?

VPNDetection has a free plan, with paid plans for more usage or features.

### How do I add VPNDetection to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.vpndetection.io/mcp

### What are the best alternatives to VPNDetection?

The closest alternatives to VPNDetection are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/vpndetection
