vpn-mcp

Connect to a VPN exit node. Starts local proxy. After connecting, use vpn_fetch(url) to make requests through the VPN. If the account is not yet activated, returns payment instructions — show these to the user so they can pay with a TON wallet app. Do NOT open a browser for payment — the payment address is returned directly by this tool.

Disconnect from VPN. Stops the local proxy. WebFetch returns to direct connection.

Switch to a different VPN exit node. Restarts the proxy with the new node.

Check VPN account status: payment state, quota used/remaining, expiry, active node. Use after payment to verify activation before connecting.

List available VPN exit nodes with regions. Requires an active (paid) account.

Activate VPN account. Returns a TON USDT payment address and instructions. Show the address and instructions to the user — they need to send 1 USDT using a TON wallet app (Tonkeeper, TonHub, etc). Payment is detected automatically. Do NOT open a browser — all payment info is returned by this tool. After the user pays, call vpn_status() to check, then vpn_connect() to start.

Fetch a URL through the VPN tunnel. Use this instead of WebFetch when you need the request to come from the VPN exit node IP. Requires vpn_connect() first. Returns status code, headers, and body. This is the safe default — only vpn_fetch requests go through VPN, WebFetch stays direct.

Download and install VPN binary for the current OS. Called automatically by vpn_connect if needed.