Video Editing & Lifecycle

Prepare Video Upload With Your AI Assistant

Opens the inline upload widget in apps that support it, so you can pick a file from your own device. The file uploads straight from your browser to Dadan.

prepare_upload Makes Changes Plan-Gated Video Editing & Lifecycle
Try Asking
“I want to upload a video file from my laptop”

How It Behaves

Makes changes in your Dadan account, within what your account is allowed to do.

Parameters

NameTypeDescription
titleType: stringTitle for the video in Dadan. Optional.
file_nameType: stringFile name — supplied by the upload widget once the user picks a file. Omit on the first call.
file_size_bytesType: integerFile size in bytes — supplied by the upload widget. Omit on the first call.
duration_secondsType: numberVideo length in seconds (decimals allowed) — supplied by the upload widget when it can read it. Omit if unknown.

You don’t fill these in yourself. Your assistant reads the schema and passes the values from your request.

Description Sent to AI Assistants

Prepare a browser-direct upload into Dadan: opens the inline upload widget (in clients that support MCP Apps) where the user picks a local video file; the bytes then go straight from the browser to Dadan's storage — never through the chat or the gateway. Call it with just an optional title to show the picker; the widget itself calls back with file_name, file_size_bytes and duration_seconds to mint the upload ticket. For uploading from a public URL use upload_video instead. Max 500 MB per file. FALLBACK for agents with shell access to a LOCAL file (when the client can't render the widget or its sandbox blocks browser uploads): call this tool yourself with the file's real file_name + file_size_bytes (and duration_seconds, e.g. from ffprobe, so Dadan shows the right length), then TUS-upload the file to the returned tus_endpoint (e.g. with curl) following the ticket's message; Dadan processes it automatically once the bytes land. VISUAL TOOL: the result renders as an interactive card in the chat in clients that support MCP Apps. Call it whenever the user wants to SEE this — do not answer from prior context. After it returns, reply with ONE short sentence; the card shows the details, so never repeat its titles, links, or stats as text.

Known Limitations

  • Mints a resumable TUS ticket. Bytes go from the caller straight to upload.dadan.io — they never pass through this gateway or the model. Some client sandboxes block the browser upload widget; in that case perform the TUS flow directly.

Good to Know

Does prepare_upload Change Anything in My Dadan Account?

Makes changes in your Dadan account, within what your account is allowed to do.

Does prepare_upload Use AI Credits?

No. It does not spend AI credits.

How Do I Use prepare_upload?

Connect Dadan to your assistant (setup guides) and ask in plain language, for example: “I want to upload a video file from my laptop”. You never type the tool name; your assistant picks it.

Free to Connect

Give Your Assistant Your Video Library

One URL and one sign-in with the Dadan account you already use. No API key, no client secret, nothing to install.

https://mcp.dadan.io/mcp