MiniMax MCP ServerFeatured

@MiniMax-AI

Basic information

About MiniMax MCP Server

Official MiniMax Model Context Protocol (MCP) server that enables interaction with powerful Text to Speech, image generation and video generation APIs.

#text-to-speech #mcp #image-generation #text-to-image #video-generation #image-to-video #voice-cloning #text-to-video #mcp-server #mcp-tools

MiniMax MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp"
      ],
      "env": {
        "MINIMAX_API_KEY": "<insert-your-api-key-here>",
        "MINIMAX_MCP_BASE_PATH": "<local-output-dir-path>",
        "MINIMAX_API_HOST": "https://api.minimaxi.chat",
        "MINIMAX_API_RESOURCE_MODE": "<optional, [url|local], url is default, audio/image/video are downloaded locally or provided in URL format>"
      }
    }
  }
}

MiniMax MCP Server tools

Convert text to audio with a given voice and save the output audio file to a given directory. If no directory is provided, the file will be saved to desktop. If no voice ID is provided, the default voice will be used. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

List all available voices. Only supported when api_host is https://api.minimax.chat.

Play an audio file. Supports WAV and MP3 formats. Does not support video.

Clone a voice using the provided audio file. New voices will incur costs when first used. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Generate images based on text prompts. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Generate a video based on text prompts. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Generate a video based on an image. Note: This tool calls MiniMax API and may incur costs. Use only when explicitly requested by the user.

Query the status of a video generation task.

Overview

What is MiniMax MCP?

MiniMax MCP is the official Model Context Protocol server from MiniMax. It enables MCP clients (such as Claude Desktop, Cursor, Windsurf, and OpenAI Agents) to interact with MiniMax's powerful Text-to-Speech, voice cloning, video generation, and image generation APIs. It is designed for developers who want to integrate MiniMax's generative AI capabilities into their tools.

How to use MiniMax MCP?

Obtain an API key from MiniMax and install uv (Python package manager). Configure your MCP client (e.g., Claude Desktop or Cursor) with the required environment variables: MINIMAX_API_KEY, MINIMAX_MCP_BASE_PATH, MINIMAX_API_HOST (region-specific), and optionally MINIMAX_API_RESOURCE_MODE. After setup, the client can invoke any of the eight available tools.

Key features of MiniMax MCP

Convert text to audio using a given voice
List all available voices
Clone a voice from provided audio files
Generate video from a text prompt
Generate images from a text prompt
Query video generation task results
Generate music tracks from a prompt and lyrics
Design custom voices from descriptive prompts with preview audio

Use cases of MiniMax MCP

Create a broadcast segment by reading evening news with a synthesized voice
Clone a specific person's voice for content creation
Generate a short video from a descriptive prompt
Produce images or music tracks automatically within a workflow

Frequently asked questions

Why do I get an "invalid api key" error?

This occurs when your API key and API host are not regionally aligned. Use `https://api.minimax.io` for Global keys and `https://api.minimaxi.com` for Mainland China keys.

What does "spawn uvx ENOENT" mean?

It means `uvx` is not in your PATH. Run `which uvx` to find its absolute path (e.g., `/usr/local/bin/uvx`) and update your MCP client configuration to use that path.

How do I use `generate_video` in async mode?

You must define completion rules either in a dedicated cursor rule file or in your IDE settings (e.g., Cursor) before starting the video generation task.

What transport types does MiniMax MCP support?

It supports both stdio (local, communicates via stdout, can process local files or URLs) and SSE (can be deployed locally or in the cloud, communicates over network, recommended for cloud deployment with URL inputs).

What runtime and dependencies are required?

You need Python and `uv` (Python package manager). The server is run via `uvx minimax-mcp -y`. No other explicit runtime requirements are stated.

Comments

More Media & Design MCP servers

PostNitro

PostNitro Inc.

The PostNitro MCP server lets AI assistants and agents — Claude (Desktop, Code, and Cowork), Cursor, ChatGPT, and any other Model Context Protocol client — create carousels, image posts, and videos, manage brand kits, a

Sleek

Design your mobile app UI with AI, then have your coding agent build the real app from it.

JSON2Video

Official JSON2Video MCP server. Video API for automated video production at scale: render videos from templates with AI voiceovers, subtitles and AI images. Remote server with OAuth (https://mcp.json2video.com/mcp) or lo

aicut

Make AI videos, images, voiceovers and full AI Video Story episodes from Claude, ChatGPT, Cursor or any MCP client, then post them to TikTok, YouTube and Instagram. Veo, Kling, Seedance and more, on your own aicut accoun

getimg

getimg.ai

Create and edit images, videos, music, speech, and sound effects with your getimg account. Use ready-made workflows for professional headshots, photo restoration, stickers, lighting changes, background cleanup, product v