VideoGen

Generate an animated motion graphic video from a text prompt. Best for precise text animations (typing effects, kinetic typography, lower thirds) that stock or generated footage can't express. Outputs a transparent WebM overlay by default; set transparentBackground to false for an opaque MP4. Optionally pass reference media file ids to display or animate. Typically takes 2–5 minutes because VideoGen writes animation code and then renders it; complex prompts can take longer. Tell the user that wait before starting and keep polling calmly — a healthy in-progress job is expected.

generate_motion_graphic

Generate a music track from a text prompt. Typically takes 1–5 minutes depending on track length. Tell the user that wait up front.

generate_music

Generate a sound effect from a text prompt.

generate_sound_effect

Generate a video clip from a text prompt, source images, source videos, spokenDialogue, or reference audio. quality is optional (LOW, STANDARD, HIGH, or MAX). Typically takes 1–3 minutes (HIGH/MAX can be longer). Tell the user that wait up front and keep polling calmly.

generate_video_clip

Fetch the account and team behind the API key (`apiKeyId`, `apiKeyNickname`, `email`, `displayName`, `teamId`). Use it as a connection test.

get_me

Build a VideoGen app URL that opens a non-billing modal or navigates after the user signs in (invite teammates, submit feedback, integrations, account settings, or a NAVIGATE destination). Prefer this when the user needs to complete something in the VideoGen UI that MCP tools cannot do inline. For credits or plan access issues, do not use this tool: tell the user to open https://app.videogen.io and manage their VideoGen account. Return the url to the user so they can open it.

get_app_deep_link

Fetch one entity by id, including its reference images. Built-in catalog entities are included and have isBuiltIn true.

get_entity

Fetch a file by id with freshly hydrated (non-expired) signed URLs for its thumbnail, preview, and download renditions. Set wait: true to poll until the file finishes processing — use this right after PUTting bytes to a create_file_upload URL.

get_file

Fetch metadata and the shareable URL for a single project.

get_project

Fetch the current status of a project export. Poll until status is succeeded, failed, or cancelled.

get_project_export

Fetch the current status and results of a single tool execution.

get_tool_execution

Fetch the current status and result of a single workflow run.

get_workflow_run

How to authenticate, verify with get_me, introduce VideoGen with workflow example prompts, choose workflows vs media tools, and follow VideoGen id conventions. Call when connecting, onboarding, the user asks what VideoGen can do, or how to set up the API or MCP. Equivalent to reading the `guidance://getting-started` MCP resource — provided as a tool for clients that don't read resources directly.

get_getting_started_guidance

Add 3D parallax motion to a still image, producing a video.

image_3d_effect

List built-in actors, products, visual styles, and slideshow themes plus team entities. Built-in rows have isBuiltIn true and cannot be updated or archived. Filter with entityType when you only need one kind.

list_entities

List files visible to the current API key.

list_files

List supported languages for narration and captions.

list_languages

List the status of remix actions applied to a project.

list_project_remix_actions

List projects. API-created projects only by default; pass includeUiProjects to also include dashboard projects.

list_projects

List available text-to-speech voices for narration, text_to_speech, and workflows.

list_tts_voices

List past tool executions, most recent first.

list_tool_executions

List workflow runs, most recent first.

list_workflow_runs

Open an in-chat file uploader (ChatGPT only). The user picks a file, it is uploaded to VideoGen, and its file id (vg_file_...) is reported back for use in voiceover_to_video, slideshow_to_video, logos, or B-roll. Prefer this over asking the user to paste a link. On clients without in-chat UI, use upload_file (small files) or create_file_upload (large files) instead.

open_uploader

Generate one short AI video clip from a prompt inside an editable project.

prompt_to_video_clip

Apply curated edits to an existing project. Poll with list_project_remix_actions for status.

remix_project

Detach a reference image from an entity by file id. Built-in entities cannot have references removed.

remove_entity_reference

Remove the background from an image.

remove_image_background

Remove the background from a video.

remove_video_background

Preferred for narrated / informational / explainer videos from text, especially ~1 minute or longer. Turn a verbatim narration script into an editable video with AI-generated visuals and captions. Prefer this over storyboard_to_video unless the user wants a short shot-directed storyboard. For avatar narration, pass actorEntityId and optionally set avatarQuality.

script_to_video

Build an editable narrated video from an uploaded PDF or slideshow file. Upload the file first with upload_file, then pass its fileId. For avatar narration, pass actorEntityId and optionally set avatarQuality.

slideshow_to_video

Build an editable video from an ordered storyboard (frame-by-frame shot list). Every scene needs a visual prompt and may include spoken words. Much more credit-heavy than script_to_video: use at most 3 scenes unless the user explicitly asks for more. Prefer script_to_video for ~1 minute+ narrated / informational videos. If the user has not named a workflow, ask with pros/cons before calling this.

storyboard_to_video

Convert text into spoken audio using a selectable voice.

text_to_speech

When to use standalone media tools (automatic model routing for a single asset) versus workflows (full editable professional video). Call when choosing between generate_* tools and workflow tools. Equivalent to reading the `guidance://tools-vs-workflows` MCP resource — provided as a tool for clients that don't read resources directly.

get_tools_vs_workflows_guidance

Update an entity's display name and/or description. Built-in entities cannot be updated.

update_entity

Upload a small file (image, logo, or short audio) to VideoGen by passing its base64-encoded contents, and wait until it is processed. Returns the file with its id (vg_file_...) and signed URLs. Use the returned fileId for voiceover_to_video, slideshow_to_video, logos, or B-roll. For large files, use create_file_upload instead.

upload_file

Increase the resolution of an image.

upscale_image

Increase the resolution of a video.

upscale_video

Convert a raster image into a vector (SVG).

vectorize_image

Build an editable video with AI-generated visuals from an uploaded voiceover audio file.

voiceover_to_video

Canonical run → remix → export flow and when to use each workflow tool. Prefer script_to_video for longer narrated / informational videos; keep storyboard_to_video to ≤3 scenes unless the user asks for more. Call before starting a full video project. Equivalent to reading the `guidance://workflows` MCP resource — provided as a tool for clients that don't read resources directly.

get_workflows_guidance