Skip to main content
Glama

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 tools
sora_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

    A4.3/5.0

    Scored across 10 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers