SCREENCAST-MCP / TOOLS / CAPTURE
Read Input Events
read_events
Read the input events (clicks, scroll, cursor, shortcuts, typing bursts) of a recording made with events: true, in video seconds and pixels; e.g. types: ['down'], then sample_frames there.
captureread-onlyidempotentsince v0.28.0
00:00PARAMETERS
| Name | Type | Description |
|---|---|---|
sessionId | string | Session id of a recording started with events: true. |
input | string | Or a recording path, or its .events.jsonl. |
from | number | Earliest video second. ≥ 0 |
to | number | Latest video second. ≥ 0 |
types | ("down" | "up" | "move" | "wheel" | "key" | "typing" | "gap")[] | down/up (mouse buttons; clicks are down), move (sampled cursor), wheel, key (shortcut), typing (burst), gap (events may be missing). |
inFrameOnly | boolean | Drop events whose cursor was outside the recorded area. |
limit | integer | Most events to return (default 200). ≥ 1, ≤ 5000 |
00:05A MINIMAL CALL
read_events {}The required arguments only, with placeholder values. Everything else takes its default.
00:10WHAT COMES BACK
Structured content (structuredContent), alongside a text summary:
| Field | Type | Description |
|---|---|---|
eventsPath always | string | |
total always | integer | ≥ -9007199254740991, ≤ 9007199254740991 |
matched always | integer | ≥ -9007199254740991, ≤ 9007199254740991 |
returned always | integer | ≥ -9007199254740991, ≤ 9007199254740991 |
summary always | object |
00:15SEEN IN