Get Test Videos
get_videosGet the videos (tester sessions) of a Userbrain test by its id. Each video is one tester's (participant's) think-aloud screen recording attempting the test's tasks. Always returns the tester and their demographics, device, duration, and their answer to each task step (each labeled by its teststep id, e.g. teststep #1065502 — call the get_tasks tool to see what those teststeps actually ask; it returns the test's currently active teststeps with their ids). To keep responses small, the heavy per-session detail is omitted by default: set includeNotesAndClips to also return the notes and clips (observations), and includeTranscript to also return the full think-aloud transcript. Enable these only when that detail is actually needed for the task. Returns text and structured data (no interactive UI). Use list_tests first to find the testId.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"testId": "<testId>"
},
"name": "get_videos"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| testId | Yes | The numeric id of the test (from list_tests). | |
| includeTranscript | No | Include each video's full think-aloud transcript (can be hundreds of lines per video). Off by default. Set true only when the verbatim transcript is actually needed — e.g. quoting exactly what a tester said. | |
| includeNotesAndClips | No | Include each video's notes and clips — the AI-generated and manual observations on the session. Off by default because it makes the response much larger. Set true only when the detailed observations are actually needed (e.g. summarizing findings or quoting specific moments). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| testId | Yes | ||
| videos | Yes |