docs/integrations/windsurf

How to connect the System Process Observer MCP Tool to Windsurf

Monitors active OS processes and identifies infrastructure port usage (Docker, Redis, Node, etc.). This guide provides the exact configuration required to load the list_processes tool inside Windsurf.

Step 1: Open the configuration file

Locate and open your Windsurf configuration file at the following path:

macOS / Linux~/.codeium/windsurf/mcp_config.json

Windows%USERPROFILE%\.codeium\windsurf\mcp_config.json

Step 2: Add the server config

Copy and paste the following JSON snippet into the file. Save the file and restart Windsurf.

mcp_config.json

{
  "mcpServers": {
    "agenticstore": {
      "command": "uvx",
      "args": ["agentic-store-mcp", "--tools", "list_processes"]
    }
  }
}

Step 3: Try it out

Once restarted, ask Windsurf something like this to trigger the tool:

"Check if Postgres and Docker are running on my machine."

Explore more

→ View full list_processes documentation → See all Client integrations