Hailuo MCP

Hailuo (MiniMax) AI video — text-to-video and image-to-video with director mode.

Generate AI video using MiniMax Hailuo. Includes director-mode camera control for precise framing.

This extension registers the hailuo MCP server with VS Code so GitHub Copilot and any other agent that speaks the Model Context Protocol can call it directly from chat.

Quick Start

1. Install this extension. VS Code registers the hailuo MCP server automatically.
2. Get an API key from Ace Data Cloud (Applications → API Key). New accounts include free trial credit.
3. Open Copilot Chat in agent mode and ask for a video task — the extension prompts for the API key the first time and stores it in the OS keychain via VS Code's SecretStorage.

You can rotate or remove the API key any time from the command palette:

• Hailuo MCP: Set Ace Data Cloud API Key
• Hailuo MCP: Clear Ace Data Cloud API Key

The default config talks to the hosted streamable-HTTP endpoint at https://hailuo.mcp.acedata.cloud/mcp — no Python, no uvx, no local install needed.

VS Code Setup Guide

For the full VS Code walkthrough, see All Ace Data Cloud MCP servers in VS Code. It covers token setup, project-level and user-level mcp.json, Copilot Agent Mode, and using one Ace Data Cloud token across hosted MCP servers.

Example prompts

• "Generate a Hailuo video: a chef tossing a pizza in slow motion, dolly-in shot."
• "Animate https://example.com/sketch.jpg into a 6-second Hailuo clip, pan-right."

Tool Reference

6 tools available via this server.

Pricing

From $0.20 per clip. Free trial credit on sign-up. See full pricing at https://docs.acedata.cloud.

Configuration

This extension implements the mcpServerDefinitionProviders contribution point and registers a single hosted server with VS Code:

Provider id : acedatacloud.hailuo
Server label: Hailuo MCP
Server URL  : https://hailuo.mcp.acedata.cloud/mcp
Transport   : Streamable HTTP
Auth        : Bearer API key from VS Code SecretStorage (or $ACEDATACLOUD_API_TOKEN)

You don't need to edit mcp.json — the extension handles registration and token handling automatically. If you'd rather configure things by hand, the sections below show equivalent mcp.json snippets you can use instead of this extension.

Alternative: manual mcp.json (hosted)

{
  "servers": {
    "hailuo": {
      "type": "http",
      "url": "https://hailuo.mcp.acedata.cloud/mcp",
      "headers": { "Authorization": "Bearer ${input:acedatacloud_api_token}" }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "acedatacloud_api_token",
      "description": "Ace Data Cloud API key",
      "password": true
    }
  ]
}

Alternative: local stdio (no network roundtrip)

For offline dev, air-gapped environments, or pinning to a specific PyPI version, install uv and use:

{
  "servers": {
    "hailuo": {
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-hailuo"],
      "env": { "ACEDATACLOUD_API_TOKEN": "${input:acedatacloud_api_token}" }
    }
  }
}

uvx will download and run the latest mcp-hailuo on demand.

Links

• Hosted endpoint: https://hailuo.mcp.acedata.cloud/mcp
• PyPI package: mcp-hailuo
• Source repository: https://github.com/AceDataCloud/HailuoMCP
• Ace Data Cloud platform: https://platform.acedata.cloud
• MCP documentation: https://docs.acedata.cloud

License

MIT — see LICENSE.