Agent Viewport — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited Agent Viewport (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
AgentViewport is a bridge tool that turns your local desktop into a browser-based viewport and an MCP (Model Context Protocol) Server. It enables AI agents (like Claude Desktop, Cursor, or custom agents) to "see" your screen and interact with it (click, type, drag) via a standardized protocol using their embedded browser tools.
<img src="icon.png" width="200" alt="AgentViewport Icon" />
get_screenshot, mouse_click, key_type, and more to AI agents.http://localhost:3000 for remote viewing or debugging..exe with bundled dependencies. git clone https://github.com/guybnd/agent-viewport.git
cd agent-viewport npm install npm start npm install npm run build node copy_assets.jsdist folder: .\dist\AgentViewport.exe[!IMPORTANT] The dist folder contains three items that must stay together:>
-AgentViewport.exe- The main executable -vendor/- Native modules required at runtime -icon.png- Tray icon
>
If you move the executable, move the entire dist folder contents together.To let Claude "see" your computer, add AgentViewport to your claude_desktop_config.json:
Windows Config Location: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"agent-viewport": {
"command": "node",
"args": ["C:\\path\\to\\agent-viewport\\server.js"]
}
}
}If using the built .exe:
{
"mcpServers": {
"agent-viewport": {
"command": "C:\\path\\to\\AgentViewport.exe",
"args": []
}
}
}A configuration file is automatically created at %AppData%\AgentViewport\agent-viewport.config.json. You can modify:
port: Web server port (Default: 3000)targetWidth: Screenshot resizing width (Default: 2560)fps: Streaming FPS (Default: 10)jpegQuality: Compression quality (Default: 70)| Tool Name | Description | Arguments |
|---|---|---|
get_screenshot | Returns a base64 encoded JPEG of the main screen. | None |
list_monitors | Returns screen resolution. | None |
mouse_click | Click at x, y. | x, y, button (left/right) |
mouse_drag | Drag from current pos to x, y. | x, y |
key_type | Type text or press keys. | text, key |
[!CAUTION] Use with Caution: Giving an AI agent access to your screen and input controls (mouse/keyboard) is a high-privilege action. Always monitor the agent's activity in real-time. Do not leave the agent unattended while it has control over your session.
localhost:3000 by default. It is not accessible from the internet unless you explicitly use a tunnel or port forwarding.stdio (Standard Input/Output), which is a local-only transport managed by your AI client (e.g., Claude Desktop).server.js to see exactly how screenshots are captured and how mouse/keyboard inputs are handled.| Issue | Solution |
|---|---|
| Port 3000 in use | Change port in %AppData%\AgentViewport\agent-viewport.config.json or close the conflicting app |
| Clicks not registering | Make sure you're clicking inside the video area, not the letterboxed margins |
| Build fails with EPERM | Close the running AgentViewport.exe (via tray or Task Manager) before rebuilding |
| Native module errors | Delete node_modules and dist, then run npm install and rebuild |
| Tray icon not appearing | Check the system tray overflow area (^ arrow in taskbar) |
This project is made possible by these incredible open-source libraries:
MIT
~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.