mcpbeat Sign in

WinCtl MCP Server

by sitharaj88 Your server? Claim it
local only

WinCtl runs on your own machine — the client starts it, so there is no endpoint to ping. 35 installs a week from npm. Last commit 2 Aug 2026.

Windows desktop control for AI agents: screen, UI Automation, input, processes, files, shell.

Installs per day peak 14 · avg 2 · +338% w/w
a month agotoday
35
Installs / week
npm · @sitharaj88/winctl
0
Stars
0 open issues
2 Aug 2026
Last commit
no releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 2 d ago · rules 995398eba69f

A tool parameter reaches a dangerous call

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.

A tool parameter reaches a file or shell call process_start.cwd → src/tools/process.ts:112, file_list.path → src/tools/files.ts:214, file_list.path → src/tools/files.ts:265 и ещё 1
      const child = spawn(target, argv, {
Capabilities

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.

A tool parameter here reaches a dangerous call

That is not a flaw by itself — but it is where things go wrong when it is not the job. We re-read this code on every release. Watch it and you hear from us the day another one appears.

Three servers free · no card

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.

run in your terminal
claude mcp add winctl -- npx -y @sitharaj88/winctl
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "winctl": {
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.winctl]
command = "npx"
args = ["-y", "@sitharaj88/winctl"]
.cursor/mcp.json
{
  "mcpServers": {
    "winctl": {
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "winctl": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@sitharaj88/winctl"
      ]
    }
  }
}

Optional settings from the registry entry, left out of the block above: 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).

Alternatives to WinCtl

same job, measured the same way
Computer Use
by hightemp

Local MCP server for desktop automation: mouse, keyboard, screen, windows, and processes.

54 installs/wk local only
Anode background Windows desktop
by skulitom

Background Windows desktop for AI agents: native GUI automation, screenshots and app testing.

local only
ScreenshotMCP
by agentforge-labs

Desktop and mobile website screenshots plus page context for AI agents and automation workflows.

2 tools answering
Weavetab
by weavetab

Open automation engine for AI agents. Control live browsers and desktop apps locally.

385 installs/wk local only
Android Puppeteer MCP
by pedro-rivas

MCP server for Android automation with UI interaction, screenshots, and device control

121 installs/wk local only
Precision Desktop
by ikoskela

Fixes DPI coordinate scaling for Windows desktop automation MCP servers.

39 installs/wk local only
ultranix-mcp
by jxoesneon

Secure Linux desktop automation - input, screen/OCR/vision, AT-SPI2 UI tree, window, clipboard

local only
Netwright
by ricfanin

Playwright-style automation of .NET desktop apps (WPF, WinForms, WinUI) for AI agents.

local only

WinCtl — questions

Answers built from our own checks of this server.

Why is there no uptime for WinCtl?
WinCtl runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @sitharaj88/winctl was installed 35 times last week.
How do I connect WinCtl?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @sitharaj88/winctl straight from npm; nothing to host, nothing to sign up for.
How many people use WinCtl?
The npm package @sitharaj88/winctl was installed 35 times in the last week. Week over week that is +338%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is WinCtl open source?
Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.