Portveil
Move VPN devices between countries and check protection by asking your assistant
- Pricing
- Freemium
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.4.4
- Listing updated
- 2 days ago
About Portveil
Portveil is a freemium MCP server for security. It runs locally on your machine and is started by your AI client.
Portveil runs one VPN for phones, laptops and the Linux machines where agents run. A device shows as protected only when the exit server confirms it sees that device's tunnel, and this server reports the same. The MCP package lists devices with live speed, locations and plan usage, and, with a control-scope token, moves a device to a country or city, rotates it, schedules rotation every 5 to 10,080 minutes, reconnects or disconnects it. A move is reported only after the exit confirms it.
Tokens have read, control or admin scope, so an agent can be limited to looking. Admin scope adds add_device, update_device and remove_device, with the destructive ones flagged. Every move is recorded in an activity log naming the token. Remote switching works on machines running the Portveil agent, while WireGuard-app devices switch on the device.
WireGuard is standard, device keys are generated on the device, and the site says it keeps no browsing or DNS logs. Spam, attacks, fraud and port 25 mail are not allowed.
Install
Run in a terminal
claude mcp add portveil-mcp --env PORTVEIL_ACCOUNT_ID='<PORTVEIL_ACCOUNT_ID>' --env PORTVEIL_TOKEN='<PORTVEIL_TOKEN>' -- npx -y portveil-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"portveil-mcp": {
"command": "npx",
"args": [
"-y",
"portveil-mcp"
],
"env": {
"PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
"PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"portveil-mcp": {
"command": "npx",
"args": [
"-y",
"portveil-mcp"
],
"env": {
"PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
"PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"portveil-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"portveil-mcp"
],
"env": {
"PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
"PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"portveil-mcp": {
"command": "npx",
"args": [
"-y",
"portveil-mcp"
],
"env": {
"PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
"PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"portveil-mcp": {
"command": "npx",
"args": [
"-y",
"portveil-mcp"
],
"env": {
"PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
"PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
}
}
}
}Configuration
PORTVEIL_ACCOUNT_IDYour Portveil account ID (acct_…), shown in the dashboardRequiredPORTVEIL_TOKENA Portveil API token from the dashboard; control scope to move devices, read to only lookRequiredPORTVEIL_APIAPI base URL (default https://api.portveil.com)
Tools this server provides (14)
Taken from the project documentation; the running server may differ.
- list_devices
- Every device with protection status, exit and speed
- list_locations
- Locations you can move to
- get_device
- One device's state
- get_account
- Plan and device usage
- list_activity
- Recent moves and which token made them
- move_device
- Move a device to a country or city
- rotate_device
- Move to the next location
- start_rotation
- Rotate every N minutes
- stop_rotation
- Turn off scheduled rotation
- reconnect_device
- Re-establish a tunnel
- disconnect_device
- Turn a device's VPN off
- add_device
- Add a device
- update_device
- Rename or toggle remote control
- remove_device
- Remove a device
What it does
- Verified moves
- Success is reported only after the exit confirms the device.
- Scoped tokens
- Read, control or admin access, never the account key.
- Scheduled rotation
- Move a device every N minutes among chosen locations.
- Protection status
- Shows which devices are really protected.
- Activity log
- Records which token did what.
Good for
- Move a scraper machine to another country
- Rotate agent machines to new locations
- List unprotected devices
- Review recent location changes
Pricing
Freemium
Free tier for 2 devices; paid plans for 5, 10 and 25 devices, prices not listed
Prices change. Check portveil.com before you buy.
Portveil FAQ
What plans exist?
Free (2 devices, 25 GB a month), Personal (5), Pro (10) and Builder (25).
Can I make the assistant read-only?
Yes, use a read-scope token.
Which devices can switch remotely?
Those running the Portveil agent.
What is prohibited?
Spam, attacks, fraud, rule-breaking scraping and outbound email on port 25.
Is Portveil free?
Portveil has a free plan, with paid plans for more usage or features.
How do I add Portveil to Claude Code?
Run this command in your terminal: claude mcp add portveil-mcp --env PORTVEIL_ACCOUNT_ID='<PORTVEIL_ACCOUNT_ID>' --env PORTVEIL_TOKEN='<PORTVEIL_TOKEN>' -- npx -y portveil-mcp
What are the best alternatives to Portveil?
The closest alternatives to Portveil are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.
Alternatives to Portveil

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

Leash
MCP serverReview what your AI touched, approve risky actions and undo supported changes
- 1 tool
- Remote
- Free
- 1 GitHub star
- Security
Zero-log MCP server with 49 tools for AI guardrails, secret scanning and EU compliance
- 49 tools
- Remote
- Freemium
- Security

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security