# Glasswarp MCP server

Eyes and hands on real Windows PCs — observe, click, type via Glasswarp API.

## Links
- Registry page: https://www.getdrio.com/mcp/com-glasswarp-mcp-server
- Repository: https://github.com/glasswarp/mcp-server
- Website: https://www.glasswarp.com/mcp

## Install
- Endpoint: https://mcp.glasswarp.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://mcp.glasswarp.com/mcp
- Header: Authorization

## Tools
- demos.list - List showcase run contracts (id, title, install, command). Read-only catalog — does NOT start a session, touch a rig, or run solvers. Use when the user asks for Minesweeper/Mona Lisa/Paint demos or you need the glasswarp-demo command. Prefer demos.get for one full card. For ad-hoc UI work use rigs.list → session.start → screen.observe instead. Endpoint: https://mcp.glasswarp.com/mcp
- demos.get - Return one showcase run contract (install, command, needs, framing). Does NOT execute the demo or control a PC. Call after demos.list when you know the demo_id. If the client can run shell, offer the command; if chat-only, show the card. Do not replace this with a slow MCP click loop for solver demos. Endpoint: https://mcp.glasswarp.com/mcp
- rigs.list - List Windows machines (rigs) paired to this API key: id, name, online, api_access_enabled, and USABLE flag. Read-only — does not start a session. Call first before start_session. A rig is USABLE only when online AND the owner enabled API access. If none are USABLE, tell the user to install the host agent, pair in Console → Rigs, and enable API access — never ask for OS passwords. Endpoint: https://mcp.glasswarp.com/mcp
- session.start - Start a metered desktop session on a USABLE rig from rigs.list. Side effects: begins wall-clock billing, shows an on-screen “API session active” indicator, enables observe/input until session.end. Idle sessions auto-end after ~15 minutes. Always call session.end when done or abandoning. Do not call if no USABLE rig exists. Returns session_id and Live View URL (owner console login required). Endpoint: https://mcp.glasswarp.com/mcp
- session.end - End an active session. Side effects: stops billing, runs host safety_restore, closes apps launched via app.launch. Always call when finished or abandoning — do not leave sessions open. Safe to call once; further observe/input on that session_id will fail. Endpoint: https://mcp.glasswarp.com/mcp
- screen.observe - Read the current screen: UIA targets (numbered ids + native coords) and a text summary. Does not move mouse/keyboard. Default image=false (no JPEG) for speed; set image=true only when you must judge pixels visually (then max_width≈960, quality≈60). If changed=false, JPEG is omitted even when requested — do not re-analyze; wait or act differently. If dirty is null, assume changed. Prefer input.send_actions for multi-step UI; observe after meaningful steps, not after every click. Target ids are valid only until the next UI change. Endpoint: https://mcp.glasswarp.com/mcp
- input.click_target - Left/right/middle-click a UIA target by id from the latest screen.observe (uses native center coords). Prefer over input.click_xy. Side effect: real mouse click on the remote Windows desktop. Do not reuse target_id after the screen may have changed — re-observe first. For click→type→keys sequences, use input.send_actions (one turn) instead of chaining this tool. Endpoint: https://mcp.glasswarp.com/mcp
- input.click_xy - Click at native screen coordinates (0…native_width-1, 0…native_height-1 from screen.observe). Last resort when no suitable UIA target exists — prefer input.click_target. Never use JPEG/downscaled pixel coords. Side effect: real mouse click on the remote desktop. Endpoint: https://mcp.glasswarp.com/mcp
- input.type_text - Type a Unicode string into the currently focused control via native input. Does not click first — focus the field (input.click_target / input.send_actions) before calling. Side effect: keystrokes on the remote desktop. For form fills (click → type → tab/enter), prefer input.send_actions in one call. Endpoint: https://mcp.glasswarp.com/mcp
- input.send_keys - Send a key or chord to the focused window (e.g. enter, tab, ctrl+s, alt+f4, win). Side effect: real key events on the remote desktop. Prefer bundling into input.send_actions when the shortcut follows a click/type in the same planned sequence. Use input.type_text for literal strings, not this tool. Endpoint: https://mcp.glasswarp.com/mcp
- input.drag - Press-move-release mouse drag in native capture coordinates. Use for drawing, sliders, selection boxes, and drag-and-drop. Side effect: mouse_down → moves → mouse_up on the remote desktop. Prefer input.send_actions if the drag is one step in a longer predictable sequence. Endpoint: https://mcp.glasswarp.com/mcp
- input.scroll - Move the cursor to native (x,y) then apply a vertical mouse-wheel delta. Side effect: scroll on whatever is under that point. Negative delta scrolls toward the bottom of the page. Prefer input.send_actions when scroll is part of a multi-step sequence. Re-observe after scrolling lists/pages before clicking targets. Endpoint: https://mcp.glasswarp.com/mcp
- input.send_actions - PREFERRED multi-step tool: run 1–10 predictable UI actions in one call (input.click_target, input.click_xy, input.type_text, input.send_keys, input.drag, input.scroll). Side effects: all actions execute on the remote desktop; fails fast before sending if any action is invalid. observe_after defaults true (verification observe: text+targets; set observe_image=true for JPEG). Do not batch across unpredictable waits (page loads, installers, modals) — single-step those. Prefer this over chaining solo click/type/keys tools. Endpoint: https://mcp.glasswarp.com/mcp
- app.launch - Launch an executable on the remote Windows rig (name on PATH or absolute path), optional args. Side effects: starts a process; Glasswarp tracks it and closes it on session.end. Use for notepad.exe, mspaint.exe, chrome with URL args, etc. Wait/re-observe after launch before clicking — do not assume the window is focused immediately. Endpoint: https://mcp.glasswarp.com/mcp
- session.live_view - Return the console Live View URL (≈60fps) for the rig owner to watch and intervene. Read-only for the agent — does not grant the API key console access. Offer on long or sensitive tasks. Owner must be signed into Glasswarp; API keys alone cannot open the player. Endpoint: https://mcp.glasswarp.com/mcp
- session.status - Fetch session metadata: status, host, mode, created_at, action_count, billed_minutes. Read-only — no input side effects. Use to tell the user about metered time or confirm the session is still active before more actions. Endpoint: https://mcp.glasswarp.com/mcp

