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
• Asynchronous 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.

Generation tools submit asynchronously. Poll the returned task ID with minimax_get_task until the final AceDataCloud CDN video is available.

Development

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

License

MIT