MiniMax MCP server for AI agents

The MiniMax Model Context Protocol (MCP) server enables interaction with powerful Text to Speech and video/image generation APIs. It allows MCP clients like Claude Desktop, Cursor, Windsurf, and OpenAI Agents to generate speech, clone voices, create videos and images.

Installation and Setup

Prerequisites

Get your API key from MiniMax
Install uv (Python package manager):
```
curl -LsSf https://astral.sh/uv/install.sh | sh
```
Or see the uv repository for additional installation methods

Important API Configuration

Your API host and key must match by region, or you'll encounter an "Invalid API key" error:

Region	Global	Mainland
API Key	From MiniMax Global	From MiniMax
API Host	https://api.minimaxi.chat (note the extra "i")	https://api.minimax.chat

Client Configuration

Claude Desktop

Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json
Add the following configuration:

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

Note for Windows users: Enable "Developer Mode" in Claude Desktop by clicking "Help" in the hamburger menu in the top left and selecting "Enable Developer Mode".

Cursor

Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server
Add the configuration as shown above

Transport Types

The MCP server supports two transport types:

stdio	SSE
Runs locally	Can be deployed locally or in the cloud
Communication through `stdout`	Communication through `network`
Input: Supports processing `local files` or valid `URL` resources	Input: URL recommended for cloud deployment

Available Tools

Tool	Description
`text_to_audio`	Convert text to audio with a given voice
`list_voices`	List all available voices
`voice_clone`	Clone a voice using provided audio files
`generate_video`	Generate a video from a prompt
`text_to_image`	Generate an image from a prompt
`query_video_generation`	Query the result of video generation task

Troubleshooting

Invalid API Key

Ensure your API key and API host are regionally aligned as shown in the table above.

"spawn uvx ENOENT" Error

Find the absolute path for uvx and update your configuration:

which uvx

Then update your configuration to use the absolute path (e.g., "command": "/usr/local/bin/uvx").

Using `generate_video` in Async Mode

Define completion rules before starting or configure them in your IDE settings (e.g., Cursor)
The system will generate a task ID and allow you to query the result using query_video_generation

Usage Examples

The MCP server enables various creative applications:

Broadcasting news segments with text-to-speech
Cloning voices from audio samples
Generating videos from text prompts
Creating images from text descriptions

Note: Using these tools may incur costs according to MiniMax's pricing.

How to add this MCP server to Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > MCP and click "Add new global MCP server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

{
    "mcpServers": {
        "cursor-rules-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "cursor-rules-mcp"
            ]
        }
    }
}

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explictly ask the agent to use the tool by mentioning the tool name and describing what the function does.

MiniMax MCP server