About kwin-mcp-server
kwin-mcp-server is an MCP server published by Samthesurf in the Blockchain category: mCP server that controls native Wayland windows on KDE Plasma (the cua-driver X11 gap, solved). Includes a doctor readiness report, semantic AT-SPI targeting, and an MCP safety contract.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
uvx kwin-mcp-serverpip install kwin-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (21)
active_windowReturn the currently focused window
Parameters not published.
captureScreenshot the desktop (`mode=desktop`) or a specific window (`mode=window`, `window_id=...`); crops to exact window bounds
Parameters not published.
click_elementClick an AT-SPI element by index
Parameters not published.
doctorOne JSON readiness report (platform, windowing, input, AT-SPI, screenshot, portals, blockers)
Parameters not published.
dragDrag between two points (screen or window-local)
Parameters not published.
focus_elementMove keyboard focus to an AT-SPI element directly (no pixel coords)
Parameters not published.
focused_elementReport which element currently owns keyboard focus
Parameters not published.
get_cursor_positionCurrent pointer location
Parameters not published.
get_window_stateAT-SPI accessibility tree for a window (index, role, name, bounds, state flags, actions, editable)
Parameters not published.
healthEnvironment/dependency diagnostics
Parameters not published.
Show all 21 tools
history_controlComputer History: local enable/disable/pause/resume/flush/delete (user-owned)
Parameters not published.
history_queryComputer History: bounded, metadata-only slice of past kwin-mcp actions
Parameters not published.
history_statusComputer History: is encrypted action-history capture on, and how much is stored?
Parameters not published.
keyboard_navigateMove keyboard focus next/prev through the focusable elements
Parameters not published.
list_windowsEnumerate **every** top-level window (native Wayland + XWayland), with UUID, title, class, pid, geometry
Parameters not published.
pastePaste text via the Wayland clipboard + Ctrl+V (fast, preserves non-ASCII)
Parameters not published.
perform_actionInvoke any AT-SPI action on an element (press, activate, toggle, ...)
Parameters not published.
press_keyPress a key, optionally with modifiers (e.g. `["ctrl"]`)
Parameters not published.
scrollScroll the wheel up/down
Parameters not published.
set_valueWrite a value to a settable element (text fields, sliders, spinners)
Parameters not published.
typeType a string into the focused target
Parameters not published.
Ask AI
Ask AI about kwin-mcp-server
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.