hyprland-mcp

Instructions

Implementation Reference

• hyprland_mcp/server.py:182-190 (handler)

  The toggle_fullscreen tool handler. It calculates the correct flag for hyprctl based on the mode and dispatches the fullscreen command.

  async def toggle_fullscreen(mode: str = "fullscreen") -> str:
      """Toggle fullscreen for the active window.
  
      Args:
          mode: "fullscreen" for real fullscreen, "maximize" for maximized (keeps bar)
      """
      flag = "0" if mode == "fullscreen" else "1"
      await hyprctl.dispatch("fullscreen", flag)
      return f"Toggled {mode}"

• hyprland_mcp/server.py:181-181 (registration)

  The registration decorator for the toggle_fullscreen tool.

  @mcp.tool()