WinBridgeAgent

WinBridgeAgent is an open-source Windows local MCP server that exposes a secure HTTP API for performing traceable Windows system operations. It enables AI assistants and MCP clients to read files, manage clipboard and windows, execute commands, capture screenshots, control processes, and perform system actions such as shutdown or restart from your Windows machine.

How to use

You connect your MCP client to the Windows machine running WinBridgeAgent using the HTTP interface. By default, the server listens on port 35182 and can be accessed from other devices on your LAN by using the Windows host IP and that port. Once connected, you can request disk information, enumerate directories, read files, search content, read or write the clipboard, capture screenshots, list windows and processes, execute system commands, and issue MCP commands to initialize the protocol and manage tools.

How to install

Prerequisites you may need depend on how you install WinBridgeAgent. The controller supports both a quick, ready-to-run binary installation and a registry-based MCP setup.

Install from MCP Registry

WinBridgeAgent is published on the MCP Registry as io.github.codyard/winbridgeagent. Use your MCP client to install it directly from the registry.

Manual install

1. Download the latest release from GitHub Releases.

2. Run the executable corresponding to your architecture: WinBridgeAgent-x64.exe for 64-bit or WinBridgeAgent-x86.exe for 32-bit.

3. The program will appear in the system tray once it starts.

4. Configure your MCP client to connect to the server URL http://<windows-ip>:35182 (replace <windows-ip> with the actual IP address of the Windows machine). If you are testing on the same machine, you can use localhost.

Additional sections

Configuration and behavior details are available to help you tailor WinBridgeAgent to your environment. The server defaults to port 35182 and listens on all network interfaces, enabling access from other devices on the LAN. You can change the listen address to restrict access if needed.

Security considerations include understanding that the open-source edition does not enforce Bearer Token authentication on the HTTP API. If you expose the service beyond localhost, ensure your network and firewall settings protect access, and remember that certain protected system resources cannot be terminated or deleted.

Operational notes cover audit logging of all actions, the availability of real-time monitoring via a dashboard, and a system tray interface for quick management. There is built-in support for automatic updates through GitHub releases if you enable that feature.

If you plan to deploy across multiple machines, you can manage several WinBridgeAgent instances from your MCP client by listing each server’s URL in your multi-computer configuration.

Available tools

list_disks

List all disk drives on the Windows machine.

list_directories

List contents of a specified directory.

read_file

Read the contents of a file, with optional path ranges.

search_file

Search for a text query within a file or directory.

clipboard_read

Read the current clipboard contents via the HTTP API.

clipboard_write

Write text or other data to the clipboard via HTTP.

screenshot_full

Capture a full-screen screenshot in PNG or JPEG format.

screenshot_window

Capture a specific window by title.

screenshot_region

Capture a region by coordinates.

list_windows

List all open windows with details.

list_processes

List all running processes with details.

execute_command

Execute a system command and return its output.

shutdown

Initiate delayed or forced shutdown, restart, hibernate, or sleep.

mcp_initialize

Initialize MCP protocol negotiation with the client.

mcp_list_tools

List available MCP tools and capabilities.

mcp_call_tool

Call a specific MCP tool by name with arguments.