How to add Terminator MCP Agent to Windsurf

Computer-use MCP server that automates Windows desktop and browser apps via the accessibility tree. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 1.5k★ · stdio · no auth · official

Windsurf config for Terminator MCP Agent

npx -y terminator-mcp-agent@latest --add-to-app

{
  "mcpServers": {
    "terminator-mcp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "terminator-mcp-agent@latest"
      ],
      "env": {
        "LOG_LEVEL": "info",
        "RUST_BACKTRACE": "1"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Terminator MCP Agent config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Terminator MCP Agent's tools become available to Cascade.

Before you start

Windows (Windows 10/11 or Windows Server 2016+); macOS and Linux are not supported
Node.js v16+ (for the npx-based launch)
An MCP-compatible client (Claude Code, Cursor, VS Code, Windsurf, etc.)
Chrome extension installed for browser automation features
Accessibility Insights for Windows or Inspect.exe (optional, to author reliable selectors)

What Terminator MCP Agent can do in Windsurf

get_window_tree

Retrieve the accessibility/UI element tree for a window or process, with options to limit depth, start from a selector, and choose output format.

get_applications_and_windows_list

List running applications and open windows so workflows can discover and target them.

open_application

Launch an application by path or name (e.g. calc.exe).

click_element

Click a UI element resolved by a selector, with actionability validation (visibility, enabled, stable).

invoke_element

Invoke an element via the accessibility API as an alternative to a physical click.

activate_element

Bring an element or its window to the foreground / give it focus.

type_into_element

Type text into a targeted UI element.

press_key

Send keyboard key presses to a focused element.

Security

Grants AI assistants full control over the desktop and any application, including the user's logged-in browser session, cookies, and auth. Never hard-code credentials in workflows—use environment variables or a secret manager. Workflows are code: store them in version control and review changes. Run with elevated/administrator privileges only when accessibility features require it.

Terminator MCP Agent + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Terminator MCP Agent config there under the "mcpServers" key and restart the client.

Is Terminator MCP Agent safe to use with Windsurf?

Which operating systems are supported?

Windows only. The README explicitly states macOS and Linux are not supported.

How do I install it in Claude Code?

Run the one-liner: claude mcp add terminator "npx -y terminator-mcp-agent@latest". For other clients, add the mcpServers block with command "npx" and args ["-y", "terminator-mcp-agent@latest"], or run npx -y terminator-mcp-agent@latest --add-to-app.

Does it take over my mouse and keyboard?

No. It runs in the background using the accessibility tree and your browser session, so it does not hijack your cursor or keyboard or require you to re-login.

View repo Full Terminator MCP Agent page