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

North Noir

Make AI-drawn video from chat. Claude, Cursor or Claude Code plans the film, the model draws every frame in code at 30 fps, and you edit it on a timeline with narration, music and sound effects.

Cardboard AI

A video editor you use by chatting in Claude or ChatGPT. Bring your footage, ask for cuts, captions, titles and music, then download the finished video.

Designesy

LE-VAI

Design quality gate for AI-generated UI. Scores any live URL against a published contract of deterministic checks, with an A–F grade, a per-check breakdown and AI-slop pattern findings; validates DTCG token files and Lot

TravelAnimator

Lascade-Co

MCP server and CLI for TravelAnimator — generate animated travel videos, itineraries, and trip media from Claude, Codex, or your terminal

QR Planet QR Code MCP Server

qrplanet

QR Planet QR Code MCP Server - Hosted MCP server for QR Planet. Connect AI agents and MCP-compatible clients to create, update, design, route, and analyze dynamic QR Codes using your QR Planet API key.