Skip to content

Latest commit

 

History

38 Commits

Folders and files

Repository files navigation

VPNDetection VPNDetection Claude Plugin

version license

The official VPNDetection plugin for Claude.

Ask Claude whether an IP address belongs to a VPN, a residential, datacenter, mobile or public proxy, a Tor node, a privacy relay or web gateway, a hosting provider or a CDN; whether it is anycast, or a mobile carrier's or satellite operator's space; whether an SSH, mail or web server or an open DNS resolver answered on it, or a BitTorrent client was seen on it; and look into any of the VPNDetection databases and which ones your organization holds. It works in Claude on the web, desktop and mobile, in Cowork and in Claude Code.

Getting Started

On claude.ai, in the desktop app or in Cowork, add VPNDetection from Claude's directory and connect it.

In Claude Code:

/plugin marketplace add vpndetection-io/claude-plugin
/plugin install vpndetection@vpndetection

The first time a tool runs, you'll be asked to sign in with your VPNDetection account and pick the API key Claude should use. Claude never sees the key: our MCP server uses it on your behalf, and requests count against that key's plan like any other API call. The database tools need a key with the db.download scope, which your organization's Default key has. You need a VPNDetection account for this, but no paid plan: without one, every lookup returns ip and is_vpn with Tor and relay detection, whether it is anycast, its reverse DNS name, where the address is and the network that announces it, and the account's trial returns every field.

To disconnect Claude, remove it under Connected applications at https://app.vpndetection.io/settings/account/sessions. Access ends within about a minute.

What's in it

  • The VPNDetection MCP server at https://mcp.vpndetection.io/mcp, with seven read-only tools: lookup_ip, lookup_ips, my_entitlement, list_databases, database_metadata, database_checksum and list_downloads.
  • Four skills that tell Claude how to use them well:
    • 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.

Try it

  • "Is 45.83.91.1 a VPN?"
  • "Here's yesterday's signup export. Which accounts came from proxies or Tor?"
  • "Which databases are we licensed for, and how big is the latest VPN build?"

What it sends

The plugin runs nothing on your machine. Claude sends the IP addresses and database IDs you ask about to https://mcp.vpndetection.io/mcp, which calls the VPNDetection API with the key you picked and returns the answer. Each request is logged against that key as any API call is. Our privacy policy is at https://vpndetection.io/privacy, and questions go to support@vpndetection.io.

Other Libraries

There are official VPNDetection client libraries available for many languages including PHP, Python, Go, Java, Ruby, and many popular frameworks such as Django, Rails, and Laravel. See our GitHub at https://github.com/vpndetection-io for more.

About VPNDetection

VPN Detection API: Accurate anonymity detection identifying VPNs, residential proxies, hosting servers, Tor nodes, CDNs, relays and more.

VPNDetection

License

This project is licensed under the MIT License.