Clone
1
API
Jonathan Miller edited this page 2026-05-25 22:06:44 -05:00

← Back to Home

API

Complete MCP tool reference for mcp-windows. All 44 tools with parameters.


Terminal & Process Execution

windows_execute

Execute a shell command (PowerShell, cmd, or bash).

Parameter Type Default Description
command string required The command to execute
shell pwsh | cmd | bash pwsh Shell to use
timeout number 30000 Timeout in milliseconds
cwd string -- Working directory

windows_process_list

List running processes.

Parameter Type Default Description
filter string -- Filter by process name (substring)
sort cpu | memory | name memory Sort order
limit number 50 Max results

windows_process_kill

Terminate processes by PID or name.

Parameter Type Default Description
pid number -- Process ID to kill
name string -- Process name to kill (all matching)
force boolean false Force termination

windows_terminal_start

Start a persistent interactive terminal session.

Parameter Type Default Description
shell pwsh | cmd | bash | python | node | wsl pwsh Shell type

windows_terminal_send

Send input to a running terminal session.

Parameter Type Description
pid number Session PID
input string Text to send

windows_terminal_read

Read output from a terminal session with pagination.

Parameter Type Default Description
pid number required Session PID
offset number 0 Line offset (negative = from end)
length number -- Number of lines

windows_terminal_list

List all active terminal sessions. No parameters.

windows_terminal_kill

Terminate a terminal session.

Parameter Type Description
pid number Session PID to terminate

Audio & Volume

windows_audio_get

Get current audio state. No parameters.

Returns: volume (0-100), mute state, default device name.

windows_audio_set

Set audio volume or mute state.

Parameter Type Description
volume number (0-100) Volume level
mute true | false | toggle Mute state

windows_audio_app_volumes

List per-application audio sessions. Without parameters, lists all apps. Set app + volume/mute to modify.

Parameter Type Description
app string App name to target
volume number (0-100) Volume to set
mute true | false | toggle Mute state

System Information

windows_system_info

Get comprehensive system information. No parameters.

Returns: OS, CPU, RAM, disk, network adapters, uptime.

windows_installed_apps

List installed applications.

Parameter Type Default Description
filter string -- Filter by name
sort name | date | size name Sort order
limit number 50 Max results

File System

windows_file_read

Read a file with line pagination.

Parameter Type Default Description
path string required Absolute file path
offset number 0 Line offset (negative = tail)
length number 200 Lines to return

windows_file_write

Write or append to a file.

Parameter Type Default Description
path string required Absolute file path
content string required Content to write
mode write | append write Write mode

windows_file_edit

Surgical find/replace.

Parameter Type Default Description
path string required Absolute file path
old_string string required Text to find
new_string string required Replacement text
expected_count number -- Fail if count mismatches
replace_all boolean false Replace all occurrences

Search files by name or content.

Parameter Type Default Description
type files | content required Search type
pattern string required Glob or regex pattern
path string . Directory to search
case_sensitive boolean false Case-sensitive
file_pattern string -- Filter files (content search)
context_lines number 0 Context around matches
limit number 50 Max results

Search files using PowerShell.

Parameter Type Default Description
query string required Search query
path string C:\ Directory to search
type name | content name Search type
extension string -- File extension filter
limit number 30 Max results

windows_drives

List all drives/volumes. No parameters.

windows_recycle_bin

Manage the Recycle Bin.

Parameter Type Default Description
action list | size | empty | restore list Action
filter string -- Filter by filename
limit number 30 Max items (list)

Services

windows_service_list

Parameter Type Default Description
filter string -- Filter by name (substring)
status running | stopped | all all Status filter

windows_service_control

Parameter Type Description
name string Service name
action start | stop | restart | enable | disable Action

Power Management

windows_power_get

Get power state. No parameters.

windows_power_action

Parameter Type Description
action sleep | hibernate | lock | shutdown | restart | logoff | plan Action
delay number Delay in seconds
cancel boolean Cancel scheduled shutdown
plan balanced | performance | powersaver Power plan (with action=plan)

Network

windows_network_info

Get network configuration. No parameters.

windows_network_connections

Parameter Type Default Description
state all | listen | established | time_wait | close_wait all State filter
port number -- Port filter
process_name string -- Process name filter
limit number 50 Max results

Display & Screenshot

windows_display_get

Get display configuration. No parameters.

windows_display_set

Parameter Type Description
resolution string Resolution as WIDTHxHEIGHT
brightness number (0-100) Screen brightness (laptops)

windows_screenshot

Parameter Type Default Description
target screen | window | region screen Capture target
monitor number 0 Monitor index
window_title string -- Window title (for window)
x, y, width, height number -- Region bounds
save_path string -- Save to file instead of base64

Window Management

windows_window_list

Parameter Type Description
filter string Filter by title (substring)

windows_window_control

Parameter Type Description
title string Window title (substring)
pid number Process ID
action minimize | maximize | restore | close | focus | move | resize | topmost Action
x, y number Position (for move)
width, height number Size (for resize)
topmost boolean Always-on-top state

Clipboard

windows_clipboard_get

Read clipboard contents. No parameters.

windows_clipboard_set

Parameter Type Description
text string Text to copy
files string[] File paths to copy
clear boolean Clear clipboard

Notifications

windows_notification_send

Parameter Type Default Description
title string required Title
body string required Body text
icon string -- Icon file path
sound boolean true Play sound

Registry

windows_registry_read

Parameter Type Default Description
path string required Registry path (HKCU:, HKLM:, etc.)
value string -- Specific value name
subkeys boolean false List subkeys instead

windows_registry_write

Parameter Type Default Description
path string required Registry path
name string required Value name
value string required Value data
type String | DWord | QWord | Binary | ExpandString | MultiString String Value type
hklm_override boolean false Allow HKLM writes
action set | delete | create_key | delete_key set Action

Environment Variables

windows_env_get

Parameter Type Default Description
name string -- Variable name (omit to list all)
scope user | system | both both Scope

windows_env_set

Parameter Type Default Description
name string required Variable name
value string -- Value
scope user | system user Scope
action set | remove | append_path | prepend_path set Action

Startup Items

windows_startup_list

List all startup items. No parameters.

windows_startup_manage

Parameter Type Default Description
action add | remove | enable | disable required Action
name string required Item name
command string -- Command (for add)
location registry | startup_folder registry Where to add

Task Scheduler

windows_task_scheduler_list

Parameter Type Default Description
folder string \ Task folder path
filter string -- Filter by name

windows_task_scheduler_manage

Parameter Type Description
action create | delete | enable | disable | run Action
name string Task name
command string Command (for create)
arguments string Arguments (for create)
trigger once | daily | weekly | hourly | logon | startup Trigger type
time string Time as HH:mm
interval number Minutes (for hourly)

Dialogs

windows_dialog

Parameter Type Default Description
type message | input | file_open | file_save | folder required Dialog type
title string mcp_windows Title
message string -- Message text
buttons ok | okcancel | yesno | yesnocancel ok Buttons (message)
filter string -- File filter
default_path string -- Default path

Configuration

windows_mcp_config

Parameter Type Default Description
action get | set get Action
key string -- Config key
value string -- Value (JSON for arrays)

Repo: mcp-windows · MokoStandards

Field Value
Minimum Version 05.00.00
Platform mcp-server
Applies To mcp-windows
Revision Date Author Description
1.0 2026-05-25 Moko Consulting Initial version