io.github.AceDataCloud/mcp-sora

List all available Sora models and their capabilities. 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.

List all available Sora API actions and corresponding tools. 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.

Query the status and result of a video generation task. 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.

Query multiple video generation tasks at once. 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.

Generate an AI video from a text prompt using 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.

Generate an AI video from reference images using Sora (Image-to-Video). 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.

Generate an AI video featuring a character from a reference video. 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.

Generate an AI video asynchronously with callback notification. 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.

Generate an AI video using Sora Version 2 (partner channel). 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.

Generate an AI video asynchronously using Sora Version 2 with callback. 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.