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. This server allows MCP clients like Claude Desktop, Cursor, Windsurf, OpenAI Agents and others to generate speech, clone voices, generate videos, images and more.

Installation

Prerequisites

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

Important API Host Information

The API host and key must match by region, otherwise you'll encounter an Invalid API key error:

Region	Global	Mainland
MINIMAX_API_KEY	Get from MiniMax Global	Get from MiniMax
MINIMAX_API_HOST	https://api.minimaxi.chat (note the extra "i")	https://api.minimax.chat

Setting Up With MCP Clients

Claude Desktop

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

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax-mcp"
      ],
      "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: You must enable "Developer Mode" in Claude Desktop. Click "Help" in the hamburger menu in the top left and select "Enable Developer Mode".

Cursor

Go to Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server and add the same 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: When deployed in the cloud, use `URL` for input

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

Troubleshooting

Invalid API Key Error

Ensure your API key and API host are regionally aligned:

Global API key + Global host: https://api.minimaxi.chat
Mainland API key + Mainland host: https://api.minimax.chat

"spawn uvx ENOENT" Error

Find the absolute path to uvx:

which uvx

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

Usage Examples

Warning: Using these tools may incur costs.

The MCP server enables various capabilities through Claude Desktop or Cursor:

Text-to-speech with different voices or voice cloning
Video generation from prompts
Image generation from prompts

Simply interact with your MCP client (Claude Desktop/Cursor) and request actions like:

"Generate a video of a cat playing piano"
"Create an audio narration of this text with a professional voice"
"Clone this voice using these sample audio files"
"Generate an image of a futuristic cityscape"

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.