JSON VPN CLI

VPN output your tools can parse.

Free VPN CLI is designed so tools do not need to scrape terminal text. Use --json for status, regions, service presets, connection attempts, and doctor diagnostics, then parse output with jq, Python, Node.js, PowerShell, CI jobs, or coding agents.

Read JSON workflow Download CLI

--json jq Python PowerShell

Works with

Claude

Cursor

Codex

OpenClaw

Hermes+ any MCP tool

json output

$ freevpn status --json

$ freevpn regions --json

$ freevpn doctor --json

# parse JSON structurally; do not scrape text

#1 Free VPN

App Store · Play Store · Mac

100M+

Installs worldwide

10+ yrs

Battle-tested VPN core

1,000+

Servers · global exits

JSON setup

Use --json wherever another tool reads output.

SKILL.md works with Claude, Cursor, Codex, OpenClaw, Hermes, and any MCP tool and is explicit: prefer JSON for anything you parse and never scrape human terminal text.

JSON-first commands

Start with status, regions, and doctor. Inspect shape with general parsers without assuming undocumented fields.

Paste in Terminal

$freevpn status --json

$freevpn regions --json

$freevpn doctor --json

Parsing rules

Use jq . to inspect shape while developing.
Do not invent or depend on undocumented field names in public examples.
Use ConvertFrom-Json in PowerShell.
Use doctor output for troubleshooting evidence.

Parsers

Parse VPN output with common tools.

Keep examples structural and avoid relying on undocumented schema fields.

jq

Pipe status, regions, or doctor output to jq . while developing scripts.

Python

Use Python JSON tooling to validate and inspect output files.

Node.js

Parse command output in Node scripts when coordinating test flows.

PowerShell

Use ConvertFrom-Json for Windows automation.

How it works

up. status. down.

Three verbs cover most day-to-day VPN work. set-region and doctor cover region selection and troubleshooting.

1 Check where you are · connect

freevpn status · up

user@shell $ freevpn status

VPN : disconnected

region : Fastest (auto)

your IP : 122.179.8.116

location : Bengaluru, India

user@shell $ freevpn up

Connected to Fastest (auto)

your IP : 85.195.125.198

location: Frankfurt, Germany

2 Switch region · verify · disconnect

freevpn set-region · status · down

user@shell $ freevpn set-region "US East"

Switched to US East

user@shell $ freevpn status

VPN : connected

region : US East

your IP : 23.108.55.113

location : Miami, United States

user@shell $ freevpn down

tunnel down · routes restored

JSON workflow

Inspect shape, then automate carefully.

Use JSON output as the contract for tools, but keep public examples conservative unless a field is documented.

Paste in Terminal

$freevpn status --json | jq .

$freevpn doctor --json > status.json

$python3 -m json.tool status.json

$freevpn status --json | ConvertFrom-Json

Command	Why it matters
`freevpn status --json`	Best first check for current VPN state.
`freevpn regions --json`	List available region choices structurally.
`freevpn doctor --json`	Get diagnostic evidence for troubleshooting.
`jq .`	Inspect JSON shape while developing scripts.
`ConvertFrom-Json`	Parse CLI output in PowerShell workflows.

Features

Machine-readable VPN features.

The JSON page goes deep on structured output because it is the foundation for automation and agents.

JSON on every command

SKILL.md works with Claude, Cursor, Codex, OpenClaw, Hermes, and any MCP tool and says every command accepts JSON output.

No text scraping

Avoid brittle parsing of human terminal output.

Doctor diagnostics

Capture structured network diagnostics when something fails.

Region discovery

Use region output before choosing a slug or label.

Agent-friendly

Agents can read structured state before acting.

Script-friendly

Works with jq, Python, Node.js, PowerShell, CI logs, and automation scripts.

Service presets

Use service presets without scraping the app UI.

SKILL.md documents freevpn services so agents can list service categories, inspect the current preset, or choose Off and General without reading screenshots. Non-default service presets are paid and return license_required for free users.

freevpn services list shows supported service presets.
freevpn services categories groups presets such as Streaming, Sports, Social, AI, and Other where available.
freevpn services current prints the current preset name on one line.
freevpn services --json is the safest form for scripts and agents.

Paste in Terminal

$freevpn services list

$freevpn services categories

$freevpn services current

$freevpn services --json

Practical notes

JSON usage notes.

Use JSON output as a stable machine interface, but keep examples honest.

Do not invent exact schema fields unless SKILL.md or CLI docs confirm them.
Use jq . for exploratory inspection.
Use ConvertFrom-Json in PowerShell workflows.
Use status --json before region or connection changes.

FAQ

VPN with JSON output FAQ.

Does every command support --json?

SKILL.md says every command accepts --json and returns a stable schema.

Which command should I start with?

freevpn status --json is the best first check.

Can I parse it with jq?

Yes. Pipe command output to jq . while developing scripts.

Can PowerShell parse it?

Yes. Use ConvertFrom-Json with commands such as freevpn status --json.

Should I scrape normal text output?

No. SKILL.md explicitly says never scrape human text output when parsing.

Use VPN output your tools can parse.

Start with status --json, add regions --json for selection, and use doctor --json for diagnostics.

Read JSON workflow Download CLI