grim --help && hyprctl clients -j | head -c 20

export GEMINI_API_KEY="your-api-key-here"

{
  "mcpServers": {
    "screen-mcp": {
      "command": "npx",
      "args": ["-y", "screen-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-api-key-here"
      }
    }
  }
}

npx -y screen-mcp

# Or install globally:
npm install -g screen-mcp

screenshot_region(x=100, y=200, width=800, height=600, include_cursor=true)

list_windows()

screenshot_window(window="Spotify")
screenshot_window(window="focused")
screenshot_window(window="0x557ba79b4900")

analyze_image(
  image_path="/tmp/my-screenshot.png",
  prompt="What applications are visible in this screenshot?",
  model="gemini-2.5-flash"
)

analyze_image(
  image="<base64-encoded-image>",
  prompt="Describe what you see in this image.",
  mime_type="image/png"
)

screenshot_and_analyze(
  x=0, y=0, width=1920, height=1080,
  prompt="Count the number of windows open and list their titles.",
  scale=0.5,
  model="gemini-2.5-flash"
)

# Install deps
npm install

# Build
npm run build

# Run
npm start

# Development (recompile on change)
npm run dev