# MiniMax MCP Configuration

## Overview

MiniMax's image understanding (`understand_image`) and web search (`web_search`) tools are **only available via MCP**, not as direct API endpoints or Hermes vision providers.

## MCP Server

- **Package:** `minimax-coding-plan-mcp`
- **Transport:** stdio (uvx)
- **API Host:** `https://api.minimax.io` (international) or `https://api.minimax.cn` (China)
- **Auth:** Token Plan API key starting with `sk-cp-`

## Tools Available

| Tool | Parameters | Description |
|------|------------|-------------|
| `understand_image` | `prompt`, `image_url` | Analyze images (HTTP URL or local file path) |
| `web_search` | `query` | Web search |

## Hermes Configuration

```yaml
mcp_servers:
  minimax:
    command: "uvx"
    args: ["minimax-coding-plan-mcp", "-y"]
    env:
      MINIMAX_API_KEY: "sk-cp-YourKeyHere"
      MINIMAX_API_HOST: "https://api.minimax.io"
```

## Tool Naming in Hermes

MCP tools are registered with prefix `mcp_minimax_`:
- `mcp_minimax_understand_image`
- `mcp_minimax_web_search`

## Important Notes

- **Vision provider conflict:** MiniMax's `minimax-cn` provider does NOT support vision calls directly. Do not set `auxiliary.vision.provider: minimax-cn` — it will fail with "model does not support images". Vision must go through the MCP tool.
- **Restart required:** Adding/modifying `mcp_servers` requires Hermes Agent restart to take effect.
- **Prerequisites:** `uvx` must be installed (`curl -LsSf https://astral.sh/uv/install.sh | sh`)