# Stitch videos (`stitch_videos`)
> Combines clips from one or more videos into a single video, played back to back, as picture-in-picture overlays, or both.
- Area: [Studio editing](https://mcp.dadan.io/tools/studio-editing.md)
- Access: Makes changes; has an irreversible path, so clients ask to confirm (the explicit overwrite_original:true path irreversibly replaces the original's render)
- AI credits: yes
- Available on read-only connections: no

## Example prompt
"Stitch my intro clip and my demo clip into one video"

## Parameters
- `video_id` (string, required): The primary/base video's guid — also the default source for segments without a video_id.
- `segments` (object[], required): The clips to compose, in order: {video_id?, start_seconds, end_seconds, overlay?, at_seconds?, overlay_position?, overlay_scale?}. At least one.
- `aspect_ratio` (string): Canvas aspect ratio for the composition, e.g. '16:9' or '9:16'. Omit to keep the base video's.
- `overwrite_original` (boolean): true = OVERWRITE the original video's render in place (irreversible). Default false = renders a NEW copy, original untouched.

## Description for AI assistants
Stitch clips from one or more videos into a single video — sequential concatenation and/or picture-in-picture overlays. video_id is the primary/base video; each segment takes its own video_id (defaults to the base), start_seconds/end_seconds in SECONDS, and optionally overlay: true with at_seconds (timeline placement), overlay_position (bottom-right, bottom-left, top-right, top-left, center, fullscreen) and overlay_scale (0–1, e.g. 0.25). overwrite_original default false = renders a NEW copy, original untouched; true OVERWRITES the original's render. Returns a processing job — poll get_job_status; rendering takes a while.
Canonical page: https://mcp.dadan.io/tools/stitch-videos
