hypruse
Computer use for Hyprland: semantic desktop state over IPC, plus vision and native input
The current version, v0.10.0, was published to the official MCP registry on 2026-08-31. It is distributed as hypruse on PyPI, filed under Image, Video & Audio by this index, and declares 11 environment variables. Removals and unreachable sources are measured across every server this index tracks, contract drift across the servers that answer in consecutive snapshots; the index's current counts put this record in context.
Using hypruse in Claude, Cursor, Gemini CLI, Cline, or Zed?
MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts-before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).
Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less
uv tool install mcpindex-gate && mcpindex-config-wireSemantic screen found no manipulation pattern in the description. Conformance probe not yet run.
mcpindex.integrity.descriptionpassINFOevidence“No malicious intent described”via static_description
- - Semantic screen only - the deterministic conformance probe has not run on this server
- - Confidence is reported but not yet calibrated (v1)
- - Screen reads the tool description, not the live behavior
- - advisory
- - registry description only no input schema
- - screen model 8b
- - Still current: the description we screened is unchanged, re-checked against the registry
- - The registry listing (version, packages, links) changed after this screen ran - the description we assessed did not
Semantic screen: an LLM judge reads the tool description for hidden instructions (status PARTIAL). A pass means the description is not lying, not that the tool is safe: a high-capability tool with an honest description still warrants caution. The deterministic conformance probe has not been run on this server yet, so the screen here is semantic-only. Posture: advisory. Confidences are reported but not yet calibrated (calibrated=false at v1). Full verdict history is not shown on this page.
Own this server? Screen its description →
That verdict was true at screening time (snapshot 2026-09-10).
Contracts can change after screening, with no version bump. The gate pins hypruse’s tool contracts on first sight and holds any silent change before your agent acts - the check that keeps being true on Tuesday.
See your first HOLD in 2 minutes →
Related: how to trust an MCP server · screen before install · silent contract drift
People vet a server before wiring it in. One line on your project site or docs answers that with an independent record: screening verdict, registry provenance, contract drift history. It stays current as new screens and drift events land.
[Independent trust record for hypruse](https://mcpindex.ai/server/io-github-ilyaskhallouki-hypruse) - screening verdict, registry provenance, and contract drift monitoring.<a href="https://mcpindex.ai/server/io-github-ilyaskhallouki-hypruse">Independent trust record for hypruse</a> - screening verdict, registry provenance, and contract drift monitoring.A live verdict badge for your README or listing. It reflects the current screen, links back here, and updates when the verdict does.
[](https://mcpindex.ai/server/io-github-ilyaskhallouki-hypruse)<a href="https://mcpindex.ai/server/io-github-ilyaskhallouki-hypruse"><img src="https://mcpindex.ai/api/v1/badge/io-github-ilyaskhallouki-hypruse" alt="mcpindex verdict" height="20" /></a>HYPRUSE_SCREENSHOT_MODEHow captures are returned: 'file' writes to XDG_RUNTIME_DIR and returns the path, 'image' returns the image inline. Use 'image' for clients that render MCP images but cannot read files, such as Claude Desktop.
HYPRUSE_READONLYSet to 1 to expose only the observation tools (desktop, screenshot, zoom, ui, marks, binds, wait_for). The agent can see and narrate but cannot click, type, or launch.
HYPRUSE_CONFINERestrict input to a scope of windows and refuse everything outside it: 'launched' (only windows hypruse opened this session), 'class:firefox,kitty', or 'workspace:3,special:notes'. Unset means no confinement.
HYPRUSE_AUTH_GUARDRefuse to click or type into system authentication dialogs (polkit, keyring prompts). On by default; 'strict' also refuses password fields in ordinary windows; 0 disables it.
HYPRUSE_STRICTSet to 1 to refuse to act when the cursor or focused window moved since hypruse's last action, so the agent must re-read the desktop before retrying.
HYPRUSE_MARKSet to 1 to make the agent's presence legible: tag every window it opens 'hypruse-owned' and flash an on-screen notice when it opens a window or captures the screen.
HYPRUSE_CLIPBOARDSet to 1 to register the opt-in clipboard tool (never in read-only mode). Off by default because clipboards hold passwords.
HYPRUSE_JOURNALRecord every tool call, refusals included, as one NDJSON line: 1 writes to XDG_STATE_HOME/hypruse/journal.ndjson, or give a path. Read it back with 'hypruse journal'. Off by default.
HYPRUSE_JOURNAL_MAX_BYTESRotate the journal once it reaches this size, keeping one previous generation alongside it. Set 0 to never rotate.
HYPRUSE_JOURNAL_TEXTSet to 1 to record typed and copied text in the journal verbatim instead of as a length plus digest. Off by default because keystrokes are passwords; needed only to replay typing.
HYPRUSE_DRYRUNSet to 1 for a rehearsal: every acting tool validates its arguments and runs every trust guard, then reports what it would have done and delivers no input.
Create branded vertical video ads from ecommerce product URLs or product photos.
Run 100+ AI models — image, video, audio, 3D — through one API with pay-per-use billing.
Make 3D games in Unity Engine with AI. MCP Server + Plugin for Unity Editor and Unity games.