VPNDetection — Claude Code MCP server: IP checks and setup
Classify an IP address or a list for VPN, proxy, Tor, hosting, and CDN signals. The server also reports database and license details.
claude mcp add --transport http mcp https://mcp.vpndetection.io/mcpWhat VPNDetection 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.
What it helps with
- 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 for the agent
- Check
203.0.113.10for 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.
How to install VPNDetection
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.vpndetection.io/mcp2Platform CLI
claude mcp add --env VPNDETECTION_API_KEY=<VPNDETECTION_API_KEY> --env VPNDETECTION_BASE_URL=<VPNDETECTION_BASE_URL> --transport stdio vpndetection -- npx -y vpndetection-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add vpndetection --url https://mcp.vpndetection.io/mcp2Platform CLI
codex mcp add vpndetection --env VPNDETECTION_API_KEY=<VPNDETECTION_API_KEY> --env VPNDETECTION_BASE_URL=<VPNDETECTION_BASE_URL> -- npx -y vpndetection-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"vpndetection": {
"url": "https://mcp.vpndetection.io/mcp"
}
}
}{
"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
Config file
{
"servers": {
"vpndetection": {
"type": "http",
"url": "https://mcp.vpndetection.io/mcp"
}
}
}{
"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
1Platform CLI: remote server
gemini mcp add -t http vpndetection https://mcp.vpndetection.io/mcp2Platform CLI
gemini mcp add -e VPNDETECTION_API_KEY=<VPNDETECTION_API_KEY> -e VPNDETECTION_BASE_URL=<VPNDETECTION_BASE_URL> vpndetection npx -y vpndetection-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VPNDetection
How do I install VPNDetection in Claude Code?
Add the hosted MCP server with claude mcp add --transport http mcp https://mcp.vpndetection.io/mcp. Sign in with your VPNDetection account.
What does VPNDetection do?
It classifies IP addresses for VPN, proxy, Tor, hosting, and CDN indicators. It can also report database details and an organization's access status.
Can I use VPNDetection without an API key?
A local server without a key returns ip and is_vpn. Further fields require a key and depend on its plan.
