@ameno/pi-minimax-mcp 1.0.0

package/dist/config.js

@@ -0,0 +1,84 @@
+/**
+ * MiniMax MCP Configuration
+ *
+ * Handles configuration loading from files and environment variables
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { DEFAULT_CONFIG } from "./types.js";
+const CONFIG_PATHS = [
+    join(process.cwd(), ".pi", "extensions", "minimax-mcp.json"),
+    join(homedir(), ".pi", "agent", "extensions", "minimax-mcp.json"),
+];
+export function resolveConfigPath(customPath) {
+    if (customPath) {
+        return customPath.startsWith("~")
+            ? join(homedir(), customPath.slice(1))
+            : customPath;
+    }
+    return null;
+}
+export function loadConfig(customPath) {
+    const paths = customPath
+        ? [resolveConfigPath(customPath)]
+        : CONFIG_PATHS;
+    for (const path of paths) {
+        if (existsSync(path)) {
+            try {
+                const raw = readFileSync(path, "utf-8");
+                const parsed = JSON.parse(raw);
+                return mergeConfig(parsed);
+            }
+            catch (error) {
+                console.warn(`[pi-minimax-mcp] Failed to load config from ${path}:`, error);
+            }
+        }
+    }
+    return mergeConfig({});
+}
+export function mergeConfig(overrides) {
+    const parseEnvInt = (val, fallback) => {
+        if (!val)
+            return fallback;
+        const parsed = parseInt(val, 10);
+        return Number.isNaN(parsed) ? fallback : parsed;
+    };
+    return {
+        apiKey: overrides.apiKey ?? process.env.MINIMAX_API_KEY ?? DEFAULT_CONFIG.apiKey,
+        apiHost: overrides.apiHost ?? process.env.MINIMAX_API_HOST ?? DEFAULT_CONFIG.apiHost,
+        basePath: overrides.basePath ?? process.env.MINIMAX_MCP_BASE_PATH ?? DEFAULT_CONFIG.basePath,
+        resourceMode: (overrides.resourceMode ?? process.env.MINIMAX_API_RESOURCE_MODE ?? DEFAULT_CONFIG.resourceMode),
+        timeoutMs: overrides.timeoutMs ?? parseEnvInt(process.env.MINIMAX_MCP_TIMEOUT_MS, DEFAULT_CONFIG.timeoutMs),
+        maxBytes: overrides.maxBytes ?? parseEnvInt(process.env.MINIMAX_MCP_MAX_BYTES, DEFAULT_CONFIG.maxBytes),
+        maxLines: overrides.maxLines ?? parseEnvInt(process.env.MINIMAX_MCP_MAX_LINES, DEFAULT_CONFIG.maxLines),
+    };
+}
+export function ensureDefaultConfig() {
+    const globalPath = CONFIG_PATHS[1];
+    if (existsSync(globalPath))
+        return;
+    try {
+        mkdirSync(dirname(globalPath), { recursive: true });
+        writeFileSync(globalPath, JSON.stringify({
+            apiKey: null,
+            apiHost: "https://api.minimax.io",
+            basePath: null,
+            resourceMode: "url",
+            timeoutMs: 60000,
+            maxBytes: 51200,
+            maxLines: 2000,
+        }, null, 2) + "\n", "utf-8");
+        console.log(`[pi-minimax-mcp] Created default config at ${globalPath}`);
+    }
+    catch (error) {
+        console.warn(`[pi-minimax-mcp] Failed to create default config:`, error);
+    }
+}
+export function validateConfig(config) {
+    if (!config.apiKey) {
+        throw new Error("MiniMax API key is required. Set MINIMAX_API_KEY environment variable or add to config file.\n" +
+            "Get your key at: https://platform.minimax.io/subscribe/coding-plan");
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * pi-minimax-mcp
+ *
+ * MiniMax MCP integration for Pi coding agent
+ * Provides web search and image understanding capabilities
+ *
+ * @example
+ * // As Pi extension
+ * import minimaxMcp from "ameno-/pi-minimax-mcp/extensions";
+ *
+ * // As library
+ * import { MiniMaxMcpClient } from "ameno-/pi-minimax-mcp";
+ * const client = new MiniMaxMcpClient({ apiKey: "..." });
+ * const results = await client.webSearch({ query: "..." });
+ */
+export { MiniMaxMcpClient } from "./client.js";
+export { loadConfig, mergeConfig, validateConfig, ensureDefaultConfig } from "./config.js";
+export { formatToolOutput, formatBytes, redactSensitiveData, truncateHead } from "./utils.js";
+export type { JsonRpcRequest, JsonRpcResponse, McpToolResult, MiniMaxMcpConfig, WebSearchParams, UnderstandImageParams, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC9F,YAAY,EACV,cAAc,EACd,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * pi-minimax-mcp
+ *
+ * MiniMax MCP integration for Pi coding agent
+ * Provides web search and image understanding capabilities
+ *
+ * @example
+ * // As Pi extension
+ * import minimaxMcp from "ameno-/pi-minimax-mcp/extensions";
+ *
+ * // As library
+ * import { MiniMaxMcpClient } from "ameno-/pi-minimax-mcp";
+ * const client = new MiniMaxMcpClient({ apiKey: "..." });
+ * const results = await client.webSearch({ query: "..." });
+ */
+export { MiniMaxMcpClient } from "./client.js";
+export { loadConfig, mergeConfig, validateConfig, ensureDefaultConfig } from "./config.js";
+export { formatToolOutput, formatBytes, redactSensitiveData, truncateHead } from "./utils.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MiniMax MCP Types
+ *
+ * Type definitions for MiniMax MCP protocol
+ */
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    id: string | number;
+    method: string;
+    params?: Record<string, unknown>;
+}
+export interface JsonRpcResponse {
+    jsonrpc: "2.0";
+    id?: string | number | null;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export interface McpToolResult {
+    content?: Array<{
+        type: string;
+        text?: string;
+        [key: string]: unknown;
+    }>;
+    isError?: boolean;
+}
+export interface MiniMaxMcpConfig {
+    apiKey?: string;
+    apiHost?: string;
+    basePath?: string;
+    resourceMode?: "url" | "local";
+    timeoutMs?: number;
+    maxBytes?: number;
+    maxLines?: number;
+}
+export interface WebSearchParams {
+    query: string;
+    numResults?: number;
+    recencyDays?: number;
+}
+export interface UnderstandImageParams {
+    imagePath: string;
+    prompt?: string;
+}
+export declare const DEFAULT_CONFIG: MiniMaxMcpConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,KAAK,GAAG,OAAO,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,cAAc,EAAE,gBAM5B,CAAC"}

package/dist/types.js

@@ -0,0 +1,13 @@
+/**
+ * MiniMax MCP Types
+ *
+ * Type definitions for MiniMax MCP protocol
+ */
+export const DEFAULT_CONFIG = {
+    apiHost: "https://api.minimax.io",
+    resourceMode: "url",
+    timeoutMs: 60000,
+    maxBytes: 51200,
+    maxLines: 2000,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkDH,MAAM,CAAC,MAAM,cAAc,GAAqB;IAC9C,OAAO,EAAE,wBAAwB;IACjC,YAAY,EAAE,KAAK;IACnB,SAAS,EAAE,KAAK;IAChB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,IAAI;CACf,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,38 @@
+/**
+ * MiniMax MCP Utilities
+ *
+ * Output formatting, truncation, and helper functions
+ */
+import type { McpToolResult, MiniMaxMcpConfig } from "./types.js";
+export interface FormatOptions {
+    maxBytes?: number;
+    maxLines?: number;
+}
+export interface FormattedOutput {
+    text: string;
+    details: {
+        truncated: boolean;
+        totalLines: number;
+        totalBytes: number;
+        outputLines: number;
+        outputBytes: number;
+        tempFile?: string;
+    };
+}
+export declare function formatToolOutput(result: McpToolResult, options?: FormatOptions): FormattedOutput;
+export declare function writeTempFile(content: string): string;
+export declare function formatBytes(bytes: number): string;
+export declare function redactSensitiveData(config: MiniMaxMcpConfig): Partial<MiniMaxMcpConfig>;
+export declare function truncateHead(text: string, options: {
+    maxBytes?: number;
+    maxLines?: number;
+}): {
+    content: string;
+    truncated: boolean;
+    outputLines: number;
+    outputBytes: number;
+    totalLines: number;
+    totalBytes: number;
+    firstLineExceedsLimit: boolean;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAElE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QACP,SAAS,EAAE,OAAO,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE,aAAkB,GAC1B,eAAe,CAwDjB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAMrD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIjD;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,gBAAgB,CAAC,CAK3B;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD;IACD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB,EAAE,OAAO,CAAC;CAChC,CA+CA"}

package/dist/utils.js

@@ -0,0 +1,118 @@
+/**
+ * MiniMax MCP Utilities
+ *
+ * Output formatting, truncation, and helper functions
+ */
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { writeFileSync } from "node:fs";
+export function formatToolOutput(result, options = {}) {
+    const { maxBytes = 51200, maxLines = 2000 } = options;
+    const contentBlocks = Array.isArray(result.content) ? result.content : [];
+    const textBlocks = contentBlocks
+        .filter((b) => b.type === "text" && typeof b.text === "string")
+        .map((b) => b.text);
+    const rawText = textBlocks.join("\n\n") || JSON.stringify(result, null, 2);
+    const lines = rawText.split("\n");
+    const totalLines = lines.length;
+    const totalBytes = Buffer.byteLength(rawText, "utf-8");
+    // Check if truncation needed
+    const truncateByLines = totalLines > maxLines;
+    const truncateByBytes = totalBytes > maxBytes;
+    let outputText = rawText;
+    let tempFile;
+    if (truncateByLines || truncateByBytes) {
+        // Determine truncation strategy
+        if (truncateByBytes && totalBytes > maxBytes) {
+            // Truncate by bytes (keep from end)
+            const buffer = Buffer.from(rawText, "utf-8");
+            const truncated = buffer.slice(-maxBytes).toString("utf-8");
+            // Clean up partial UTF-8 character at start
+            outputText = truncated.replace(/^[^\n]*\n/, "");
+        }
+        if (truncateByLines) {
+            outputText = lines.slice(-maxLines).join("\n");
+        }
+        // Write full output to temp file
+        tempFile = writeTempFile(rawText);
+        const truncationInfo = `\n\n[Output truncated: ${Math.min(totalLines, maxLines)} of ${totalLines} lines (${formatBytes(Math.min(totalBytes, maxBytes))} of ${formatBytes(totalBytes)}). Full output: ${tempFile}]`;
+        outputText += truncationInfo;
+    }
+    const outputLines = outputText.split("\n").length;
+    const outputBytes = Buffer.byteLength(outputText, "utf-8");
+    return {
+        text: outputText,
+        details: {
+            truncated: truncateByLines || truncateByBytes,
+            totalLines,
+            totalBytes,
+            outputLines,
+            outputBytes,
+            tempFile,
+        },
+    };
+}
+export function writeTempFile(content) {
+    const timestamp = Date.now();
+    const filename = `pi-minimax-mcp-${timestamp}.txt`;
+    const filepath = join(tmpdir(), filename);
+    writeFileSync(filepath, content, "utf-8");
+    return filepath;
+}
+export function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes}B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)}KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+export function redactSensitiveData(config) {
+    return {
+        ...config,
+        apiKey: config.apiKey ? "***REDACTED***" : undefined,
+    };
+}
+export function truncateHead(text, options) {
+    const maxBytes = options.maxBytes ?? 51200;
+    const maxLines = options.maxLines ?? 2000;
+    const totalBytes = Buffer.byteLength(text, "utf-8");
+    const lines = text.split("\n");
+    const totalLines = lines.length;
+    let content = text;
+    let truncated = false;
+    let firstLineExceedsLimit = false;
+    // Check if first line alone exceeds byte limit
+    if (lines[0] && Buffer.byteLength(lines[0], "utf-8") > maxBytes) {
+        firstLineExceedsLimit = true;
+        content = lines[0].slice(0, maxBytes) + "... [truncated]";
+        truncated = true;
+    }
+    else if (totalLines > maxLines || totalBytes > maxBytes) {
+        truncated = true;
+        // Keep from the end (most recent content)
+        if (totalLines > maxLines) {
+            content = lines.slice(-maxLines).join("\n");
+        }
+        // Apply byte limit if still over
+        const contentBytes = Buffer.byteLength(content, "utf-8");
+        if (contentBytes > maxBytes) {
+            const buffer = Buffer.from(content, "utf-8");
+            content = buffer.slice(-maxBytes).toString("utf-8");
+            // Remove potential partial line at start
+            const newlineIdx = content.indexOf("\n");
+            if (newlineIdx > 0) {
+                content = content.slice(newlineIdx + 1);
+            }
+        }
+    }
+    return {
+        content,
+        truncated,
+        outputLines: content.split("\n").length,
+        outputBytes: Buffer.byteLength(content, "utf-8"),
+        totalLines,
+        totalBytes,
+        firstLineExceedsLimit,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"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"}

package/extensions/index.ts

@@ -0,0 +1,271 @@
+/**
+ * MiniMax MCP Pi Extension
+ *
+ * Provides MiniMax MCP tools via Pi's ExtensionAPI:
+ * - web_search: Real-time web search
+ * - understand_image: Image analysis and description
+ *
+ * Setup:
+ * 1. Install: pi install npm:@ameno/pi-minimax-mcp
+ * 2. Get API key: https://platform.minimax.io/subscribe/coding-plan
+ * 3. Set env: MINIMAX_API_KEY=your-key
+ *
+ * Or use config file: ~/.pi/agent/extensions/minimax-mcp.json
+ *
+ * Usage:
+ *   "Search the web for quantum computing breakthroughs"
+ *   "What does this image show? ./screenshot.png"
+ */
+
+import { Type } from "@sinclair/typebox";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { MiniMaxMcpClient } from "../src/client.js";
+import { ensureDefaultConfig, loadConfig, mergeConfig, validateConfig } from "../src/config.js";
+import { formatToolOutput, redactSensitiveData } from "../src/utils.js";
+
+// =============================================================================
+// Extension Entry Point
+// =============================================================================
+
+export default function minimaxMcp(pi: ExtensionAPI) {
+  // Register CLI flags
+  pi.registerFlag("--minimax-api-key", {
+    description: "MiniMax API key (overrides env/config)",
+    type: "string",
+  });
+  pi.registerFlag("--minimax-api-host", {
+    description: "MiniMax API host (default: https://api.minimax.io)",
+    type: "string",
+  });
+  pi.registerFlag("--minimax-mcp-config", {
+    description: "Path to JSON config file",
+    type: "string",
+  });
+  pi.registerFlag("--minimax-mcp-max-bytes", {
+    description: "Max bytes to keep from tool output (default: 51200)",
+    type: "string",
+  });
+  pi.registerFlag("--minimax-mcp-max-lines", {
+    description: "Max lines to keep from tool output (default: 2000)",
+    type: "string",
+  });
+
+  // Ensure default config exists
+  ensureDefaultConfig();
+
+  // Get effective configuration
+  const getConfig = () => {
+    const configFlag = pi.getFlag("--minimax-mcp-config");
+    const baseConfig = loadConfig(
+      typeof configFlag === "string" ? configFlag : undefined
+    );
+
+    const apiKeyFlag = pi.getFlag("--minimax-api-key");
+    const hostFlag = pi.getFlag("--minimax-api-host");
+    const maxBytesFlag = pi.getFlag("--minimax-mcp-max-bytes");
+    const maxLinesFlag = pi.getFlag("--minimax-mcp-max-lines");
+
+    return mergeConfig({
+      apiKey: typeof apiKeyFlag === "string" ? apiKeyFlag : baseConfig.apiKey,
+      apiHost: typeof hostFlag === "string" ? hostFlag : baseConfig.apiHost,
+      maxBytes:
+        typeof maxBytesFlag === "string"
+          ? parseInt(maxBytesFlag, 10)
+          : baseConfig.maxBytes,
+      maxLines:
+        typeof maxLinesFlag === "string"
+          ? parseInt(maxLinesFlag, 10)
+          : baseConfig.maxLines,
+    });
+  };
+
+  // Tool parameter schemas
+  const webSearchParams = Type.Object(
+    {
+      query: Type.String({ description: "Search query" }),
+      numResults: Type.Optional(
+        Type.Integer({
+          description: "Number of results to return (default: 5)",
+          minimum: 1,
+          maximum: 10,
+        })
+      ),
+      recencyDays: Type.Optional(
+        Type.Integer({
+          description: "Limit results to recent days",
+          minimum: 1,
+        })
+      ),
+    },
+    { additionalProperties: false }
+  );
+
+  const understandImageParams = Type.Object(
+    {
+      imagePath: Type.String({
+        description: "Path to image file (relative or absolute)",
+      }),
+      prompt: Type.Optional(
+        Type.String({
+          description: "Optional prompt to guide image understanding",
+        })
+      ),
+    },
+    { additionalProperties: false }
+  );
+
+  // Register web_search tool
+  pi.registerTool({
+    name: "web_search",
+    label: "MiniMax Web Search",
+    description:
+      "Real-time web search via MiniMax. Best for current information, news, documentation, and facts.",
+    parameters: webSearchParams,
+    async execute(_toolCallId, params, onUpdate, _ctx, signal) {
+      const config = getConfig();
+
+      try {
+        validateConfig(config);
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text:
+                err instanceof Error
+                  ? err.message
+                  : "MiniMax configuration error",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (signal?.aborted) {
+        return { content: [{ type: "text", text: "Cancelled" }] };
+      }
+
+      onUpdate?.({
+        content: [{ type: "text", text: `Searching: "${params.query}"...` }],
+        details: { status: "pending" },
+      });
+
+      const client = new MiniMaxMcpClient(config);
+
+      try {
+        const result = await client.webSearch({
+          query: params.query,
+          numResults: params.numResults,
+          recencyDays: params.recencyDays,
+        });
+
+        if (signal?.aborted) {
+          return { content: [{ type: "text", text: "Cancelled" }] };
+        }
+
+        const formatted = formatToolOutput(result, {
+          maxBytes: config.maxBytes,
+          maxLines: config.maxLines,
+        });
+
+        return {
+          content: [{ type: "text", text: formatted.text }],
+          details: {
+            ...formatted.details,
+            config: redactSensitiveData(config),
+          },
+          isError: result.isError,
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `MiniMax MCP error: ${message}` }],
+          isError: true,
+          details: {
+            error: message,
+            config: redactSensitiveData(config),
+          },
+        };
+      } finally {
+        client.disconnect();
+      }
+    },
+  });
+
+  // Register understand_image tool
+  pi.registerTool({
+    name: "understand_image",
+    label: "MiniMax Image Understanding",
+    description:
+      "Analyze and describe image content via MiniMax. Best for screenshots, diagrams, photos, and visual analysis.",
+    parameters: understandImageParams,
+    async execute(_toolCallId, params, onUpdate, _ctx, signal) {
+      const config = getConfig();
+
+      try {
+        validateConfig(config);
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text:
+                err instanceof Error
+                  ? err.message
+                  : "MiniMax configuration error",
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      if (signal?.aborted) {
+        return { content: [{ type: "text", text: "Cancelled" }] };
+      }
+
+      onUpdate?.({
+        content: [{ type: "text", text: "Analyzing image..." }],
+        details: { status: "pending" },
+      });
+
+      const client = new MiniMaxMcpClient(config);
+
+      try {
+        const result = await client.understandImage({
+          imagePath: params.imagePath,
+          prompt: params.prompt,
+        });
+
+        if (signal?.aborted) {
+          return { content: [{ type: "text", text: "Cancelled" }] };
+        }
+
+        const formatted = formatToolOutput(result, {
+          maxBytes: config.maxBytes,
+          maxLines: config.maxLines,
+        });
+
+        return {
+          content: [{ type: "text", text: formatted.text }],
+          details: {
+            ...formatted.details,
+            config: redactSensitiveData(config),
+          },
+          isError: result.isError,
+        };
+      } catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `MiniMax MCP error: ${message}` }],
+          isError: true,
+          details: {
+            error: message,
+            config: redactSensitiveData(config),
+          },
+        };
+      } finally {
+        client.disconnect();
+      }
+    },
+  });
+}