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.
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.
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
8Convert 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
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.
More Media & Design MCP servers
CampaignStack
Run LinkedIn and email outreach from Claude, safely. Made for lead gen agencies, founders and medium-large companies. Every account gets enforced daily limits, its own proxy, and a review queue before anything sends.
MagicPixel.art
AI pixel art generator MCP for Claude, ChatGPT, and Cursor. Generate pixel art, remix your own assets, and sync them into Unity or Godot. Create pixel art, remix, edit, and iterate on pixel art game assets including char
JSON2Video
JSON2VideoOfficial 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
Pixel Art Generator - Sprite Fusion
Hugo DuprezSprite Fusion lets your AI assistant make the pixel art for your game. Describe a character, item, or tile and get sprites at the exact size you need, ready to drop into your project. Match your existing art, turn charac
uxgen
uxgenA library of conversion components for e-commerce, built on A/B tested mechanics and handed straight to your coding agent. 65 pieces drawn from mechanics that have been A/B tested in real stores: cart drawer with the ups
Comments