Tools
MCP tools
| Tool | Purpose |
|---|---|
userplane_list_workspaces | Resolve workspace for the recording |
userplane_list_projects | Resolve project when named in a description |
userplane_list_recordings | Search recordings by filters |
userplane_get_rec_info | Recording metadata (status, duration, expiry) |
userplane_get_rec_console | Browser console logs |
userplane_get_rec_network | Network requests and responses |
userplane_get_rec_actions | User interactions (clicks, navigations) |
userplane_show_recording | Interactive recording viewer |
userplane_get_link | Recording link details |
userplane_get_profile | Authenticated user profile |
Code tools
| Tool | Purpose |
|---|---|
| Read | Read repo files for code cross-referencing |
| Grep | Search code for functions mentioned in stack traces |
Skills loaded
userplane-web-sdk— SDK API for interpreting recording behavioruserplane-metadata-sdk— metadata API for understanding session context
Workflow
Phase 1 — Resolve:- Recording ID input: calls
userplane_list_workspacesto resolve the workspace, thenuserplane_get_rec_infoto confirm the recording exists. - Description input: searches via
userplane_list_recordingswith inferred filters (created_by,project_id,link_id), narrows to 1–3 candidates, confirms with the user.
- Fetches recording info — status, duration, link, project, expiry.
- Fetches console logs, network requests, and user actions in parallel.
- Builds a correlated timeline — interleaves events by timestamp.
- Identifies the failure point — quotes the exact console line or network row.
- Cross-references with repo code via Read / Grep when accessible.
- Reports: Summary → Timeline → Root cause → Fix.
Hard rules
- Never fetches session data before confirming which recording.
- Fetches console, network, and actions in parallel but filters to the failure window.
- Does not speculate beyond evidence — “unclear from the recording” is valid.
- Respects
expiresAt— reports expired recordings and stops.
Related articles
- /userplane:debug — the command that invokes this agent.
- MCP Servers — the bundled workspace MCP server.
- Recording Tools — reference for the recording MCP tools.
- MCP Apps — interactive viewers the agent can render.