AI AGENT 1-STEP CONNECT · NO SIGN-UP · DAILY 90-MIN FREE TRIAL

Send One Prompt to Your AI AgentLet It Connect to YIVPN

Last updated:
yivpn.net/api/v1/vpn · yivpn-agent-cli v2.2 NO SIGN-UP · DAILY 90-MIN FREE TRIAL
👇 Copy & paste this prompt into your AI Agent to connect to YIVPN

Supports Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen — your agent configures itself, claims the free 90-min trial, and connects automatically.

Read https://yivpn.net/vpn-api/llms.txt and auto-connect this environment to YIVPN (claim the free 90-min trial if needed).
VISUAL CONTROL · WHAT YOUR AI CAN DECIDE

Once Connected, Your AI Controls These 4 Things

01 · WHICH NODE

Pick Regions & Fastest Exit Nodes

Ask your agent to benchmark latency and switch exits across Japan, Singapore, Hong Kong, or the US in one sentence.

JPTokyo · JP 38 ms
HKHong Kong 24 ms
SGSingapore 52 ms
USUnited States 108 ms
02 · HOW TO SPLIT TRAFFIC

Keep LAN/SSH Direct · Tunnel Global APIs

Rootless proxy never touches cloud VM default routes — internal DBs and SSH stay direct while external requests use YIVPN.

Internal DB / Private VPC / SSH ⚡ Stay Direct
Claude / GitHub / Global Web 🛡️ Via YIVPN
03 · DNS SAFETY & AD BLOCK

Malware Shield & Ad-Free Scraping

Toggle tunnel-level Cloudflare Security DoH and ad-tracker blocking to protect headless browsers and speed up page loads.

✓ Malware & Phishing Block ON ✓ Ad-Tracker Filter ON ○ Family Safe DNS
04 · HEALTH & QUOTA

Dual-Path Diagnostics & Instant Top-Up

Compare direct vs. tunneled latency and exit IP anytime, check remaining free trial minutes, or generate a zero-account checkout link.

✓ Live Exit IP Check ✓ Free 90m / 1 GiB Trial ✓ Up to 5 Sandboxes
ZERO CODE NEEDED · JUST ASK IN PLAIN LANGUAGE

Skip the Code — Just Say This to Your AI Agent

Click Copy on any card below and paste into Claude Code / Codex / Cursor / OpenClaw / DeepSeek Harness / Doubao Work / Qwen.

🌏 Switch Exit Country
What You Say

“Benchmark latency and switch my YIVPN proxy exit to the fastest Japan node, then confirm the new exit IP.”

What AI Does: Switches region to JP, reloads local proxy, and verifies exit IP
🔀 Smart Split Routing
What You Say

“Enable smart split so internal databases and local networks stay direct while external APIs go through YIVPN.”

What AI Does: Enables smart_split without touching host default routes or SSH
💻 Route CLI Tools via VPN
What You Say

“Configure curl, git, and Python in this session to route through my local YIVPN proxy and test connectivity.”

What AI Does: Wires 127.0.0.1:10808 proxy env vars and runs live HTTPS check
🛡️ Block Malware & Ads
What You Say

“Turn on malware/phishing protection and ad-blocking on my YIVPN tunnel for cleaner headless browsing.”

What AI Does: Activates Cloudflare Security DoH + ad-tracker filter rules
🩺 Diagnose Slow Requests
What You Say

“Check my YIVPN tunnel health and compare direct vs. proxied latency right now.”

What AI Does: Runs dual-path probe and reports latency + exit location
⏱️ Check Trial or Upgrade
What You Say

“Check how much time is left on my free YIVPN trial, or get a link to unlock all US/JP/SG/HK nodes.”

What AI Does: Shows remaining quota or generates a zero-account checkout URL

Four-Step Account-less Provisioning

