PC Controller MCP Server

Retrieve the complete runtime configuration of the PC Controller MCP server. Returns the current values for all configurable settings: blockedCommands (list of dangerous commands that are tracked), defaultShell (which shell is used for run_command: powershell, gitbash, or wsl), fileReadLineLim…

Update a server configuration value at runtime. Changes take effect immediately for all subsequent tool calls — no restart required. Use config_get first to see the current settings before modifying them. Supported keys: "defaultShell" (change between powershell/gitbash/wsl), "blockedCommands"…

Retrieve usage statistics for the current server session. Shows per-tool call counts, error counts, and last-used timestamps, sorted by total calls descending. Use this to audit which tools have been called during the session, identify tools with high error rates that may need investigation, o…

Retrieve the most recent tool calls with full details: tool name, serialized arguments, success/failure status, and execution duration in milliseconds. Returns results in reverse chronological order (newest first). Use this to debug failed tool calls (see what arguments caused the error), reco…

Fetch content from a URL and return it as plain text. Supports HTTP and HTTPS URLs. Content is truncated at 50KB to keep responses manageable. Use this tool to read online documentation, fetch JSON API responses, download raw file contents (e.g., from GitHub raw URLs), inspect HTML pages, or a…

Read the PC Controller skill documentation files. This tool provides access to the complete AI skill reference — a structured guide describing all 39 available tools, their parameters, usage examples, workflows, and safety rules. Use this tool when you need to understand what capabilities the PC Con…

