spector-agent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| webgl_session_createA | Create a local debug session and connect to Chrome at the configured browser URL. |
| webgl_session_statusA | Get current session, target binding, and Spector runtime status. |
| webgl_list_targetsA | List Chrome page targets that can be bound for WebGL debugging. |
| webgl_bind_targetA | Bind a page target by targetId, debugSessionId, url+title, or urlPattern. Prefer debugSessionId set via chrome-devtools-mcp. |
| webgl_unbind_targetA | Detach from the currently bound page target. |
| webgl_runtime_installA | Inject Spector.js into the bound page (early + late install). |
| webgl_runtime_statusA | Check Spector injection, canvas, and context status on the bound page. |
| webgl_list_canvasesA | Enumerate WebGL/WebGL2 canvases on the bound page. |
| webgl_select_canvasC | Select the WebGL canvas to capture. |
| webgl_capture_frameA | Capture the next WebGL frame. Auto-connects, binds readiness checks, installs runtime if needed. Returns summary + resource URIs (not full JSON). |
| webgl_capture_sequenceC | Capture a limited sequence of frames (max 5). |
| webgl_list_capturesB | List stored captures, optionally filtered by session. |
| webgl_get_capture_overviewC | Get a stored capture summary and resource URIs. |
| webgl_list_draw_callsB | Paginated list of draw/clear commands for a capture. |
| webgl_get_command_detailsB | Get details for a single command with optional field includes. |
| webgl_list_programsA | List shader programs in a capture. |
| webgl_get_program_detailsC | Get shader sources and link/compile status for a program. |
| webgl_list_texturesC | List textures and upload metadata from a capture. |
| webgl_list_framebuffersC | List framebuffers and attachments from a capture. |
| webgl_get_state_diffC | Get initial vs final GL state differences for a capture. |
| webgl_search_captureB | Search commands by API name, marker, object name, or stack frame text. |
| webgl_run_diagnosticsB | Run deterministic diagnostic rules on a capture (no LLM). Returns findings summary. |
| webgl_get_finding_detailsA | Get full evidence and hypotheses for a diagnostic finding. |
| webgl_diff_capturesB | Semantically compare two captures (findings, programs, draw counts). |
| webgl_generate_reportB | Generate Markdown and/or JSON diagnostic report for a capture. |
| webgl_export_captureB | Export a capture tree (manifest, capture, findings, report) to a directory. |
| webgl_delete_captureB | Delete a stored capture and its artifacts. |
| webgl_cleanup_storeB | Evict captures by TTL, per-session cap, and max store size. |
| webgl_open_capture_viewerB | Return a local file URL for the read-only Capture Viewer pointing at a stored capture. |
| webgl_set_markerA | Set a Spector.js marker string so subsequent captured commands are tagged (stage annotation at any point). |
| webgl_clear_markerA | Clear the current Spector.js marker. |
| webgl_runtime_logA | Write a custom log line into the Spector capture stream (appears as a log command when capturing). |
| webgl_screenshot_canvasB | Immediate canvas.toDataURL screenshot (not a Spector frame). Useful for any-stage visual checks and goal verification. Saves under the current session screenshots/ folder. |
| webgl_read_consoleC | Return recent console API messages collected from the bound page via CDP (log/warn/error). |
| webgl_list_visual_attachmentsA | List Spector VisualState attachment screenshots persisted for a capture (requires capture with includeThumbnails=true, quickCapture=false). |
| webgl_get_visual_attachmentB | Resolve a single FBO/canvas screenshot path for AI inspection (Read tool can open the absolute file path). |
| webgl_capture_commandsB | Spector startCapture for a fixed command count — capture an arbitrary stage without waiting for a full frame boundary. |
| webgl_list_rulesB | List deterministic WebGL diagnostic rule IDs available to webgl_run_diagnostics. |
| webgl_debug_playbookA | Given a URL/goal/symptoms, return a deterministic multi-phase tool sequence for AI automated WebGL debugging (attach → capture → diagnose → fix → verify). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| webgl_triage | Start a WebGL debugging triage loop: bind target, capture, diagnose, inspect top findings. |
| webgl_black_screen | Focused workflow for black / blank WebGL canvas debugging. |
| webgl_verify_fix | Compare before/after captures to verify a WebGL fix. |
| webgl_shader_failure | Diagnose shader compile, program link, and interface failures. |
| webgl_state_corruption | Diagnose leaked depth, color, scissor, viewport, and framebuffer state. |
| webgl_performance_review | Review API-level performance clues without claiming GPU timing. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 39 tools
Most tools have distinct purposes (e.g., capture commands vs frame vs sequence), but some pairs like webgl_list_captures and webgl_get_capture_overview could cause mild confusion without careful reading of descriptions.
All tools follow a consistent 'webgl_verb_noun' pattern in snake_case, with no mixed conventions or ambiguous verb styles.
At 39 tools, the set is far above the typical 3-15 range, making it overwhelming for an agent to efficiently select among them, even though each tool seems justified.
The tool set covers the full lifecycle of WebGL debugging: session management, capture (various modes), inspection (commands, programs, textures), diagnostics, comparison, export, and even a guided playbook.