Low Risk

windows_pslist

List running processes on a Windows host. Args: client_id: Velociraptor client ID. org_id: Optional Velociraptor org ID for multi-tenant deployments. ProcessRegex: Case-insensitive regex to filter process names. PidRegex: Regex to filter process IDs. ExePathRegex: Regex to filter executable path ...

How to control windows_pslist ↓

What windows_pslist does on Velociraptor MCP

AI agents call windows_pslist to retrieve information from Velociraptor MCP without modifying anything — typically the context-gathering step in research, monitoring, and reporting workflows, before the agent takes action elsewhere.

Low Risk

Why windows_pslist needs a policy

This is a read-only information retrieval tool that queries process state on a target system. While the information returned (running processes, their command lines, user context) is operationally sensitive and could inform a subsequent attack, the tool itself only observes and returns data without side effects.

From the tool's definition Tool lists running processes on a Windows host with optional regex filters on process names, PIDs, paths, command lines, and usernames.

Documented attack patterns abuse exactly the kind of access windows_pslist gives an agent:

How to control windows_pslist

PolicyLayer is an MCP gateway — it sits between your AI agents and Velociraptor MCP, and nothing reaches the server without passing your rules. This is the rule we recommend for windows_pslist:

policy.json
{
  "version": "1",
  "default": "deny",
  "tools": {
    "windows_pslist": {}
  }
}

windows_pslist is read-only, so it stays allowed — but everything else on the server is denied unless you say otherwise.

  1. Create a free account and register Velociraptor MCP — nothing to install.
  2. Add this policy — paste it, or build it visually.
  3. Point your MCP client (Claude, Cursor, anything) at your gateway URL.
CAP THIS TOOL →

Free to start. No card required.

Related tools and policies

Go deeper

Questions about windows_pslist

What does the windows_pslist tool do? +

List running processes on a Windows host. Args: client_id: Velociraptor client ID. org_id: Optional Velociraptor org ID for multi-tenant deployments. ProcessRegex: Case-insensitive regex to filter process names. PidRegex: Regex to filter process IDs. ExePathRegex: Regex to filter executable path on disk. CommandLineRegex: Regex to filter process command line. UsernameRegex: Regex to filter user context of the process. Fields: Comma-separated list of fields to return. Returns: Process list results as a string or error message. It is categorised as a Read tool in the Velociraptor MCP MCP Server, which means it retrieves data without modifying state.

How do I enforce a policy on windows_pslist? +

Register the Velociraptor MCP server in PolicyLayer and add a rule for windows_pslist: allow, deny, rate-limit, or require approval. Point your MCP client at the PolicyLayer proxy URL and the rule is enforced on every call, before it reaches Velociraptor MCP. Nothing to install.

What risk level is windows_pslist? +

windows_pslist is a Read tool with low risk. Read-only tools are generally safe to allow by default.

Can I rate-limit windows_pslist? +

Yes. Add a rate_limit block to the windows_pslist rule in your PolicyLayer policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block windows_pslist completely? +

Set action: deny in the PolicyLayer policy for windows_pslist. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides windows_pslist? +

windows_pslist is provided by the Velociraptor MCP server (mgreen27/mcp-velociraptor). PolicyLayer sits as a proxy in front of this server to enforce policies before tool calls reach the server.

Enforce policy on every Velociraptor MCP tool call.

Start from Velociraptor MCP, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

Free to start. No card required.

28 Velociraptor MCP tools catalogued and risk-classified — across an index of 43,000+ MCP servers.

// GET IN TOUCH

Have a question or want to learn more? Send us a message.

Message sent.

We'll get back to you soon.