Read and return the text contents of a file on this Windows PC. Supports all text-based files: .txt, .json, .js, .ts, .py, .md, .csv, .xml, .yaml, .html, .css, .log, .env, .ini, .bat, .ps1, .toml, and other text files. Supports optional line ranges (offset/limit) and negative offsets (read fro…

Write text content to a file on this Windows PC. If the file does not exist, it will be created automatically along with any missing parent directories (auto-create directory). If the file already exists, its entire content will be overwritten (full replacement). Use this to create new configu…

List the contents of a folder/directory on this Windows PC. Shows file/folder names, type (folder or file), file size, and last modified date. Supports recursive mode with configurable depth limit. Use this to explore folder structures, locate files, check file sizes, or inspect directory co…

Search for files on this Windows PC by name pattern (glob/wildcard). Search is performed recursively through all sub-folders. Supports wildcards like *.txt, *.jpg, *.json, config*, report_*.xlsx, and other patterns. Use this to find misplaced files, locate all files with a specific extension, …

Surgically edit a file by searching for exact text and replacing it. Unlike file_write (which overwrites the whole file), this only touches the matched parts. Built for agent-style editing: - Returns a compact git-style unified diff of the change (with a little context), so you can verify …

Move or rename a file or directory on this Windows PC. If source and destination are on the same drive, the item is moved. If across drives, it is copied then deleted. Destination parent directories are created automatically. Use this to reorganize files, rename items, or move folders between …

Get detailed metadata about a file or directory: size, created date, modified date, accessed date, whether it's a file or directory, and read-only status. Use this to check if a file exists before reading, check file sizes, or verify modification times.

Read the last N lines or last N bytes of a file. Equivalent to Unix 'tail' command. Use this to check the end of log files, view recent entries in data files, or inspect the tail of large files without reading the entire content.

Search for text inside files using pattern matching (like Unix grep). Search is recursive through all sub-folders. Returns matching lines with file paths and line numbers. Use this to find where a variable is used, locate error messages in logs, find configuration keys, or trace code reference…

Read contents of multiple files simultaneously. Returns each file's content labeled with its path. Useful for comparing files, loading configs, or reading related source files at once. Failed reads are reported but don't stop other files.

Create a new directory on this Windows PC, including any necessary parent directories (equivalent to Unix 'mkdir -p'). Does nothing if the directory already exists. Use this to set up project folder structures, ensure output directories exist before writing files, or organize files into new fo…

Copy a file or directory to a new location on this Windows PC. Parent directories at the destination are created automatically if they don't exist. For directories, the copy is performed recursively (all contents included). Use this to duplicate files, create backups before editing, copy proje…

Permanently delete a file or directory from this Windows PC. WARNING: Deleted files bypass the Recycle Bin and cannot be recovered — there is no undo. For directories, use the recursive flag to delete non-empty folders and all their contents. Use this to remove temporary files, clean up build …

Preview file contents with rich formatting. Images (PNG, JPG, GIF, BMP, ICO, SVG, WEBP) are returned as base64 for inline display by the AI. Markdown files show word/line counts and headings. Code files display with syntax metadata. Other files show raw content with size info.

Apply multiple surgical edits to a single file in one round-trip, in order. Each edit searches for exact old_text and replaces it with new_text. This is the agent-friendly way to make several small changes to a code/config file without issuing one file_edit call per change and without re-readi…

List all active terminal sessions managed by this server. Each session is a persistent shell (created by run_command with a session_id) or a long-running process that is still alive. Shows session ID, shell type, working directory, creation time, output line count, and alive status. Use this t…

Open a VISIBLE persistent streaming terminal session (step 1 of the streaming flow). Step 1: call this tool to open a visible terminal window — it returns a confirmation that the session is ready. Step 2: send commands into it with run_command(session_id=...). The shell stays alive between cal…

Read buffered output from a long-running terminal session with pagination. Supports offset and length parameters to read specific ranges of output lines. Use this to inspect build logs, check command output, or monitor process status without flooding the context window with too much data. Firs…

Send input/commands to a running interactive terminal session. Use this to interact with SSH sessions (send commands to remote servers), database CLIs (run SQL queries in PostgreSQL, MySQL, etc.), development servers (send test requests), or any process that reads from stdin. First call list_s…

Stop a persistent terminal session and kill its process tree (including child processes like a running dev server). The session is removed and can no longer be used; a later run_command with the same session_id opens a fresh session. Use list_sessions to see which sessions are active.

Execute a shell command on this Windows PC and return its output. This is the UNIVERSAL tool of this server: anything PowerShell, Git Bash, or WSL can do can be done here — document parsing (Word/Excel COM automation, pdftotext), registry queries, Windows services, network diagnostics, environ…

Execute a long-running shell command on this Windows PC and return all output after completion. Unlike run_command, this tool has a default timeout of 2 minutes (120 seconds) and is designed for commands that take a long time: npm install, pip install, compiling large projects, downloading big…

Execute code in-memory using Python, Node.js, or R without saving files. The code runs as a one-shot script and returns stdout/stderr. Use this for data analysis, quick calculations, prototyping, or testing snippets. Python and R must be installed on the system.

Capture a screenshot (screen grab) of the primary monitor on this Windows PC. Returns the screenshot image in PNG format as base64 data that the AI can directly view and analyze. Use cases: see what's currently displayed on screen, debug UI issues in applications, verify visual changes, create…

Retrieve detailed and comprehensive system information about this Windows PC. Includes: hostname/computer name, OS version and architecture, uptime (how long the PC has been running), CPU model and core count, CPU clock speed, total RAM and free/used RAM (in human-readable format), disk/storag…

Display a list of processes/applications currently running on this Windows PC. Shows process name, Process ID (PID), memory usage (in MB), and CPU time (in seconds). Can be filtered by process name (partial match) to find specific processes. Can be sorted by name, memory usage (find RAM hogs),…

Force-terminate a running process on this Windows PC. Can target by process name (kills ALL instances with that name) or by Process ID/PID (kills a specific process). The process is force-killed without confirmation. Use this to stop hung/frozen applications, close unwanted programs, or free u…

Open a file, folder, or URL using the default application on this Windows PC. For files: opens with the registered application (e.g., .pdf in PDF reader, .jpg in image viewer, .docx in Word). For folders: opens in Windows Explorer. For URLs: opens in the default web browser. Use this to open d…

Read the current text content of the Windows system clipboard (the last copied item). The clipboard is the temporary storage area for copy/paste operations. With this tool, the AI can read what's currently in the clipboard — useful to grab data copied from other applications or verify what was…

Copy text to the Windows system clipboard so the user can immediately paste it (Ctrl+V) in any application. The clipboard is the temporary storage area for copy/paste operations. Use cases: copy command output to the clipboard, transfer text between applications, or automate copy-paste workflo…

Create a ZIP archive from files or folders using PowerShell Compress-Archive. Use this tool to compress files/folders into a .zip file for backup, sharing, or archiving. Supports wildcards in source (e.g. "D:\logs\*.log"). The destination path should end in .zip.

Extract a ZIP archive to a destination folder using PowerShell Expand-Archive. Use this tool to unzip archives. The destination folder is created automatically if it doesn't exist. Existing files in the destination will be overwritten.

Bring a window to the foreground by matching its title or process name (case-insensitive). Use this tool to switch focus to a specific application window before sending keys or interacting with it. Example: "Notepad", "Visual Studio Code", "chrome" — matches any open window whose title contain…

Type text or send keystrokes to the currently focused window using PowerShell SendKeys. Call window_focus first to make sure the target window is active. For literal text, pass 'text' (special characters are escaped automatically). For shortcuts and special keys, pass 'keys' as a raw SendKeys …

Show a Windows notification balloon with the given title and message. Use this tool to notify the user when a long task finishes, when something needs their attention, or to display information without opening a window. The notification stays visible for ~6 seconds.