WpfPilot MCP

WpfPilot MCP is a local Model Context Protocol server for Windows WPF applications. It lets AI coding agents inspect UI Automation trees, click and type through semantic selectors, diagnose WPF-specific issues, record workflows, and generate xUnit + FlaUI tests.

- Attach to or launch WPF processes.
- Capture semantic UI snapshots (selectors, not screen coordinates).
- Query text, value, state, bounds, patterns, children, ancestors, siblings, and selection.
- Act with verbs such as click, set value, select, toggle, expand, collapse, scroll, and drag/drop.
- Wait and assert on UI state with structured errors.
- Capture screenshots.
- Record workflows and generate test code.
- Optional in-process probe for ViewModel, binding, command, validation, and dispatcher diagnostics.

- Windows 10/11.
- A WPF application to automate.
- Node.js 18+ if usingnpx(recommended). No .NET SDK required for the release binary or npm launcher.

Add this to your MCP client configuration (global or project-scoped):

{ "mcpServers": { "wpfpilot-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@skuzadev/wpfpilot-mcp"] } } }

Or run directly (stdio; waits for an MCP client):

The npm launcher downloads the latest Windows release binary on first run, then proxies stdio to it.

Other installs(persistentwpfpilot-mcpcommand, release zip, uninstall): seeInstall WpfPilot.

Use thestandard configabove unless noted. More clients:docs/all-clients.md.

{ "mcpServers": { "wpfpilot-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@skuzadev/wpfpilot-mcp"] } } }

Or:Cursor Settings→MCP→Add new MCP Server— commandnpx, args-y @skuzadev/wpfpilot-mcp.

cursor-agent mcp list cursor-agent mcp list-tools wpfpilot-mcp

codex mcp add wpfpilot-mcp -- npx -y @skuzadev/wpfpilot-mcp codex mcp list

[mcp_servers.wpfpilot-mcp] command = "npx" args = ["-y", "@skuzadev/wpfpilot-mcp"] enabled = true startup_timeout_sec = 30 tool_timeout_sec = 60

claude mcp add --transport stdio wpfpilot-mcp -- npx -y @skuzadev/wpfpilot-mcp claude mcp list

{ "mcpServers": { "wpfpilot-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@skuzadev/wpfpilot-mcp"] } } }

Windows config:%APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "wpfpilot-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@skuzadev/wpfpilot-mcp"] } } }

{ "servers": { "wpfpilot-mcp": { "type": "stdio", "command": "npx", "args": ["-y", "@skuzadev/wpfpilot-mcp"] } } }

Or:code --add-mcp '{"name":"wpfpilot-mcp","command":"npx","args":["-y","@skuzadev/wpfpilot-mcp"]}'

List the WpfPilot tools and attach to my running WPF application.

Show the main window UI tree. Click the Save button using a selector, not coordinates. Wait until the status text says Saved. Why is the Submit button disabled? Record this workflow and generate an xUnit test.

Full tool list:docs/tools-reference.md.

Use wpf_probe_connect, then inspect my ViewModel and binding errors.

Restart your terminal after running the installer, or use the full path towpfpilot-mcp.exein your MCP client configuration. Seeall-clients.md.

- All MCP clients
- Tool reference
- Probe setup
- Architecture
- Examples
- Development
- Releasing

Build and deploy full-stack Next.js apps with 98 tools for React, AWS, and MongoDB