MiniMax MCP for Cursor: Setup & Config

What you can do with MiniMax in Cursor

Access MiniMax speech, voice, image, video, and music workflows from one MCP-enabled assistant.

• Generate spoken audio using a chosen voice.
• Check video-generation progress from an assistant.
• Generate music from a prompt and lyrics.

Before you start: MiniMax in Cursor

• uv with uvx available
• A MiniMax API key matching the selected regional host
• An MCP-compatible client

The command follows the README's Claude Desktop configuration. Windows Claude Desktop may require Developer Mode. SSE is supported, but a ready-to-use SSE endpoint is not stated in the README.

MiniMax Cursor configuration

1. Choose Cursor configuration scope

   For MiniMax MCP, open Project: .cursor/mcp.json User: ~/.cursor/mcp.json. Merge into mcpServers at project or user scope.

2. Add MiniMax MCP to Cursor

   Use the MiniMax-MCP entry below in mcpServers. Keep MiniMax MCP's documented stdio connection fields and your other Cursor entries.

3. Check MiniMax MCP in Cursor

   MiniMax MCP: Enable in Cursor’s MCP settings; inspect tools.

{
  "mcpServers": {
    "MiniMax-MCP": {
      "command": "uvx",
      "args": [
        "minimax-mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "<your region-specific MiniMax API key>",
        "MINIMAX_MCP_BASE_PATH": "<local directory for generated output>",
        "MINIMAX_API_HOST": "<matching regional host: https://api.minimax.io or https://api.minimaxi.com>",
        "MINIMAX_API_RESOURCE_MODE": "<url or local; url is the default>"
      }
    }
  }
}

MiniMax tools available to Cursor

MiniMax's stored tool list documents 10 tools; compare it with Cursor's connected tool list, because the stored list is not a live check.

text_to_audio

Find text_to_audio under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

list_voices

Find list_voices under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

play_audio

Find play_audio under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

voice_clone

Find voice_clone under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

text_to_image

Find text_to_image under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

generate_video

Find generate_video under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Start prompt-based video creation through MiniMax.

image_to_video

Find image_to_video under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Generate video using an image as input.

query_video_generation

Find query_video_generation under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Check the state of a video-generation task.

music_generation

Find music_generation under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Create music using descriptive instructions and supplied lyrics.

voice_design

Find voice_design under MiniMax in Cursor's MCP settings; inspect its arguments when the agent requests a call.

Create a custom voice from a description and preview text.

MiniMax: full stored tool descriptions

Troubleshooting MiniMax in Cursor

• Cursor must find uvx minimax-mcp (from uv, for Python tools) for MiniMax MCP. Enable the project/user entry in MCP settings and inspect its tools.
• Review MINIMAX_API_HOST, MINIMAX_API_KEY, MINIMAX_API_RESOURCE_MODE, MINIMAX_MCP_BASE_PATH for MiniMax MCP before sharing project .cursor/mcp.json; project scope travels with the repository.
• MiniMax MCP uses stdio here: Cursor must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: API calls may incur costs.
• Known limitation: API keys and hosts must match the account region.
• Known limitation: The structured list_voices tool description limits that tool to a specific API host.
• General Cursor troubleshooting lives in the /clients/cursor guide.

Frequently asked questions