MCP Wan
MCP server that lets AI clients generate videos from text or images with Wan models
- Platforms
- API, CLI, vscode
- Runs
- Locally or Remotely
- Version
- 2026.11.15.0
- Listing updated
- today
Similar MCP servers
About MCP Wan
MCP Wan is an MCP server for design and media. It can run locally on your machine or as a hosted remote server.
The README describes this as a bridge between MCP-compatible assistants such as Claude or VS Code and the Wan video models, which are reached through the AceDataCloud API rather than run locally. A client can submit a text prompt or a reference image, pick one of five Wan model variants, and choose 480P, 720P or 1080P output.
Generation is asynchronous: a request returns a task that can be polled with the task tools, and batch lookups are supported for several tasks at once. Tools for listing models and resolutions let the assistant check available options before submitting a job.
The server can be used three ways: a hosted endpoint with OAuth sign-in, a hosted endpoint with a Bearer API token, or a local Python process started with the mcp-wan package. Usage on the hosted service is metered, so the README points users to the platform's current pricing before running real jobs.
Install
Run in a terminal
claude mcp add --transport http mcp-wan https://wan.mcp.acedata.cloud/mcpAdd to Settings → Connectors → Add custom connector
https://wan.mcp.acedata.cloud/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-wan": {
"url": "https://wan.mcp.acedata.cloud/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-wan": {
"type": "http",
"url": "https://wan.mcp.acedata.cloud/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-wan": {
"serverUrl": "https://wan.mcp.acedata.cloud/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-wan": {
"type": "http",
"url": "https://wan.mcp.acedata.cloud/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ACEDATACLOUD_API_TOKENAPI token from Ace Data Cloud (https://platform.acedata.cloud)Required
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- wan_generate_video
- Generate AI video from a text prompt using Wan.
- wan_generate_video_from_image
- Generate AI video using a reference image as the starting frame.
- wan_get_task
- Query the status and result of a video generation task.
- wan_get_tasks_batch
- Query multiple video generation tasks at once.
- wan_list_models
- List all available Wan models for video generation.
- wan_list_resolutions
- List all available resolution options.
- wan_list_actions
- List all available Wan API actions and corresponding tools.
What it does
- Text to video
- Creates a video from a written prompt using the wan2.6-t2v or wan3.0-video models.
- Image to video
- Uses a reference image as the starting frame for generated footage.
- Resolution options
- Offers 480P, 720P and 1080P output, with 720P as the default.
- Character transfer
- The wan2.6-r2v model extracts character appearance from reference videos.
- Task status tracking
- Single and batch tools report the progress and result of generation tasks.
- Multiple connection routes
- Supports hosted OAuth, a hosted API token, or a local stdio process.
Good for
- Generating short video clips from a text description inside an AI chat client
- Turning a still reference image into an animated video
- Previewing a shot quickly with the faster image-to-video model before a higher-quality render
- Checking progress of several video jobs in one request
- Building video generation into a VS Code or Cursor coding workflow
MCP Wan FAQ
What license does the server use?
The README states the project is released under the MIT License.
Do I need an account to use it?
Yes. Both the hosted OAuth route and the API token route require an AceDataCloud account, and the local route needs an API token from it.
Which models are supported?
The README lists five models: wan2.6-t2v, wan2.6-i2v, wan2.6-r2v, wan2.6-i2v-flash and wan3.0-video.
Is the hosted service free?
The README says the hosted service is metered and points to the platform's current pricing, without stating a free allowance.
How do I add MCP Wan to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp-wan https://wan.mcp.acedata.cloud/mcp
What are the best alternatives to MCP Wan?
The closest alternatives to MCP Wan are Wan27 MCP — AI Image and Video Generation, Wan30 MCP — Wan 3.0 AI Video Generation, Wan27 MCP — AI Image and Video Generation, MCP Hailuo and MCP Flux Pro.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.