io.github.AceDataCloud/mcp-minimax

MiniMax H3 MCP

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

Documentation

License

MIT