vpndetection-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 0 of 2 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y vpndetection-mcp@6.5.2
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
2 tools that take no input and look read-only were called once with nothing. 0 returned a result.
list_databases | No usable answer tool reported an error: { "error": { "kind": "unauthorized", "message": "UNAUTHORIZED", "retryable": false } } |
list_downloads | No usable answer tool reported an error: { "error": { "kind": "unauthorized", "message": "UNAUTHORIZED", "retryable": false } } |
During the calls (not necessarily because of them) it first contacted: api.vpndetection.io.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
lookup_ip ip
Classify a single IPv4 or IPv6 address: whether it 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, with the provider name where we have one. Private and reserved addresses are answered locally, without calling the API. Always read `coverage.note` before concluding anything from a field that is not in the result.
lookup_ips ips
Classify a list of addresses in one call, returning a map keyed by address so duplicates collapse and the order you passed them stops mattering. Pass the whole list rather than splitting it yourself: a long one is batched for you. Prefer this over repeated `lookup_ip` calls when you already have the list, for example when triaging a log file. A batch needs a key on a paid plan: with a key on the free plan, a list of up to 10 addresses is looked up one address at a time instead, and a longer one comes back refused. An address that fails carries its error in place of a result rather than failing the batch. Always read `coverage.note` before concluding anything from a field that is not in the result.
my_entitlement
What this API key is entitled to and how much of it has been used: the plan, the field tier that decides how much of a lookup answer comes back, the requests counted so far, the allowance, and when it resets. Use it to explain why a field is missing from a lookup, or before a large batch. A paid plan's usage counts against the anniversary of the subscription rather than the calendar month; the free plan's counts the lookups its daily trial answered with every field, against the UTC day. Either can lag a few seconds behind. A null `hard_limit` means we never stop serving - it is NOT a limit of zero.
list_databases
The database catalog as this API key's organization may see it, one entry per database FAMILY, with `standing` saying where their license stands: `licensed` if the family is theirs today, `expired` if the term has ended, `unlicensed` if it is published but has never been bought. Each entry has a `base` ID, which is what the license names, and a `versions` array whose `id` is what the other database tools take - pass `versions[].id` (`cdn_ip_v1`), never the `base` (`cdn_ip`). Ask again rather than holding on to this: it is answered per key and is not the same for everyone.
database_metadata dataset_id
What is inside one database before you fetch it: the columns in each published format with their types, a few sample rows, the row count, the build date and the file sizes. Use this to answer questions about what a database contains without downloading it - the files reach several GB - and to budget a transfer before starting one.
database_checksum dataset_id, format
The published digests for one database file, for verifying a copy you already hold or deciding whether a build has changed since you last fetched it. It is licensed like the download itself, so a database this key cannot download is refused here too. Looking up a checksum is not a download and does not appear in `list_downloads`.
list_downloads limit
This organization's own recent download attempts, newest first, REFUSALS INCLUDED - a denial carries the `outcome` and `http_status` that answer "it stopped working", which nothing else here can. Use it to explain a failing fetch, to confirm a transfer ran, or to check whether a request was theirs. This is a bounded WINDOW of at most 200 rows, so a database missing from the answer means it is not in this window - never that it was never downloaded.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22 |
| Source | github.com/vpndetection-io/mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-1ukPdEOHh81cA/i5waRlQYA4yaFVQkFNyDQEnMJzLeSYFB+hVKdb3K/TpRW+sCd6yxo2BQx/jkT4XS7Wvvll0Q== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 6.5.2 | 2026-11-16 | Starts with no setup | 7 |
| 6.4.3 | 2026-11-12 | Starts with no setup | 7 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/vpndetection-mcp)
New version out? Ask for a fresh report.