Mcp Screenshot
Capture Wayland screenshots from your agent using grim and slurp for full-screen, regional, or interactive crops while debugging UI on Linux.
Overview
Screenshot MCP is a MCP server for the Build phase that captures Wayland screenshots via grim and slurp in full-screen, region, or interactive crop modes.
What is this MCP server?
- Wayland screenshots via grim and slurp
- Full screen, fixed region, or interactive crop modes
- stdio PyPI package mcp-screenshot
- Requires WAYLAND_DISPLAY (e.g. wayland-1)
- Requires XDG_RUNTIME_DIR for compositor socket lookup
- MCP server version 1.0.1
- stdio transport via PyPI identifier mcp-screenshot
- Depends on grim and slurp on Wayland
What problem does it solve?
Agents on Wayland Linux cannot see your UI regressions or share reproducible screenshots without a compositor-native capture tool wired into MCP.
Who is it for?
Indie devs on Wayland who want local screenshot evidence in agent loops without standing up browser automation infrastructure.
Skip if: macOS or Windows workflows, headless CI without a Wayland session, or teams needing cross-browser cloud capture.
What do I get? / Deliverables
After configuring Wayland env vars and MCP stdio, your agent can attach PNG screenshots of the desktop or selected regions to debugging threads.
- PNG screenshots attached to agent conversations
- Region or interactive crops for targeted UI checks
- Faster visual bug reproduction on Wayland
Recommended MCP Servers
Journey fit
Screenshot capture supports visual verification and bug reports during product development on Wayland desktops. Agent-tooling fits MCP servers that give the coding agent eyes on the local compositor rather than a cloud browser farm.
How it compares
Local Wayland grim/slurp MCP, not Playwright-style web browser automation.
Common Questions / FAQ
Who is Screenshot MCP for?
Linux Wayland users who want Claude Code, Cursor, or Codex agents to capture desktop screenshots during UI work.
When should I use Screenshot MCP?
Use it during Build agent-tooling or Ship testing when you need visual proof from the local compositor while fixing layout or desktop app bugs.
How do I add Screenshot MCP to my agent?
Install mcp-screenshot from PyPI, ensure grim and slurp are on PATH, set WAYLAND_DISPLAY and XDG_RUNTIME_DIR for the agent process, and register stdio MCP.