io.github.AceDataCloud/mcp-hailuo

Generate AI video from a text prompt using Hailuo (MiniMax). This is the simplest way to create video - just describe what you want and Hailuo will generate a high-quality AI video. Use this when: - You want to create a video from a text description - You don't have reference images - You want quick text-to-video generation For using a reference image, use hailuo_generate_video_from_image instead. Returns: Task ID and generated video information including URLs and status.

Generate AI video from a reference image using Hailuo (MiniMax). This allows you to create a video based on a reference image. Hailuo will animate the image content according to your text prompt. Use this when: - You have a specific image you want to animate - You want to create a video based on visual content - You need image-to-video generation The first_image_url parameter is required for this tool. Returns: Task ID and generated video information including URLs and status.

Query the status and result of a video generation task. Use this to check if a generation is complete and retrieve the resulting video URLs and other metadata. Use this when: - You want to check if a generation has completed - You need to retrieve video URLs from a previous generation - You want to get the full details of a generated video Task states: - 'pending': Generation is still in progress - 'completed': Generation finished successfully - 'failed': Generation failed (check error message) Returns: Task status and generated video information including URLs and status.

Query multiple video generation tasks at once. Efficiently check the status of multiple tasks in a single request. More efficient than calling hailuo_get_task multiple times. Use this when: - You have multiple pending generations to check - You want to get status of several videos at once - You're tracking a batch of generations Returns: Status and video information for all queried tasks.

List all available models for Hailuo video generation. Shows all available model options with their descriptions and use cases. Use this to understand which model to choose for your video. Returns: Table of all models with their descriptions and use cases.

List all available Hailuo API actions and corresponding tools. Reference guide for what each action does and which tool to use. Helpful for understanding the full capabilities of the Hailuo MCP. Returns: Categorized list of all actions and their corresponding tools.