Skill: tangusers/minimax-mcp (version 1.0.3)

--- 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 | 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 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 ```bash # 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](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)

path: _meta.json
content: ownerId: kn77wmwefxtxj7a84djeydj3md812vy7
slug: minimax-mcp
version: 1.0.2
publishedAt: 1770951175069

path: references/examples.md
content: # MiniMax MCP Usage Examples

## web_search - Web Search

### Basic Search

```bash
mcporter call minimax.web_search query="what is artificial intelligence"
```

**Return Structure:**
```json
{
  "organic": [
    {
      "title": "Result Title",
      "link": "https://example.com",
      "snippet": "Result snippet...",
      "date": "2026-01-01"
    }
  ],
  "related_searches": [
    { "query": "related search query" }
  ],
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}
```

### Search Tips

| Scenario | Query Style | Example |
|----------|-------------|---------|
| News | Add year | "AI 2026" |
| Tech Docs | Add tech term | "Python tutorial" |
| Products | Add product name | "iPhone review" |

---

## understand_image - Image Understanding

### Analyze Image from URL

```bash
mcporter call minimax.understand_image \
  prompt="Describe what's in this image" \
  image_source="https://example.com/image.jpg"
```

### Analyze Local Image

```bash
mcporter call minimax.understand_image \
  prompt="What's in this image?" \
  image_source="/path/to/local/image.png"
```

### Advanced Usage

| Task | Prompt Example |
|------|----------------|
| Describe scene | "Describe this scene in detail" |
| Extract text | "What text is in this image? Please extract it." |
| Identify type | "What type of image is this? Photo/screenshot/poster?" |
| Analyze chart | "Describe the data and trends in this chart" |

---

## Common Error Handling

### Image Download Failed

**Error:** `Failed to download image from URL: 400 Bad Request`

**Solutions:**
- Ensure URL is publicly accessible
- Check image format (JPEG/PNG/WebP)
- Try downloading locally first, then use local path

### Invalid API Key

**Error:** `API Error: invalid api key`

**Solutions:**
- Confirm API Key and Host are from the same region
- China users: use `https://api.minimaxi.com`
- Global users: use `https://api.minimax.io`

### uvx Not Found

**Error:** `spawn uvx ENOENT`

**Solutions:**
```bash
# Find uvx path
which uvx

# If not found, install uv first
brew install uv
# or
curl -LsSf https://astral.sh/uv/install.sh | sh
```

---

## Integration: Claude Desktop / Cursor

Edit `~/

### Claude DesktopLibrary/Application Support/Claude/claude_desktop_config.json`:

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

### Cursor

Preferences → Cursor Settings → MCP → Add new global MCP Server

---

## Cost Notice

⚠️ Using these tools will incur API call fees. Please monitor your MiniMax account usage.


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: suspicious | SkillSpector: suspicious (MEDIUM)