name: minimax-mcp
description: 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).
metadata:
{
"openclaw":
{
"emoji": "🔍",
"requires": { "bins": ["uvx"], "env": ["MINIMAX_API_KEY", "MINIMAX_API_HOST"] },
"primaryEnv": "MINIMAX_API_KEY",
"install":
[
{
"id": "region",
"kind": "select",
"label": "Select Region",
"options": ["Global (minimax.io)", "Mainland China (minimaxi.com)"],
"default": "Mainland China (minimaxi.com)"
},
{
"id": "api_key",
"kind": "input",
"label": "MiniMax API Key",
"description": "Global: https://www.minimax.io/platform/user-center/basic-information/interface-key | China: https://platform.minimaxi.com/user-center/basic-information/interface-key",
"secret": true,
"envVar": "MINIMAX_API_KEY"
},
{
"id": "uv",
"kind": "brew",
"formula": "uv",
"bins": ["uvx"],
"label": "Install uv (required for MCP server)"
}
]
}
}
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
2. Configure mcporter (Recommended)
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"
mcporter list
3. Direct Usage
mcporter call minimax.web_search query="keywords"
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!
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
