{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_aaju4w9ejgx6","handle":"iflow-mcp-stefanoamorelli-hyprmcp","url":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp","links":{"self":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp/record.json","html":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp","markdown":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-stefanoamorelli-hyprmcp","status":"https://wellknown.network/api/v1/agents/iflow-mcp-stefanoamorelli-hyprmcp/status","claim":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-stefanoamorelli-hyprmcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-stefanoamorelli-hyprmcp/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-stefanoamorelli-hyprmcp/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-stefanoamorelli-hyprmcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_stefanoamorelli_hyprmcp","summary":"A lightweight MCP server that exposes Hyprland functionality to language models","description":"<div align=\"center\">\n\n# Hyprland MCP Server\n\n</div>\n\n<div align=\"center\">\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n![Python 3.10+](https://img.shields.io/badge/Python-3.10%2B-blue.svg)\n![Platform](https://img.shields.io/badge/platform-Linux-lightgrey.svg)\n![Build Status](https://img.shields.io/badge/build-passing-brightgreen.svg)\n![MCP Server](https://badge.mcpx.dev?type=server 'MCP Server')\n\n</div>\n\nhttps://github.com/user-attachments/assets/b4fc1d26-ec04-451a-b7c9-7f87b44d9c9e\n\nA 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.\n\nThis server enables natural language interfaces to query and control Hyprland's window management, layouts, inputs, and more.\n\n> **Note:** This project is experimental and in beta.\n\n## 🚀 Quick Start\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/stefanoamorelli/hyprmcp.git\ncd hyprmcp\n```\n\n### 2. Grab your `HYPRLAND_INSTANCE_SIGNATURE`\n\n```bash\necho $HYPRLAND_INSTANCE_SIGNATURE\n```\n\n### 3. Install the server in your MCP client\n\nFor example, in Claude Desktop, modify the `~/.config/Claude/claude_desktop_config.json` file as follows:\n\n```json\n\"Hyperland MCP Server\": {\n  \"command\": \"uv\",\n  \"args\": [\n    \"run\",\n    \"--with\",\n    \"mcp[cli]\",\n    \"--with\",\n    \"subprocess\",\n    \"mcp\",\n    \"run\",\n   \"<global path of the repo>/hyprmcp/hyprmcp/server.py\"\n  ],\n  \"env\": {\n    \"PYTHONPATH\": \"<global path of the repo>/hyprmcp\",\n    \"HYPRLAND_INSTANCE_SIGNATURE\": \"<your-hyprland-instance-signature>\"\n  }\n},\n```\n\n## 🧰 Available Tools\n\n| Tool Name             | Description                                       |\n|-----------------------|---------------------------------------------------|\n| `run_hyprctl_command` | Executes arbitrary `hyprctl` commands.            |\n| `get_version`     …","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_stefanoamorelli_hyprmcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_stefanoamorelli_hyprmcp","registry":"pypi","observedAt":"2026-09-15T20:21:24.863Z","publishedAt":"2026-01-29T09:00:37.150534Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_stefanoamorelli_hyprmcp","url":"https://pypi.org/project/iflow-mcp_stefanoamorelli_hyprmcp/","firstSeenAt":"2026-09-09T21:24:06.826Z","fetchedAt":"2026-09-15T20:19:49.698Z","normalizedAt":"2026-09-15T20:19:49.698Z"}]},"firstSeenAt":"2026-09-09T21:24:06.826Z","updatedAt":"2026-09-15T20:21:24.863Z"}