Hailuo MCP server

HailuoMCP

<!-- mcp-name: io.github.AceDataCloud/mcp-hailuo -->

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

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

Features

• Text to Video - Create AI-generated videos from text prompts
• Image to Video - Generate videos from reference images
• Director Mode - Image-to-video with enhanced creative control
• Multiple Models - Support for minimax-t2v, minimax-i2v, minimax-i2v-director
• Task Tracking - Monitor generation progress and retrieve results

Tool Reference

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://hailuo.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://hailuo.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/claudedesktopconfig.json on macOS):

{
  "mcpServers": {
    "hailuo": {
      "type": "streamable-http",
      "url": "https://hailuo.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": {
    "hailuo": {
      "type": "streamable-http",
      "url": "https://hailuo.mcp.acedata.cloud/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN"
      }
    }
  }
}

VS Code (Copilot)

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

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

Or install the Ace Data Cloud MCP extension for VS Code, which registers the hosted MCP servers with one-click setup.

JetBrains IDEs

1. Go to Settings → Tools → AI Assistant → Model Context Protocol (MCP)
2. Click Add → HTTP
3. Paste:

Shortened. The full README is on GitHub.