procmon-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@procmon-mcp show me processes with network connections"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
procmon-mcp
An MCP server that gives AI assistants deep visibility into Windows internals: processes, ETW kernel traces, event logs, services, drivers, minifilters, and static PE analysis. Built for security researchers, reverse engineers, and anyone who wants an LLM that can actually see what Windows is doing.
This is a proof of concept (POC). Use at your own risk.
procmon-mcp interacts directly with sensitive Windows internals: kernel ETW traces, process memory, security event logs, service/driver enumeration, and UAC elevation requests. These operations can affect system stability, expose sensitive data, and require administrator privileges. There are no guardrails beyond what Windows itself enforces. Review the tool list, understand what each tool does, and run this only in environments you control. The authors assume no liability for misuse or unintended consequences.
Why?
LLMs are blind to what your OS is doing. Every time you need process info, network connections, or trace data, you're alt-tabbing to Task Manager, Process Monitor, or PowerShell and pasting results back. procmon-mcp eliminates that loop -- your AI assistant can directly query 18 tools covering live process state, kernel ETW traces, PE internals, event logs, services, drivers, and minifilters. Ask a question, get structured data, stay in flow.
Related MCP server: windows-admin-mcp
Quickstart
pip install procmon-mcpOr run without installing:
uvx procmon-mcpExample prompts
Once connected, try asking your AI assistant:
"What processes are making network connections right now?"
"Start an ETW trace, launch notepad, stop the trace, and show me what happened"
"Analyze the PE imports of C:\Windows\System32\cmd.exe and categorize the APIs"
"Are any non-Microsoft services running? Show me their binary paths"
"Show me recent logon events from the Security log"
"Take a 30-second timed capture of all svchost processes and summarize the changes"
"List all minifilter drivers and their altitudes"
"What AV products does SecurityCenter2 report?"
Features
Processes -- list, detailed metadata (modules, threads, command line, memory), point-in-time snapshots, timed multi-snapshots with optional trigger commands
ETW -- start/stop kernel traces with logman and tracerpt, list providers, preview CSV and summary output
Network -- TCP and UDP endpoint enumeration with owning process filters
Services and drivers -- service listing with binary paths, kernel driver enumeration, fltmc minifilter output
PE analysis -- static import/export extraction with API category tags (Kernel API, Native API, Win32, Driver)
Event logs -- Get-WinEvent queries and a Security log convenience wrapper for audit event IDs (4688, 4624, 4672, 4648)
System -- OS build, AV product snapshot, elevation capability matrix, UAC helper
Presets -- Defender process/service/driver constants and scan trigger helpers
How it compares
procmon-mcp is the most comprehensive live Windows monitoring MCP server available. With 18 tools spanning processes, ETW kernel tracing, PE analysis, event logs, services, drivers, and minifilters, it covers more ground than any other single MCP server for live Windows internals. Other tools in this space either focus narrowly (process listing only, event logs only) or do offline forensics from Linux. procmon-mcp gives your AI assistant direct, real-time access to the full Windows instrumentation stack.
MCP client configuration
Cursor
Add to your MCP settings (.cursor/mcp.json or global settings):
{
"mcpServers": {
"procmon-mcp": {
"command": "procmon-mcp",
"args": []
}
}
}If you installed into a virtual environment, use python -m procmon_mcp:
{
"mcpServers": {
"procmon-mcp": {
"command": "python",
"args": ["-m", "procmon_mcp"],
"cwd": "C:\\path\\to\\your\\venv\\Scripts"
}
}
}Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"procmon-mcp": {
"command": "procmon-mcp",
"args": []
}
}
}Tool reference
Tool | Description | Required parameters |
| Processes with optional name/PID filter | none |
| Modules, threads, command line, memory | none |
| Point-in-time process, module, and network snapshot | none |
| Repeated snapshots over a duration | none |
| Start a kernel ETW trace (requires elevation) |
|
| Stop trace and convert ETL output |
|
| Parse | none |
| TCP/UDP endpoints by process | none |
| Win32 services with paths | none |
| Kernel drivers via WMI | none |
|
| none |
| Static PE imports and exports |
|
| Recursive PE file discovery |
|
|
| none |
| Security log (IDs 4688, 4624, 4672, 4648) | none |
| OS build and AV snapshot | none |
| Capability matrix | none |
| UAC helper for a shell command |
|
All tools accept optional parameters beyond those listed. See tool schemas for details.
Elevation
Several capabilities require an elevated (administrator) token:
start_etw_traceandstop_etw_traceuselogmanreal-time sessions (-ets).get_security_eventsreads the Security log.
Other tools run without elevation but may return partial results when Windows blocks enumeration (protected processes, restricted logs). Use check_elevation for the full capability matrix.
Presets
The Defender preset (procmon_mcp.presets.defender) provides constants (DEFENDER_PROCESSES, DEFENDER_SERVICES, DEFENDER_DRIVERS), binary discovery, MpCmdRun resolution, trigger_scan, and get_preset_config. MCP tools stay generic and preset-agnostic.
Development
pip install -e ".[dev]"
ruff check .
pytestSee CONTRIBUTING.md for full guidelines.
Security
This is a POC. The operations performed are sensitive by nature. This tool reads process memory, enumerates kernel drivers, starts ETW trace sessions, queries security audit logs, and can trigger UAC elevation prompts. Run it only on machines you own or have explicit authorization to instrument. Never point it at production systems without understanding the implications. See SECURITY.md for our security policy and responsible disclosure process.
License
MIT. See LICENSE.
Available Tools
18 toolsanalyze_peC
Parse a PE file with pefile: imports, exports, category summary.
Inputs: file_path (required).
capture_snapshotC
Point-in-time snapshot of matching processes: processes, modules, network connections.
Inputs: process_names, pids.
check_elevationA
Whether the server is elevated plus a capability matrix for all tools.
Inputs: no named parameters.
find_pe_filesB
Recursively discover PE files under a directory.
Inputs: directory (required), extensions.
get_minifiltersB
Run fltmc filters and instances and return raw parsed lines.
Inputs: no named parameters.
get_network_connectionsC
TCP and/or UDP endpoints with owning process. protocol: tcp, udp, both, all.
Inputs: process_name, pid, protocol.
get_process_detailsA
Deep process details: modules, handle count, threads, command line, memory breakdown. May warn on protected processes.
Inputs: pid, name.
get_security_eventsB
Security log convenience: IDs 4688, 4624, 4672, 4648 (requires elevation).
Inputs: max_events, hours_back.
get_system_infoB
OS build, architecture, hostname, SecurityCenter2 AV products, PowerShell version.
Inputs: no named parameters.
list_driversC
Enumerate kernel drivers via Win32_SystemDriver.
Inputs: name_filter.
list_etw_providersC
Parse logman query providers with optional keyword filter.
Inputs: keyword.
list_processesA
List processes with optional name or PID filter. Returns handles, threads, working set, path, parent PID, start time.
Inputs: name_filter, pid_filter.
list_servicesA
Enumerate services via Win32_Service (name, state, start mode, display name, path).
Inputs: name_filter, status_filter.
query_event_logC
Query a Windows event log via Get-WinEvent FilterHashtable.
Inputs: log_name, event_ids, max_events, hours_back, +1 more.
request_elevationC
Launch a cmd script via UAC (Start-Process -Verb RunAs) to run the given command.
Inputs: command (required), timeout.
start_etw_traceA
Start a kernel ETW trace via logman (requires elevation). providers are Microsoft-Windows-Kernel-* names or GUID strings.
Inputs: session_name (required), providers, output_dir.
stop_etw_traceA
Stop ETW trace, run tracerpt to CSV and summary, return parsed preview (requires elevation).
Inputs: session_name (required), output_dir, process_filter.
timed_captureA
Repeated snapshots over a duration with optional shell trigger command launched at start.
Inputs: process_names, duration, interval, trigger_command.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 18 tools
Most tools have distinct purposes, but capture_snapshot bundles process listing and network connections that overlap with list_processes and get_network_connections. However, descriptions clarify the composite nature, reducing ambiguity.
All tool names follow a consistent verb_noun pattern using snake_case (e.g., analyze_pe, list_processes, start_etw_trace), with no mixing of conventions.
18 tools cover a broad monitoring domain, slightly exceeding the typical 3-15 range, but each tool addresses a specific need, and no tool feels redundant.
The tool set covers core process monitoring aspects: process listing, deep details, network, security events, ETW tracing, services, drivers, PE analysis, and elevation handling. There are no obvious gaps for its intended scope.
Maintenance
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
MCP server for building and testing AI agents with multi-model experimentation and insights.
MCP server that lets your AI assistant build and deploy apps, hosting each one at a live URL.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA MCP server for Windows/Linux that provides 90+ tools enabling AI assistants to systematically manage local systems, including system probing, command execution, file editing, network diagnostics, and more.13MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to manage, monitor, and diagnose Windows systems through 42 tools across 8 modules, including services, event viewer, task scheduler, processes, network, diagnostics, observability, and safety features.16 npm9MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that exposes dynamic binary instrumentation, memory editing, pointer scanning, and scripting capabilities to AI agents, enabling real-time process inspection and modification.MIT
- AlicenseNot gradedqualityDmaintenanceAn open-source MCP server for Windows that provides traceable system operations (file, screenshot, clipboard, process, power management) to AI assistants via HTTP/SSE.14GPL 3.0