Skip to content
VPNDetection

Gemini CLI

Use VPNDetection in Gemini CLI: our MCP server as an extension, with your API key kept in the system keychain.

See on GitHub
On this page
  1. Install the extension
  2. Your API key
  3. Update or remove it

Gemini CLI can check IP addresses, look into any of our databases and tell you which ones your organization holds. Our extension runs the MCP server from npm on your machine, and every tool is read-only.

Install the extension

console
gemini extensions install https://github.com/vpndetection-io/mcp

It asks for your API key and keeps it in your system keychain. Leave it blank to start without one. The extension starts the server with npx, so you need Node.js 22 or newer. Once it's installed, start gemini and ask something like "Is 45.83.91.1 a VPN?".

Your API key

Lookups answer without a key, with fewer fields, and each result's coverage lists the fields your plan doesn't include. A key on a paid plan answers every field and checks a long list in one call (pricing). The database tools need a key with the db.download scope, which your organization's Default key has.

To set the key or change it later:

console
gemini extensions config vpndetection VPNDETECTION_API_KEY

Set it there even if your shell exports VPNDETECTION_API_KEY: Gemini CLI doesn't pass shell variables named like a key to an extension's server.

Update or remove it

The extension installs from our latest GitHub release. gemini extensions update vpndetection takes a newer one, and gemini extensions uninstall vpndetection removes the extension.

Every other MCP client, and what each tool answers: MCP Server.