MCP server giving Claude full desktop control on Linux/X11: screenshot, mouse, keyboard, windows, clipboard, app launch.
13 tools with clear action verbs and basic descriptions (avg 85 chars), but critical gaps in schema completeness and parameter documentation. All tools have input schemas visible in code, but many parameters lack descriptions or type constraints. No output schemas documented. Error handling is present but generic. Tool composition is reasonable (single responsibility), but descriptions are terse and lack LLM-optimization guidance. Naming follows verb_noun convention well (screenshot, list_windows, focus_window, etc.), but parameter names like 'title_pattern' and 'direction' lack type suffixes and constraint hints.
Close a window by matching its title pattern.
Focus (activate) a window by matching its title pattern.
Get the current contents of the clipboard.
Press and release a keyboard key or key combination.
Launch an application by name or command.
List all open windows with their properties including window ID, desktop, PID, position, size, and title.
Click the mouse button, optionally at specified coordinates.
Parameter descriptions missing or minimal. 'direction' in mouse_scroll, 'button' in mouse_click, 'key' in key_press, 'text' in type_text lack constraint hints (e.g., 'up|down|left|right', 'left|middle|right'). LLMs cannot infer valid values without explicit enums or format guidance.
No output schemas documented. Tools return textResult() or errorResult() with generic 'text' content, but LLMs cannot plan downstream calls without knowing field names (e.g., list_windows returns 'windows' array with 'id', 'title', 'pid', not visible in tool definition).
Descriptions are terse (avg 50 chars) and lack LLM-optimization guidance. 'Move the mouse cursor to the specified coordinates' does not explain WHEN to use mouse_move vs mouse_click, or whether coordinates are absolute or relative. Baseline for A+ tools is 50-200 chars with context.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 50 | 2026-07-28+ | v2 |
Move the mouse cursor to the specified coordinates.
Scroll the mouse wheel in the specified direction.
Move and/or resize a window by matching its title pattern.
Take a screenshot of the desktop or active window. Supports multiple screenshot tools (maim, scrot, gnome-screenshot) with fallback behavior.
Set the clipboard contents.
Type text as if from the keyboard.
No error recovery guidance. errorResult() returns raw messages like 'no window matched "pattern"' without suggesting next steps (e.g., 'Try list_windows() to see available titles'). Agents cannot self-correct without actionable error messages.
Parameter 'title_pattern' in focus_window, move_window, close_window lacks type suffix and constraint documentation. Is it a regex? Substring match? Exact match? LLMs will guess, causing failures. Should be 'title_pattern (substring match, case-insensitive)' or use separate title_name and title_regex params.