WinCtl MCP Server

What the code does

We read the source, 20 h ago · rules 3dff92dd89df

A value the model can set ends up inside a file or shell call. That is not a flaw by itself — for a terminal server it is the job — but it is where things go wrong when it is not.

        await fs.writeFile(target, data);

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

      const probe = spawnSync(candidate, ['-NoLogo', '-NoProfile', '-Command', '$PSVersionTable.PSVersion.Major'], {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

claude mcp add winctl -- npx -y @sitharaj88/winctl

{
  "mcpServers": {
    "winctl": {
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ],
      "command": "npx"
    }
  }
}

[mcp_servers.winctl]
command = "npx"
args = ["-y", "@sitharaj88/winctl"]

{
  "mcpServers": {
    "winctl": {
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ],
      "command": "npx"
    }
  }
}

{
  "mcpServers": {
    "winctl": {
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ],
      "command": "npx"
    }
  }
}

This one needs environment variables set before it will start: WINCTL_PROFILE (Permission profile: readonly (observation only), standard (adds desktop interaction and file access), or full (adds process control and shell execution). Defaults to standard.), WINCTL_TIERS (Comma-separated capability tiers, overriding the profile. Any of: observe, interact, filesystem, manage, shell.), WINCTL_ALLOWED_PATHS (Semicolon-separated folders that file tools may access. Empty means the whole filesystem except protected Windows system directories.), WINCTL_CONFIRM_DESTRUCTIVE (Set to false to skip user confirmation prompts for destructive actions. Defaults to true.), WINCTL_AUDIT_LOG (Path to the JSONL audit log. Defaults to %LOCALAPPDATA%\winctl\audit.jsonl.), WINCTL_MAX_IMAGE_WIDTH (Screenshots are downscaled to at most this width in pixels. Defaults to 1600.). The author declared them in the registry entry; get the values from the project itself.