# Portveil

> Portveil is a freemium MCP server for security. Move VPN devices between countries and check protection by asking your assistant. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, Linux, macOS, Windows, iOS, Android
- **Website:** https://portveil.com
- **Repository:** https://github.com/roybogs/portveil-mcp
- **MCP Registry name:** io.github.roybogs/portveil-mcp
- **Categories:** security, cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add portveil-mcp --env PORTVEIL_ACCOUNT_ID='<PORTVEIL_ACCOUNT_ID>' --env PORTVEIL_TOKEN='<PORTVEIL_TOKEN>' -- npx -y portveil-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "portveil-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "portveil-mcp"
      ],
      "env": {
        "PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
        "PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "portveil-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "portveil-mcp"
      ],
      "env": {
        "PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
        "PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "portveil-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "portveil-mcp"
      ],
      "env": {
        "PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
        "PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "portveil-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "portveil-mcp"
      ],
      "env": {
        "PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
        "PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "portveil-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "portveil-mcp"
      ],
      "env": {
        "PORTVEIL_ACCOUNT_ID": "<PORTVEIL_ACCOUNT_ID>",
        "PORTVEIL_TOKEN": "<PORTVEIL_TOKEN>"
      }
    }
  }
}
```

## Tools

- `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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/portveil
