A lightweight MCP server that exposes Hyprland functionality to language models
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"iflow-mcp-stefanoamorelli-hyprmcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<div align="center"> # Hyprland MCP Server </div> <div align="center"> [](LICENSE)     </div> https://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e A lightweight, unofficial [Model Context Protocol (MCP)](https://github.com/modelcontextprotocol) server that exposes all the functionality of `hyprctl`—the command-line interface for the [Hyprland](https://wiki.hyprland.org/) Wayland compositor—to language models. This server enables natural language interfaces to query and control Hyprland's window management, layouts, inputs, and more. > **Note:** This project is experimental and in beta. ## 🚀 Quick Start ### 1. Clone the repository ```bash git clone https://github.com/stefanoamorelli/hyprmcp.git cd hyprmcp ``` ### 2. Grab your `HYPRLAND_INSTANCE_SIGNATURE` ```bash echo $HYPRLAND_INSTANCE_SIGNATURE ``` ### 3. Install the server in your MCP client For example, in Claude Desktop, modify the `~/.config/Claude/claude_desktop_config.json` file as follows: ```json "Hyperland MCP Server": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "subprocess", "mcp", "run", "<global path of the repo>/hyprmcp/hyprmcp/server.py" ], "env": { "PYTHONPATH": "<global path of the repo>/hyprmcp", "HYPRLAND_INSTANCE_SIGNATURE": "<your-hyprland-instance-signature>" } }, ``` ## 🧰 Available Tools | Tool Name | Description | |-----------------------|---------------------------------------------------| | `run_hyprctl_command` | Executes arbitrary `hyprctl` commands. | | `get_version` …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.