mcp-sora

This is the primary way to create videos - describe what you want and Sora
will generate a video matching your description.

Use this when:
- You want to generate a video from a text description
- You don't have reference images
- You want creative AI-generated video content

For image-to-video generation, use sora_generate_video_from_image instead.
For character-based video generation, use sora_generate_video_with_character.

Returns:
    Task ID and generated video information including URLs and state.

This is useful for long-running video generation tasks. Instead of waiting
for the video to complete, you'll receive a callback at your specified URL
when the generation is finished.

Use this when:
- You don't want to wait for the generation to complete
- You have a webhook endpoint to receive results
- You're integrating with an async workflow

The callback will receive a POST request with the same response format
as the synchronous generation tools.

Returns:
    Task ID that you can use to correlate with the callback.

This allows you to animate or create videos based on provided images.
The AI will use the images as visual references for the generated video.

Use this when:
- You have reference images you want to animate
- You want the video to match a specific visual style
- You want to bring static images to life

Returns:
    Task ID and generated video information including URLs and state.

Version 2 offers shorter video durations (4/8/12 seconds) with
precise pixel-based resolution control. This is ideal for quick
video generation with specific resolution requirements.

Use this when:
- You need precise pixel resolution control (e.g., 1280x720)
- You want shorter videos (4, 8, or 12 seconds)
- You want to use the partner channel for generation

For longer videos (10-25 seconds) or character-based generation,
use the version 1 tools (sora_generate_video, etc.) instead.

Returns:
    Task ID and generated video information including URLs and state.

Similar to sora_generate_video_v2 but returns immediately with a task ID.
The result will be POSTed to your callback URL when generation completes.

Use this when:
- You don't want to wait for the generation to complete
- You have a webhook endpoint to receive results
- You're integrating with an async workflow

Returns:
    Task ID that you can use to correlate with the callback.

This allows you to create new videos featuring a specific character
extracted from another video. The character will be placed in the
new scene described by the prompt.

IMPORTANT: The reference video must NOT contain real people.
Only animated or digital characters are supported.

Use this when:
- You want to reuse a character in different scenes
- You're creating a series with the same character
- You want consistent character appearance across videos

Returns:
    Task ID and generated video information including URLs and state.

Use this to check if a generation is complete and retrieve the resulting
video URLs and metadata.

Use this when:
- You want to check if a generation has completed
- You need to retrieve video URLs from a previous generation
- You want to get the full details of a generated video

Task states:
- 'pending': Generation is still in progress
- 'succeeded': Generation finished successfully
- 'failed': Generation failed (check error message)

Returns:
    Task status and generated video information including URLs and state.

Efficiently check the status of multiple tasks in a single request.
More efficient than calling sora_get_task multiple times.

Use this when:
- You have multiple pending generations to check
- You want to get status of several videos at once
- You're tracking a batch of generations

Returns:
    Status and video information for all queried tasks.

Reference guide for what each action does and which tool to use.
Helpful for understanding the full capabilities of the Sora MCP.

Returns:
    Categorized list of all actions and their corresponding tools.

Shows all available model versions with their limits, features, and
recommended use cases. Use this to understand which model to choose
for your video generation.

Returns:
    Table of all models with their version, limits, and features.