MiniMax H3 MCP

Name: MinimaxMCP
Author: acedatacloud

Model Context Protocol server for MiniMax H3 multimodal video generation through AceDataCloud.

Capabilities

Text-to-video
Image-, video-, and audio-guided video generation
4–15 second output in 768P or 2K, with adaptive, landscape, portrait, and square ratios
Optional asynchronous submission, task retrieval, batch retrieval, and deletion
Hosted OAuth HTTP transport and local stdio transport

Tools

Tool	Purpose
`minimax_generate_video_from_text`	Generate from a detailed prompt
`minimax_generate_video_from_images`	Generate from one to nine image URLs
`minimax_generate_video_from_audio`	Generate with one to three audio URLs and required images
`minimax_generate_video`	Generate from the full documented content schema
`minimax_list_tasks`	List tasks with optional timestamp filters
`minimax_get_task`	Retrieve one task
`minimax_get_tasks_batch`	Retrieve several tasks
`minimax_delete_task`	Delete one task
`minimax_list_models`	Show model constraints
`minimax_list_actions`	Show available workflows

Hosted server

https://minimax.mcp.acedata.cloud/mcp

The hosted server supports AceDataCloud OAuth. MCP clients that support remote OAuth can connect directly to this URL.

Public API reference: MiniMax H3 Videos API.

Local installation

pipx install mcp-minimax
export ACEDATACLOUD_API_TOKEN="YOUR_API_TOKEN"
mcp-minimax

Get a token from AceDataCloud.

Claude Code

claude mcp add minimax --transport stdio \
  --env ACEDATACLOUD_API_TOKEN=YOUR_API_TOKEN \
  -- mcp-minimax

Generic MCP configuration

{
  "mcpServers": {
    "minimax": {
      "command": "mcp-minimax",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Examples

Text:

Generate a 6-second 16:9 video: a red fox running through a snowy forest at dawn, low tracking shot.

Images:

Animate these two reference images for 8 seconds while preserving the character and clothing.

Audio:

Create a 9:16 dance video guided by this audio, with cuts and motion following the beat.

The HTTP API waits for completion by default, while MCP generation tools default async to true so agents receive a task ID immediately. Poll it with minimax_get_task until the final AceDataCloud CDN video is available. Set async=false only when the client can safely wait for the complete result.

Development

pip install -e ".[dev,test]"
ruff check .
pytest --cov=core --cov=tools
mypy core tools

Documentation

License

MIT