Seedance 2.5 MCP Server

A focused Model Context Protocol server for generating Seedance 2.5 Preview videos through MuAPI. It exposes the standard Seedance 2.5 workflows with explicit 720p/480p selection, rather than making an assistant search through a large general-purpose model catalog.

The implementation is informed by SamurAIGPT/muapi-mcp-server: it forwards a MuAPI key, keeps generation asynchronous, and provides both an MCP stdio transport and a small HTTP bridge.

📺 Video Tutorial

How to Access Seedance 2.5 API (Step-by-Step Guide) — a full walkthrough of getting an API key and making your first Seedance 2.5 call via MuAPI.

Related Projects

MuAPI Seedance 2.5 — Model landing page and browser playground links for the Seedance 2.5 family.
MuAPI MCP documentation — Hosted MCP setup and tool-use guidance.
MuAPI access keys — Create the API key required by this server.
Seedance-2.5-API — Python wrapper for the Seedance 2.5 API.
Seedance-2-API — Python wrapper covering Seedance 2.0 and Seedance 2 Mini.
seedance2.5-comfyui — Native Seedance 2.5 custom nodes and workflows for ComfyUI.
seedance2-comfyui — Related Seedance 2 custom nodes and workflows.
n8n-nodes-seedance2 — Seedance automation nodes for n8n workflows.
awesome-seedance-2.5-api-prompts — Prompt and camera-control references for Seedance 2.5.
muapi-mcp-server — Broad MuAPI MCP server reference for Claude, Cursor, and other clients.
Open-Generative-AI — Open-source media studio that uses MuAPI for image and video workflows.
awesome-seedance-motion-control-api — Seedance 2 & 2.5 Motion Control API guide — recast a performance video with new performers while preserving motion, camera, and location

Included tools

Tool	Purpose
`seedance_25_text_to_video`	Text-to-video generation at 720p or 480p
`seedance_25_image_to_video`	Animate one input image at 720p or 480p
`seedance_25_first_last_frame`	Transition between exactly two frame images
`seedance_25_omni_reference`	Combine image, video, and audio references
`muapi_predict_result`	Poll a MuAPI prediction by `request_id`
`muapi_account_balance`	Read the MuAPI credit balance

Generation tools return the completed prediction when used over stdio. The HTTP bridge returns a local request ID immediately and exposes the result at /mcp/predictions/{request_id} or as server-sent events.

Quick start

git clone https://github.com/Anil-matcha/seedance-2.5-mcp.git
cd seedance-2.5-mcp
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
export MUAPI_API_KEY=your_muapi_key_here

Run the standards-based stdio server for an MCP client:

python mcp_stdio.py

Run the local HTTP bridge instead:

python mcp_server.py
# http://localhost:8000/docs

MUAPIAPP_API_KEY is accepted as a backwards-compatible alternative. MUAPI_BASE_URL, MUAPI_HTTP_TIMEOUT, MUAPI_POLL_INTERVAL, and MUAPI_POLL_TIMEOUT can be used for local testing or a compatible MuAPI deployment.

Claude Code

With MUAPI_API_KEY exported in the shell used by Claude Code:

claude mcp add seedance-2.5 -- python /absolute/path/to/seedance-2.5-mcp/mcp_stdio.py

Cursor, Windsurf, and Claude Desktop

Copy the mcp.json entry and replace the placeholder path. Keep the API key in the client environment; do not commit it.

{
  "mcpServers": {
    "seedance-2.5": {
      "command": "python",
      "args": ["/absolute/path/to/seedance-2.5-mcp/mcp_stdio.py"],
      "env": {
        "MUAPI_API_KEY": "${MUAPI_API_KEY}"
      }
    }
  }
}

HTTP bridge

The HTTP process is useful for local integrations that need a simple request/poll surface:

curl http://localhost:8000/mcp/tools

curl -X POST http://localhost:8000/mcp/tools/seedance_25_text_to_video/call \
  -H "Authorization: Bearer $MUAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "arguments": {
      "prompt": "A red paper boat drifting through a sunlit forest stream, cinematic camera movement",
      "duration": 5,
      "aspect_ratio": "16:9",
      "resolution": "720p"
    }
  }'

Poll the returned local ID:

curl http://localhost:8000/mcp/predictions/REQUEST_ID
curl -N http://localhost:8000/mcp/predictions/REQUEST_ID/stream

The bridge allowlists all upstream paths and never accepts an arbitrary endpoint URL. Generation and polling consume MuAPI credits according to the selected resolution and workflow.

Model notes

Seedance 2.5 Preview supports clips from 4 to 30 seconds. The standard routes support 720p and the dedicated 480p routes are intended for faster, lower-cost previews. The first/last-frame tool requires exactly two images. Omni reference accepts up to 20 images, 6 video clips, and 6 audio files.

Docker

docker build -t seedance-2-5-mcp .
docker run --rm -p 8000:8000 -e MUAPI_API_KEY="$MUAPI_API_KEY" seedance-2-5-mcp

Development

python -m unittest discover -s tests -v
python -m compileall -q server_core.py mcp_server.py mcp_stdio.py

License

MIT. See LICENSE.