SoraMCP
SoraMCP is an MCP server for AI video generation using OpenAI's Sora model via the AceDataCloud API, compatible with clients like Claude, VS Code, and Cursor.
Video Generation
Text-to-Video (
sora_generate_video/sora_generate_video_v2): Generate videos from text prompts, with options for model (sora-2orsora-2-pro), size, orientation, and duration. V2 supports precise pixel-based resolutions (e.g., 1280×720) and shorter durations (4, 8, or 12 seconds).Image-to-Video (
sora_generate_video_from_image): Animate static images or generate videos aligned with a reference image's visual style.Character Video (
sora_generate_video_with_character): Reuse animated/digital characters from a reference video in new scenes (real people not supported).Async Generation (
sora_generate_video_async/sora_generate_video_v2_async): Submit generation tasks that notify a callback/webhook URL on completion, suitable for production workflows.
Task Management
Query Single Task (
sora_get_task): Check status (pending,succeeded,failed) and retrieve video URLs for a specific task.Batch Task Query (
sora_get_tasks_batch): Check the status of multiple tasks at once (up to 50 recommended).
Discovery
List Models (
sora_list_models): View available Sora models with capabilities, limits, and recommended use cases.List Actions (
sora_list_actions): Browse all available API actions and their corresponding tools.
Enables AI video generation using the Sora model, allowing users to create videos from text or images, maintain character consistency across scenes, and customize output orientations and durations.
SoraMCP (retired)
The AceDataCloud Sora integration is retired. Its hosted MCP server and public Sora API endpoints are no longer offered. Installing an older package does not restore access to the retired service.
This directory retains historical source for existing integrations and reference.
Its tool definitions and examples describe the former API, not currently available
capabilities. Do not configure a new connection to sora.mcp.acedata.cloud.
For a supported video workflow, choose a currently published service such as Seedance, Veo, or Kling. Check the selected service's current models, input requirements and pricing; Sora prompts, character references, durations and task IDs are not interchangeable.
Historical tasks are not automatically migrated to another service. Preserve any previously downloaded media and avoid resubmitting a retired task as a new generation.
Historical source development
Offline compatibility tests can be run with pytest -m "not integration".
No deployment or endpoint reactivation is included in this repository's retirement.
Related MCP server: Sora2 MCP
License
MIT License — see LICENSE.
Available Tools
10 toolssora_generate_videoAInspect
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.
Inputs: prompt (required), size, model, duration, +1 more. Returns: result
sora_generate_video_asyncAInspect
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.
Inputs: prompt (required), callback_url (required), size, model, +3 more. Returns: result
sora_generate_video_from_imageAInspect
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.
Inputs: prompt (required), image_urls (required), size, model, +2 more. Returns: result
sora_generate_video_v2AInspect
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.
Inputs: prompt (required), size, model, duration, +1 more. Returns: result
sora_generate_video_v2_asyncAInspect
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.
Inputs: prompt (required), callback_url (required), size, model, +2 more. Returns: result
sora_generate_video_with_characterAInspect
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.
Inputs: prompt (required), character_url (required), size, model, +4 more. Returns: result
sora_get_taskAInspect
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.
Inputs: task_id (required). Returns: result
sora_get_tasks_batchAInspect
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.
Inputs: task_ids (required). Returns: result
sora_list_actionsAInspect
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.
Inputs: no named parameters. Returns: result
sora_list_modelsAInspect
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.
Inputs: no named parameters. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each generation tool targets a distinct input method (text, image, character, v2) and synchronous/asynchronous modes are clearly separated. Descriptions explicitly note differences, so an agent can easily select the appropriate tool.
All tools follow a consistent sora_verb_noun pattern in snake_case (e.g., sora_generate_video, sora_get_task). The version suffixes (_v2) are appended uniformly, maintaining predictability.
With 10 tools, the set is well-scoped for a video generation service. It covers generation variants, status checks, and listing actions/models without being bloated or too sparse.
The tool surface covers generation, status retrieval (single and batch), and informational queries. A minor gap is the lack of a cancellation tool for pending tasks, but it's not critical for core workflows.
Maintenance
Related MCP Connectors
OpenAI Sora: Sora & Sora 2 (new social media like TikTok) API by ChatGPT creator OpenAI. Access.
AI image, video, music and speech generation: text-to-video, image-to-video, effects and upscaling.
Generate images, video, music, voice and 3D through one API. 30 tools, 200+ models.
Image, video, music and text generation across 100+ models through one endpoint.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceIntegrates with OpenAI's Sora 2 API to generate, remix, and manage AI-generated videos from text prompts. Supports video creation, status monitoring, downloading, and remixing through natural language commands.207MIT
- AlicenseAqualityDmaintenanceEnables programmatic creation, management, and remixing of AI-generated videos using OpenAI's Sora API. Supports video generation with customizable parameters, status monitoring, downloading, and video remixing capabilities.66 npm3MIT
- AlicenseAqualityDmaintenanceEnables video generation through OpenAI's Sora 2 API, allowing users to create, monitor, and manage AI-generated videos. It also provides tools for merging video clips and creating fade animations from static images using FFmpeg.615 npm2MIT
- AlicenseAqualityBmaintenanceGoogle Veo AI video generation with text-to-video, image-to-video, multi-image fusion, 1080p upscaling, and multiple quality/speed models.83MIT