Codex
Use VPNDetection in Codex: the CLI, the IDE extension and the ChatGPT desktop app.
Codex 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.
Install the plugin
The VPNDetection plugin adds the server with skills for checking addresses, screening a signup or order export, and working with the databases:
codex plugin marketplace add vpndetection-io/openai-plugin
codex plugin add vpndetection@vpndetection
codex mcp login vpndetectionThe last line opens your browser: sign in, pick which of your organization's API keys Codex uses, and approve. The Codex CLI, its IDE extension and Codex in the ChatGPT desktop app read the same configuration, so one install covers all three. Once it's connected, ask something like "Is 45.83.91.1 a VPN?".
To add the server alone, without the skills:
codex mcp add vpndetection --url https://mcp.vpndetection.io/mcp
codex mcp login vpndetectionWhat 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 Codex analyzes a downloaded copy. |
Your API key
Codex never sees the key. Our server uses it on your behalf, so every call counts against that key's plan. Approving needs permission to share your organization's API keys, and asks you to confirm it's you. To disconnect, run codex mcp logout vpndetection, or remove it in the console under Settings > Sessions & devices > Connected applications; access ends within about a minute.
To send a key yourself instead of signing in, keep it in an environment variable and add the server with --bearer-token-env-var VPNDETECTION_API_KEY. On the OpenAI API, the Responses API's mcp tool takes https://mcp.vpndetection.io/mcp as its server_url and the key as its authorization.
Every other MCP client, and what each tool answers: MCP Server.