Claude
Use VPNDetection in claude.ai, the Claude apps, Cowork and Claude Code.
Claude can check IP addresses, look into any of our databases and tell you which ones your organization holds. It connects to our hosted MCP server, https://mcp.vpndetection.io/mcp, you sign in with your VPNDetection account, and every tool is read-only.
In claude.ai, the desktop app and Cowork
Go to Customize > Connectors, click + Add and choose Add custom connector. Name it VPNDetection, enter https://mcp.vpndetection.io/mcp and click Continue, then Continue again past the authentication settings Claude detected. Under Authentication choose Sign in now, and under OAuth client choose Use Claude's published identity: there's no client ID or secret to enter. Click Add, sign in, pick which of your organization's API keys the connection uses, and approve. To use it in a chat, turn it on under + > Connectors.
On a Team or Enterprise plan an Owner adds it once under Organization settings > Connectors, through Add and Custom > Web, with the same steps. Each member then clicks Connect on it under Customize > Connectors and signs in with their own account.
In Claude Code
Install the VPNDetection plugin. It adds the same server, with skills for checking addresses, screening a signup or order export, and working with the databases:
/plugin marketplace add vpndetection-io/claude-plugin
/plugin install vpndetection@vpndetectionIt asks you to sign in the first time one of its tools runs. To add the server alone, without the skills:
claude mcp add --transport http vpndetection https://mcp.vpndetection.io/mcpThen run /mcp, pick vpndetection and sign in. Once it's connected, ask something like "Is 45.83.91.1 a VPN?".
What the plugin adds
| Skill | What it does |
|---|---|
check-ips | Checks one address or a list, and reads the result's coverage so a field your plan doesn't include is never reported as a "no". |
review-traffic | Screens a signup, login or order export and keeps each verdict next to the record it came from. |
database-files | Answers which databases you hold, how big they are, whether your copy is intact and why a download failed. |
analyze-database | Explains a database's columns and sample rows, and in Claude Code analyzes a downloaded copy. |
Your API key
Claude never sees the key. Our server uses it on your behalf, so every call counts against that key's plan. The database tools need a key with the db.download scope, which your organization's Default key has. Approving needs permission to share your organization's API keys, and asks you to confirm it's you. You can disconnect it at any time from the console, under Settings > Sessions & devices > Connected applications; access ends within about a minute.
Every other MCP client, and what each tool answers: MCP Server.