Consumer VPNs assume a human clicking through email verification and kernel network dialogs. The YIVPN Agent API (https://yivpn.net/api/v1/vpn) replaces accounts and dashboards with pure HTTP and ed25519-v1 request signing.

  • 1. Generate Key Locally: Mint a 32-byte Ed25519 keypair inside your sandbox. Your private key never leaves disk; the 64-char hex public key is your identity.
  • 2. Claim $0 Trial or Fund via Checkout / x402: Claim an instant 90-minute / 1 GiB free trial (rail: "trial", works directly or behind existing proxies & cloud sandboxes), or unlock 4 global regions via Stripe / Apple Pay / Alipay (rail: "checkout") or HTTP 402 Base USDC (rail: "x402").
  • 3. Fetch Signed Config: Sign the request path and Unix timestamp to call GET /api/v1/vpn/config?mode=proxy.
  • 4. Run Rootless Proxy: Launch sing-box on 127.0.0.1:10808 (mixed HTTP + SOCKS5) — zero CAP_NET_ADMIN needed and zero risk of severing cloud SSH.

Engineered Beyond Bare WireGuard APIs

Traditional WireGuard APIs require root kernel interfaces that hijack the VM default route (killing SSH and orchestrator heartbeats) and fail on restricted networks where UDP WireGuard handshakes are throttled or blocked.

CapabilityYIVPN Agent APIBare WireGuard APIs
Cloud SSH & Container SafetyDefault rootless proxy on 127.0.0.1:10808 (never drops SSH); optional L3 TUN modeRequires root / CAP_NET_ADMIN; overwrites default route and drops SSH
Censorship ResistanceHysteria2 (QUIC/UDP 443) + VLESS+REALITY (TLS 1.3/TCP 443)Plain UDP WireGuard easily fingerprinted and blocked by DPI
Multi-Region Exit MeshUS, Japan (JP), Singapore (SG), and Hong Kong (HK) with URL-test failoverSingle-region static peer per config file
Cryptographic LifecycleStateless ed25519-v1 signatures, atomic /rotate, and instant DELETE revocationStatic pre-shared keys without request replay protection

Programmable DNS Guardrails & Transparent Pricing

Agents can update tunnel-level DNS filtering on the fly via signed PUT /api/v1/vpn/settings, while paying the exact same transparent rates as YiPro:

Guardrail / TermMechanism / Price (USD)Agent Use Case
guardrails: malware (Default)Cloudflare Security DoH (1.1.1.2) + phishing rule-set blockBlocks malware, C2 endpoints, and phishing domains inside agent browsers
guardrails: ads / adultFull ad-tracker reject rule-set / Family DoH (1.1.1.3)Strips ad bloat from headless DOM trees and enforces family-safe browsing
guardrails: smart_splitPrivate RFC1918 + regional direct bypass; global traffic tunneledKeeps internal VPC/database traffic direct while routing external APIs via VPN
Free Trial (rail: "trial")$0 (90 Min / 1 GiB cap · 24h cooldown)Instant card-free US-Ohio tunnel (works directly or behind existing proxies & cloud sandboxes)
API Terms (Up to 5 Sandboxes)1 Mo $2.99 · 3 Mo $6.99 · 6 Mo $12.99 · 12 Mo $21.99Unlocks US/JP/SG/HK full-speed exits across up to 5 concurrent sandboxes per key
Machine-readable specs: /vpn-api/llms.txt · OpenAPI 3.1 YAML · Official MIT CLI & Skill: yivpn-official/yivpn-agent-cli.

FAQ

Can AI agents try the VPN API for free — even behind an existing proxy?

Yes. Just send the prompt at the top of this page to your AI Agent (or run npx --yes github:yivpn-official/yivpn-agent-cli connect --auto-trial) for an instant $0 90-minute / 1 GiB US-Ohio session (1 claim per 24 hours per device, zero card required, and fully compatible with existing proxies, VPNs, and cloud sandboxes).

Do humans or agents need to download the YIVPN desktop or mobile app?

No. The entire lifecycle runs over HTTPS REST endpoints and standard open-source sing-box binaries — zero GUI, zero email, and zero app installation.

Will starting the tunnel disconnect my SSH session or container health checks?

Never in default mode=proxy. It binds strictly to 127.0.0.1:10808 (HTTP + SOCKS5) without touching kernel routing tables or requiring root privileges.

What if a sandbox environment is compromised and I need to rotate keys?

Call signed POST /api/v1/vpn/rotate to atomically move remaining subscription time to a fresh Ed25519 public key, or DELETE /api/v1/vpn/entitlements to revoke immediately.

Which payment rails are supported?

Zero-account Hosted Checkout (Visa, Mastercard, Apple Pay, Alipay) is live today, alongside built-in HTTP 402 (x402 v2) Base USDC settlement support.

How do Desktop Local MCP and the Cloud VPN API work together under one command?

Running npx --yes github:yivpn-official/yivpn-agent-cli mcp (v2.2) automatically detects your environment: on headless servers, Docker containers, or machines without the app, it operates in zero-account Cloud mode and manages a rootless 127.0.0.1:10808 sing-box proxy daemon via connect_vpn / disconnect_vpn. When YIVPN Desktop (Windows or macOS) has Local MCP active on 127.0.0.1:38410, the same command seamlessly bridges to the desktop kernel for OS-level TUN split-tunnel preview_routing_rules, apply_routing_rules, and rollback_routing_rules.

Start with 90 Minutes Free Every Day — Zero Sign-Up Required

Download YIVPN v1.0.6 with bundled offline sing-box core and Smart Split routing for Windows, macOS, and Android.

Download Official Apps → Compare Plans & Pricing