SoraMCP

A Model Context Protocol (MCP) server for AI video generation using Sora through the AceDataCloud API.

Generate AI videos directly from Claude, VS Code, or any MCP-compatible client.

Features

• Text-to-Video - Generate videos from text descriptions
• Image-to-Video - Animate images and create videos from reference images
• Character Videos - Reuse characters across different scenes
• Async Generation - Webhook callbacks for production workflows
• Multiple Orientations - Landscape and portrait videos
• Task Tracking - Monitor generation progress and retrieve results

Tool Reference

| Tool | Description | |------|-------------| | 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. |

Quick Start

1. Get Your API Token

1. Sign up at AceDataCloud Platform
2. Go to the API documentation page
3. Click "Acquire" to get your API token
4. Copy the token for use below

2. Use the Hosted Server (Recommended)

AceDataCloud hosts a managed MCP server — no local installation required.

Endpoint: https://sora.mcp.acedata.cloud/mcp

All requests require a Bearer token. Use the API token from Step 1.

Claude.ai

Connect directly on Claude.ai with OAuth — no API token needed:

1. Go to Claude.ai Settings → Integrations → Add More
2. Enter the server URL: https://sora.mcp.acedata.cloud/mcp
3. Complete the OAuth login flow
4. Start using the tools in your conversation

Claude Desktop

Add to your config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "sora": {
      "type": "streamable-http",
      "url": "https://sora.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

Cursor / Windsurf

Add to your MCP config (.cursor/mcp.json or .windsurf/mcp.json):

{
  "mcpServers": {
    "sora": {
      "type": "streamable-http",
      "url": "https://sora.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code (Copilot)

Add to your VS Code MCP config (.vscode/mcp.json):

{
  "servers": {
    "sora": {
      "type": "streamable-http",
      "url": "https://sora.mcp.acedata.cloud/mcp",
      "headers": {
        "Aut

... [View full README on GitHub](https://github.com/AceDataCloud/MCPSora#readme)