# mcp-sora [Health: Active]

**Category:** 🎥 Multimedia Process  
**Repository:** https://github.com/AceDataCloud/SoraMCP  
**GitHub Stars:** 0  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/mcp-sora-2

## Description
MCP server for OpenAI Sora AI video generation

## Tools
Capabilities this server exposes over MCP:

- **sora_generate_video** — Generate an AI video from a text prompt using Sora.
- **sora_generate_video_from_image** — Generate an AI video from reference images using Sora (Image-to-Video).
- **sora_generate_video_with_character** — Generate an AI video featuring a character from a reference video.
- **sora_generate_video_async** — Generate an AI video asynchronously with callback notification.
- **sora_generate_video_v2** — Generate an AI video using Sora Version 2 (partner channel).
- **sora_generate_video_v2_async** — Generate an AI video asynchronously using Sora Version 2 with callback.
- **sora_get_task** — Query the status and result of a video generation task.
- **sora_get_tasks_batch** — Query multiple video generation tasks at once.
- **sora_list_models** — List all available Sora models and their capabilities.
- **sora_list_actions** — List all available Sora API actions and corresponding tools.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "mcp-sora": {
    "command": "uvx",
    "args": ["mcp-sora"],
    "env": {
      "ACEDATACLOUD_API_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `ACEDATACLOUD_API_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What mcp-sora does

mcp-sora MCP server connects MCP clients to Sora video-generation actions through the AceDataCloud API. It provides tools for creating videos from text prompts, animating reference images, and generating videos that include a character from a reference video. The server also exposes task-status and discovery operations so a client can inspect running jobs and available API capabilities.

The project is listed in the 🎥 Multimedia Process category. It is relevant for agent workflows that need to submit video-generation requests or check the results of previously submitted tasks from an MCP-compatible application.

## How it works

The hosted deployment uses the streamable HTTP endpoint `https://sora.mcp.acedata.cloud/mcp`. Requests use an AceDataCloud API token as a Bearer token. Claude.ai can connect through its OAuth flow, while other documented clients can include the token in their MCP configuration.

A local installation runs through the `mcp-sora` command. It can communicate over stdio for local desktop clients or start an HTTP listener with a selected port. The server sends generation requests to AceDataCloud, and clients can use the task tools to check individual or multiple jobs. Asynchronous generation tools accept a callback-oriented workflow.

## Setup and configuration

For the local package, install `mcp-sora` from PyPI with `pip`, or run it through `uvx`. Set `ACEDATACLOUD_API_TOKEN` before starting the process. The default command runs the server in stdio mode; `mcp-sora --transport http --port 8000` starts HTTP mode.

The README also documents a hosted option that does not require local installation. Configure the MCP URL and an `Authorization: Bearer YOUR_API_TOKEN` header in clients such as Claude Desktop, Cursor, Windsurf, Cline, and other listed MCP applications. Docker self-hosting is documented with the image `ghcr.io/acedatacloud/mcp-sora:latest` and port 8000.

## Tools and capabilities

The mcp-sora MCP server exposes these operations:

- `sora_generate_video` creates a video from a text prompt.
- `sora_generate_video_from_image` creates a video using reference images.
- `sora_generate_video_with_character` uses a character from a reference video.
- `sora_generate_video_async` starts generation with callback notification.
- `sora_generate_video_v2` and `sora_generate_video_v2_async` target Sora Version 2 through the partner channel.
- `sora_get_task` retrieves one task’s status and result.
- `sora_get_tasks_batch` checks several generation tasks at once.
- `sora_list_models` reports available Sora models and their capabilities.
- `sora_list_actions` reports available API actions and their corresponding tools.

The README also identifies landscape and portrait video orientations as supported features, although the supplied tool descriptions do not specify the parameter names used to select them.

## Limitations and notes

The repository README marks the integration as retired and says it is no longer actively offered. That status should be considered before adopting it for a new production workflow. Video generation depends on access to the AceDataCloud API and a valid API token when using the documented token-based setup. The supplied material does not specify pricing, generation quotas, model-specific parameters, callback payloads, or result-retention behavior.

## Getting started with this mcp-sora MCP server
Always refer to the official documentation for the most accurate and up-to-date information.

_Full upstream README: https://allmcps.com/mcp/mcp-sora-2/readme_