## Resources
- glasswarp://guide/ways-to-run-agents - How to run agents on a rig: short tasks direct via MCP; longer tasks — offer a scaffolded SDK agent when the client can run code, never impose it. MIME type: text/markdown
- glasswarp://guide/assist-showcase-build - Alias of glasswarp://guide/ways-to-run-agents. MIME type: text/markdown
- glasswarp://guide/mcp-vs-sdk - Alias of glasswarp://guide/ways-to-run-agents. MIME type: text/markdown
- glasswarp://demos - Catalog of showcase run contracts (install + command). Use demos.get for a full card. MIME type: text/markdown
- glasswarp://demos/minesweeper - Run contract: Minesweeper — glasswarp-demo minesweeper MIME type: text/markdown
- glasswarp://demos/mona-lisa - Run contract: Mona Lisa (Paint) — glasswarp-demo mona-lisa MIME type: text/markdown
- glasswarp://demos/paint - Run contract: Paint mark — glasswarp-demo paint MIME type: text/markdown
- glasswarp://demos/notepad - Run contract: Notepad (UIA) — glasswarp-demo notepad MIME type: text/markdown

## Prompts
- best_practices - Ways to run agents Short → MCP; longer → offer scaffold when code-capable (never impose). Chat-only stays on MCP. Read before Minesweeper/Mona Lisa.
- demo_mona_lisa - Demo: Mona Lisa (demos.get → glasswarp-demo) Showcase lane: demos.get mona-lisa, then run glasswarp-demo. MCP Assist for preflight only. Arguments: notes
- demo_minesweeper - Demo: Minesweeper (demos.get → glasswarp-demo) Showcase lane: demos.get minesweeper, then run glasswarp-demo. Deterministic loop as brain. Arguments: notes

## Metadata
- Owner: com.glasswarp
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 25, 2026
- Source: https://registry.modelcontextprotocol.io