How do I install the Minimax MCP skill?

Run npx skillmds@latest add dvcrn/minimax-mcp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Minimax MCP safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: WARNING. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Minimax MCP?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Minimax MCP free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Minimax MCP?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Minimax MCP by dvcrn — Agent Skill

Name: Minimax MCP
Rating: 4.2 (5 reviews)
Author: dvcrn

Minimax MCP

MiniMax MCP server for web search and image understanding. Use when needing: (1) Web search via MiniMax API, (2) Analyze/describe images, (3) Extract content from URLs. Requires MINIMAX_API_KEY (China: api.minimaxi.com, Global: api.minimax.io).

dvcrn Updated Sep 8, 2026 32 repo stars

File contents

MiniMax MCP Skill

Overview

Official MiniMax Model Context Protocol (MCP) server for coding-plan users, providing AI-powered search and vision analysis capabilities.

Features

Tool	Function	Supported Formats
web_search	Web search with structured results (title, link, snippet)	-
understand_image	AI image analysis and content recognition	JPEG, PNG, WebP

Trigger Scenarios

Use this skill when user says:

"Search for xxx" / "Look up xxx"
"Look at this image" / "Analyze this picture"
"What's in this image" / "Describe this photo"
"Extract content from URL" / "Fetch this webpage"

Quick Start

1. Get API Key

Region	API Key URL	API Host
🇨🇳 China	platform.minimaxi.com	https://api.minimaxi.com
🇺🇳 Global	minimax.io	https://api.minimax.io

2. Configure mcporter (Recommended)

# Add MCP server
mcporter config add minimax \
  --command "uvx minimax-coding-plan-mcp -y" \
  --env MINIMAX_API_KEY="your-key" \
  --env MINIMAX_API_HOST="https://api.minimaxi.com"

# Test connection
mcporter list

3. Direct Usage

# Search
mcporter call minimax.web_search query="keywords"

# Analyze image
mcporter call minimax.understand_image prompt="Describe this image" image_source="image-url-or-path"

Usage Examples

See references/examples.md

Environment Variables

Variable	Required	Description
`MINIMAX_API_KEY`	✅	Your MiniMax API Key
`MINIMAX_API_HOST`	✅	API endpoint

Important Notes

⚠️ API Key must match the host region!

Region	API Key Source	API Host
Global	minimax.io	https://api.minimax.io
China	minimaxi.com	https://api.minimaxi.com

If you get "Invalid API key" error, check if your Key and Host are from the same region.

Troubleshooting

"uvx not found": Install uv - brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh
"Invalid API key": Confirm API Key and Host are from the same region
Image download failed: Ensure image URL is publicly accessible, supports JPEG/PNG/WebP

Related Resources

GitHub: https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP
MiniMax Platform: https://platform.minimaxi.com (China) / https://www.minimax.io (Global)

---name: minimax-mcpdescription: MiniMax MCP server for web search and image understanding. Use when needing: (1) Web search via MiniMax API, (2) Analyze/describe images, (3) Extract content from URLs. Requires MINIMAX_API_KEY (China: api.minimaxi.com, Global: api.minimax.io).---# MiniMax MCP Skill## OverviewOfficial MiniMax Model Context Protocol (MCP) server for coding-plan users, providing AI-powered search and vision analysis capabilities.## Features| Tool | Function | Supported Formats ||------|----------|-------------------|| **web_search** | Web search with structured results (title, link, snippet) | - || **understand_image** | AI image analysis and content recognition | JPEG, PNG, WebP |## Trigger ScenariosUse this skill when user says:- "Search for xxx" / "Look up xxx"- "Look at this image" / "Analyze this picture"- "What's in this image" / "Describe this photo"- "Extract content from URL" / "Fetch this webpage"## Quick Start### 1. Get API Key| Region | API Key URL | API Host ||--------|-------------|----------|| 🇨🇳 China | platform.minimaxi.com | https://api.minimaxi.com || 🇺🇳 Global | minimax.io | https://api.minimax.io |### 2. Configure mcporter (Recommended)```bash# Add MCP servermcporter config add minimax \ --command "uvx minimax-coding-plan-mcp -y" \ --env MINIMAX_API_KEY="your-key" \ --env MINIMAX_API_HOST="https://api.minimaxi.com"# Test connectionmcporter list```### 3. Direct Usage```bash# Searchmcporter call minimax.web_search query="keywords"# Analyze imagemcporter call minimax.understand_image prompt="Describe this image" image_source="image-url-or-path"```## Usage ExamplesSee [references/examples.md](references/examples.md)## Environment Variables| Variable | Required | Description ||----------|----------|-------------|| `MINIMAX_API_KEY` | ✅ | Your MiniMax API Key || `MINIMAX_API_HOST` | ✅ | API endpoint |## Important Notes⚠️ **API Key must match the host region!**| Region | API Key Source | API Host ||--------|---------------|----------|| Global | minimax.io | https://api.minimax.io || China | minimaxi.com | https://api.minimaxi.com |If you get "Invalid API key" error, check if your Key and Host are from the same region.## Troubleshooting- **"uvx not found"**: Install uv - `brew install uv` or `curl -LsSf https://astral.sh/uv/install.sh | sh`- **"Invalid API key"**: Confirm API Key and Host are from the same region- **Image download failed**: Ensure image URL is publicly accessible, supports JPEG/PNG/WebP## Related Resources- GitHub: https://github.com/MiniMax-AI/MiniMax-Coding-Plan-MCP- MiniMax Platform: https://platform.minimaxi.com (China) / https://www.minimax.io (Global)

Frequently asked questions