Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

MCP (Model Context Protocol) is a model context protocol launched by Anthropic that allows AI models (such as Claude, GPT, etc.) to call external tools through standardized interfaces. With the Seedance MCP Server provided by AceData Cloud, you can directly use ByteDance Seedance to generate AI videos within AI clients like Claude Desktop, VS Code, Cursor, and more.

​
Feature Overview

Seedance MCP Server offers the following core features:
  • Text-to-Video Generation — Generate high-quality videos from text prompts
  • Image-to-Video Generation — Generate videos using images as references (first frame, last frame, reference image modes)
  • Multi-Model Support — Supports various models including Seedance 1.5 Pro, 1.0 Pro, 1.0 Lite, etc.
  • Multiple Resolutions — Supports 480p, 720p, 1080p resolutions
  • Various Aspect Ratios — Supports 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, and other ratios
  • Flexible Duration — Supports video lengths from 2 to 12 seconds
  • Audio Generation — Some models support simultaneous audio generation
  • Task Querying — Monitor generation progress and retrieve results

​
Prerequisites

Before use, you need to obtain an AceData Cloud API Token:
  1. Register or log in at AceData Cloud Platform
  2. Navigate to the Seedance Videos API page
  3. Click “Acquire” to get your API Token (first-time applicants receive free quota)

​
Installation and Configuration

pip install mcp-seedance

​
Method 2: Source Installation

git clone https://github.com/AceDataCloud/MCPSeedance.git
cd MCPSeedance
pip install -e .
After installation, you can start the service using the mcp-seedance command.

​
Using in Claude Desktop

Edit the Claude Desktop configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration: 
{
  "mcpServers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
If using uvx (no need to pre-install packages): 
{
  "mcpServers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
Save the configuration and restart Claude Desktop. You can then use Seedance-related tools in conversations.

​
Using in VS Code / Cursor

Create .vscode/mcp.json in the project root directory: 
{
  "servers": {
    "seedance": {
      "command": "mcp-seedance",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}
Or use uvx: 
{
  "servers": {
    "seedance": {
      "command": "uvx",
      "args": ["mcp-seedance"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "your API Token"
      }
    }
  }
}

​
Available Tools List

Tool NameDescription
seedance_generate_videoGenerate video from text prompt
seedance_generate_video_from_imageGenerate video using image as reference
seedance_get_taskQuery single task status
seedance_get_tasks_batchBatch query task statuses
seedance_list_modelsList all available models and their capabilities
seedance_list_resolutionsList available resolutions and aspect ratios
seedance_list_actionsList all available tools and workflow examples

​
Usage Examples

After configuration, you can directly invoke these features in AI clients using natural language, for example:
  • “Help me generate a city street time-lapse video using Seedance”
  • “Use this photo as the first frame to generate an 8-second video”
  • “Generate a 1080p vertical 9:16 short video”
  • “Generate a video with audio using the Seedance 1.5 Pro model”

​
More Information