REC 00:00:00;00
screencast-mcp Tools Workflows Connect GitHub ↗

SCREENCAST-MCP / TOOLS / PRODUCE

Add Callouts

callout

Annotate a video with timed boxes, text labels, and arrows. Fallback fonts used are listed in fallbackFonts; characters no font covers are reported in warnings.

producewritesdestructivesince v0.21.0

00:00PARAMETERS
NameTypeDescription
input requiredstringPath to the source video.
items requiredobject[]Boxes, text labels, and arrows, drawn in order (later on top), in video pixels. Each shows from..to seconds (default: whole video); color is a name, #RRGGBB, or name@alpha. at least 1 items, at most 50 items
items[box].x requirednumber
items[box].y requirednumber
items[box].width requirednumber > 0
items[box].height requirednumber > 0
items[box].thicknessnumberOutline px (default 4). > 0
items[box].fillbooleanFill instead of outline.
items[box].fromnumber ≥ 0
items[box].tonumber > 0
items[box].colorstring
items[text].x requirednumber
items[text].y requirednumber
items[text].text requiredstring
items[text].sizenumberFont size px (default 32). > 0
items[text].backgroundbooleanDark panel behind the text (default true).
items[text].fromnumber ≥ 0
items[text].tonumber > 0
items[text].colorstring
items[arrow].x1 requirednumber
items[arrow].y1 requirednumber
items[arrow].x2 requirednumberHead (x2,y2) is the point the arrow points at.
items[arrow].y2 requirednumber
items[arrow].thicknessnumberShaft px (default 8). > 0
items[arrow].fromnumber ≥ 0
items[arrow].tonumber > 0
items[arrow].colorstring
fontFilestringFont: a .ttf/.otf/.ttc path or a C:\Windows\Fonts file name. Default: bundled Inter, with a covering system font for scripts it lacks (CJK, emoji, Arabic, ...).
outputstringOptional output path. Defaults under SCREENCAST_HOME/edits.
overwritebooleanAllow replacing an existing file at the output path (default false).
00:05A MINIMAL CALL
callout {
  "input": "recording.mp4",
  "items": [
    {
      "type": "box",
      "x": 1,
      "y": 1,
      "width": 1,
      "height": 1
    }
  ]
}

The required arguments only, with placeholder values. Everything else takes its default.

00:10WHAT COMES BACK

Structured content (structuredContent), alongside a text summary:

FieldTypeDescription
outputPath alwaysstringPath of the file written.
00:15SEEN IN