Minimax Coding Plan MCP

🚀 MiniMax Model Context Protocol (MCP) Server for Coding

This is a specialized MiniMax Model Context Protocol (MCP) server tailored for coding - plan users. It features AI - powered search and vision analysis APIs, which are optimized for code development workflows. Unlike the standard [MiniMax - MCP](https://github.com/MiniMax - AI/MiniMax - MCP), this version offers coding - specific tools (e.g., web_search and understand_image). These tools can seamlessly integrate with MCP clients such as Claude Desktop, Cursor, Windsurf, [OpenAI Agents](https://github.com/openai/openai - agents - python) to enhance your coding experience.

🚀 Quick Start

Get API Key

Get your API key from [MiniMax](https://www.minimax.io/platform/user - center/basic - information/interface - key).

Install uv

Install uv (Python package manager) with curl -LsSf https://astral.sh/uv/install.sh | sh or see the uv [repo](https://github.com/astral - sh/uv) for additional install methods.

Important Note

⚠️ Important Note

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

Configure MCP Clients

Claude Desktop

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

{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": [
        "minimax - coding - plan - mcp",
        "-y"
      ],
      "env": {
        "MINIMAX_API_KEY": "insert - your - api - key - here",
        "MINIMAX_API_HOST": "api host, https://api.minimax.io | https://api.minimaxi.com"
      }
    }
  }
}

⚠️ Important Note

The API key needs to match the host. If an error "API Error: invalid api key" occurs, please check your api host:

• Global Host: https://api.minimax.io
• Mainland Host: https://api.minimaxi.com

If you're using Windows, you will have to enable "Developer Mode" in Claude Desktop to use the MCP server. 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 to add the above config.

Now, your MCP client can interact with MiniMax through these tools.

📚 Documentation

• [Chinese Documentation](README - CN.md)

🔧 Technical Details

Transport

We support two transport types: stdio and sse.

Available Tools

📄 Release Notes

November 20, 2025

🆕 What's New

• Web Search: New web_search tool - perform web searches and get organic results with related search queries
• Vision Language Model: New understand_image tool - analyze images using AI based on text prompts

📈 Features

• web_search - Search the web and get structured results including titles, links, snippets, and related searches
• understand_image - Analyze images from URLs or local files, supporting JPEG, PNG, and WebP formats

❓ FAQ

1. invalid api key

Please ensure your API key and API host are regionally aligned.

2. spawn uvx ENOENT

Please confirm its absolute path by running this command in your terminal:

which uvx

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

💻 Usage Examples

⚠️ Important Note

Using these tools may incur costs.

1. Web Search

Use the web_search tool to search for information on the web.

2. Image Analysis

Use the understand_image tool to analyze images with AI.