Skip to main content

​
Install

Upgrade pip and retry: python -m pip install -U pip glasswarp. Package page: pypi.org/project/glasswarp. Inside the monorepo you can also use python -m pip install -e sdk/python.
The grounding helpers need Pillow. Install the extra: pip install "glasswarp[grounding]".

​
Auth

GLASSWARP_API_KEY is missing, expired, or invalid. Create a fresh key in Console → API Keys and re-export it. Never hardcode or commit keys.

​
MCP (Claude / Cursor)

See Connect via MCP for full setup.
Use an absolute npx path for your OS with the mcp-remote stdio bridge (macOS Apple Silicon /opt/homebrew/bin/npx, Intel /usr/local/bin/npx, Windows Node.js npx / npx.cmd, Linux typically /usr/bin/npx). Bare npx often fails inside Cursor.app. Details: Connect via MCP.
Usually the MCP server could not reach the Platform API, or the client sent a placeholder key. Confirm the Platform API health endpoint and that GLASSWARP_AUTH is a real gw_* key.
If signal.glasswarp.com (or your configured API base URL) fails to resolve on your machine, flush local DNS or try a public resolver (1.1.1.1 / 8.8.8.8). The MCP server reaches the API from its own network — local DNS only affects tools on your machine.
Host offline or API access off. Start the Windows agent; enable API access per-rig in the console.

​
Rigs and sessions

The host is offline, or API access is off. Open Console → Rigs: confirm the rig is online and toggle API access on. This is the per-rig consent gate.
Verify the host stayed online (check the Console), then retry once. If it recurs, restart the host agent on the Windows machine.
Always end_session in a finally block. End stray sessions from Console → Sessions. safety_restore also runs on disconnect and END_SESSION.

​
Live View

Windows HDR / Advanced Color was on. DXGI capture into the SDR WebRTC stream washes colors; GDI screenshots can still look correct.Glasswarp auto-disables HDR for the API session and restores it when the session ends. If colors are still wrong:
  1. Check Console → Rigs for an amber HDR on badge.
  2. On the Windows machine: Settings → System → Display → HDR → Off.
  3. Rebuild/restart the host agent so auto-disable is present.
Dev opt-out only: CAPTURE_ALLOW_HDR=1. See Live View.

​
Input and vision

Update the Windows host agent — drag primitives require a host build with mouse_down / mouse_up. Current public release: v0.2.21 (Downloads).
Host v0.2.14+ merges popup HWNDs (menus, combo dropdowns) into the UIA snapshot. Confirm Console → Rigs shows v0.2.14 or newer (auto-updates when idle), then reopen the menu and call observe again.
Stop guessing pixels. Use grounding: prefer list_targets / click_target, or Set-of-Mark via observe(mark=True).
Use observe() (frame + dirty + targets) instead of a bare screenshot, and send a Set-of-Mark annotated frame so the model picks a target by id.

​
Still stuck?

Check the API reference for exact request/response shapes, or watch the session live via Live View to see what the host is actually doing.