# mcp-sora

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add acedatacloud-mcp/mcp-sora

# Browse available tools
npx -y @smithery/cli@latest tool list acedatacloud-mcp/mcp-sora

# Get full schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-sora sora_list_models

# Call a tool
npx -y @smithery/cli@latest tool call acedatacloud-mcp/mcp-sora sora_list_models '{}'
```

## Direct MCP Connection

Endpoint: `https://mcp-sora--acedatacloud-mcp.run.tools`

**Required config:**
- `x-api-key` (header) — AceDataCloud API Bearer Token (get from https://platform.acedata.cloud)

## Tools (10)

- `sora_list_models` — List all available Sora models and their capabilities.
- `sora_list_actions` — List all available Sora API actions and corresponding tools.
- `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_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.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get acedatacloud-mcp/mcp-sora <tool-name>
```

## Prompts (3)

- `sora_video_generation_guide` — Guide for choosing the right Sora tool for video generation.
- `sora_workflow_examples` — Common workflow examples for Sora video generation.
- `sora_prompt_writing_guide` — Prompt writing guide for best Sora video results.