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 status is succeeded, failed, or cancelled. Only use the video URL after succeeded; inspect the error on failure or cancellation. A task ID or HTTP 200 confirms submission, not a finished video. 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

Metadata

Release files for mcp-minimax 2026.10.5.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-minimax 2026.10.5.0
File	Size	Uploaded
mcp_minimax-2026.10.5.0.tar.gz	29.0 kB	Oct 5, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-minimax 2026.10.5.0
File	Interpreter	ABI	Platform	Reset
mcp_minimax-2026.10.5.0-py3-none-any.whl 24.5 kB Oct 5, 2026	Python 3	none	any	Details

Total release size: 53.5 kB

Release files / mcp_minimax-2026.10.5.0.tar.gz

Download URL	mcp_minimax-2026.10.5.0.tar.gz
Size	29.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`7bc9eb28c3337a0d2b854ebf505d1f95e0c7585a7654b8a38e8d283d32d460e4`
BLAKE2b-256 checksum How to use checksums	`dba7a5895d14c87b3fef2e15344c76b3a107f8094ea64db7f263f3c370414442`
Upload date	Oct 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.3`

Release files / mcp_minimax-2026.10.5.0-py3-none-any.whl

Download URL	mcp_minimax-2026.10.5.0-py3-none-any.whl
Size	24.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`b6c8d3728a72cbce2119df42cea1a709099c9190ca5895906070778316ba5200`
BLAKE2b-256 checksum How to use checksums	`3115ac46c91a3e3e3f8218d633c5af485ea5f6655723e36d1d2313dbd0942e17`
Upload date	Oct 5, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.0.1 CPython/3.12.3`