MiniMax Skill

Environment Variables

• MINIMAX_API_KEY

  : MiniMax API Key (get from https://platform.minimaxi.com/subscribe/coding-plan)

• MINIMAX_API_HOST

  : API host URL, defaults to

  https://api.minimaxi.com

• MINIMAX_MCP_BASE_PATH

  : Local output directory path

• MINIMAX_API_RESOURCE_MODE

  : Resource mode (

  url

  or

  local

  ), defaults to

  url

Available Tools

web_search

• query

  (str, required): Search query. Use 3-5 keywords for best results. For time-sensitive topics, include the current date (e.g.,

  latest iPhone 2025

  ).

{
    "organic": [
        {
            "title": "Search result title",
            "link": "Result URL",
            "snippet": "Brief description or excerpt",
            "date": "Result date"
        }
    ],
    "related_searches": [{"query": "Related search suggestion"}],
    "base_resp": {"status_code": status_code, "status_msg": "Status message"}
}

• If no useful results are returned, try rephrasing your query with different keywords.

understand_image

• prompt

  (str, required): A text prompt describing what to analyze or extract from the image.

• image_source

  (str, required): Image source URL or file path.
  • URL:

    https://example.com/image.jpg

  • Relative path:

    images/photo.png

  • Absolute path:

    /Users/username/Documents/image.jpg

  • Note: If the file path starts with

    @

    , remove the

    @

    prefix.

Usage

Execute Tools

$SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json <tool_name> '<arguments_json>'

Examples

$SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json web_search '{"query": "latest react features 2025"}'

$SKILL_DIR/scripts/exec-with-env.sh $SKILL_DIR/mcp-config.json understand_image '{"prompt": "Describe this image", "image_source": "https://example.com/image.jpg"}'

Execution Strategy

• Environment variable status is determined at execution time
• If execution fails, the error message will clearly indicate missing configuration
• Only then inform the user what needs to be configured
• Follow "fail fast" principle to avoid unnecessary interactions

• "Please confirm you have set the MINIMAX_API_KEY environment variable"
• "Before executing, please ensure you have configured..."

• Execute the command directly
• If it fails, inform the user based on the error message

Use Cases

• Need to search for real-time or external information → Use web_search
• Need to analyze, describe, or extract information from an image → Use understand_image
• User provides an image that needs understanding → Use understand_image

Error Handling

• Check the tool name is correct
• Verify required arguments are provided (marked with

  *

  in signatures above)
• Ensure

  MINIMAX_API_KEY

  environment variable is set
• Check the MCP server is accessible