Skip to content
MCP server

Portveil

Move VPN devices between countries and check protection by asking your assistant

Runs locallyStatus and history
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-mcp

Add 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 dashboardRequired
  • PORTVEIL_TOKENA Portveil API token from the dashboard; control scope to move devices, read to only lookRequired
  • PORTVEIL_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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security