@zhixuan92/multi-model-agent-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Zhang Zhixuan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,153 @@
+# @zhixuan92/multi-model-agent-mcp
+
+MCP stdio server for [`multi-model-agent`](https://github.com/zhixuan312/multi-model-agent). Exposes one tool — `delegate_tasks` — that runs work in parallel across multiple LLM providers (Claude, Codex, OpenAI-compatible) and auto-routes each task to the cheapest provider that can handle it.
+
+## Install
+
+```bash
+# Run without installing
+npx @zhixuan92/multi-model-agent-mcp serve
+
+# Or install globally
+npm install -g @zhixuan92/multi-model-agent-mcp
+multi-model-agent serve
+```
+
+If you plan to use `openai-compatible` providers, also install the optional peer dependencies:
+
+```bash
+npm install -g @zhixuan92/multi-model-agent-mcp @openai/agents openai
+```
+
+Requires Node `>= 22`.
+
+## Configure
+
+Create `~/.multi-model/config.json`:
+
+```json
+{
+  "providers": {
+    "claude": {
+      "type": "claude",
+      "model": "claude-sonnet-4-6",
+      "costTier": "medium"
+    },
+    "codex": {
+      "type": "codex",
+      "model": "gpt-5-codex",
+      "costTier": "medium"
+    },
+    "minimax": {
+      "type": "openai-compatible",
+      "model": "MiniMax-M2",
+      "baseUrl": "https://api.minimax.io/v1",
+      "apiKeyEnv": "MINIMAX_API_KEY",
+      "costTier": "free",
+      "hostedTools": ["web_search"]
+    }
+  },
+  "defaults": {
+    "maxTurns": 200,
+    "timeoutMs": 600000,
+    "tools": "full"
+  }
+}
+```
+
+Config lookup order: `--config <path>` → `MULTI_MODEL_CONFIG` env var → `~/.multi-model/config.json`.
+
+Provider auth:
+
+- **`codex`** uses `codex login` if available, otherwise `OPENAI_API_KEY`
+- **`claude`** uses `ANTHROPIC_API_KEY` if set, otherwise the local Claude auth flow
+- **`openai-compatible`** uses `apiKeyEnv` (preferred) or inline `apiKey`
+
+## Register with an MCP client
+
+### Claude Code
+
+```bash
+claude mcp add multi-model-agent -- npx @zhixuan92/multi-model-agent-mcp serve
+```
+
+If your providers need environment variables:
+
+```bash
+claude mcp add multi-model-agent \
+  -e OPENAI_API_KEY=sk-... \
+  -e ANTHROPIC_API_KEY=sk-ant-... \
+  -e MINIMAX_API_KEY=... \
+  -- npx @zhixuan92/multi-model-agent-mcp serve
+```
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "multi-model-agent": {
+      "command": "npx",
+      "args": ["@zhixuan92/multi-model-agent-mcp", "serve"],
+      "env": {
+        "OPENAI_API_KEY": "sk-...",
+        "ANTHROPIC_API_KEY": "sk-ant-...",
+        "MINIMAX_API_KEY": "..."
+      }
+    }
+  }
+}
+```
+
+Restart your MCP client after changing config.
+
+## The `delegate_tasks` tool
+
+Accepts an array of tasks and runs them concurrently. Auto-routes each task by capability filter → quality tier filter → cheapest remaining provider, or pin a task to a specific provider.
+
+```json
+{
+  "tasks": [
+    {
+      "prompt": "Refactor auth.ts to use JWT.",
+      "provider": "claude",
+      "tier": "reasoning",
+      "requiredCapabilities": ["file_read", "file_write"],
+      "tools": "full",
+      "cwd": "/path/to/project"
+    },
+    {
+      "prompt": "Write tests for the auth module.",
+      "tier": "standard",
+      "requiredCapabilities": ["file_read", "file_write", "grep"],
+      "tools": "full",
+      "cwd": "/path/to/project"
+    }
+  ]
+}
+```
+
+Per-task fields: `prompt`, `tier`, `requiredCapabilities`, `provider?`, `tools?`, `maxTurns?`, `timeoutMs?`, `cwd?`, `effort?`, `sandboxPolicy?`.
+
+Capabilities: `file_read`, `file_write`, `grep`, `glob`, `shell`, `web_search`, `web_fetch`.
+
+## Security
+
+- File tools enforce a `cwd-only` sandbox by default — paths are resolved via `fs.realpath` and rejected if outside the task's `cwd`.
+- `runShell` is hard-disabled under `cwd-only`. Set `sandboxPolicy: 'none'` per-provider or per-task to opt in.
+- `readFile` rejects targets larger than 50 MiB; `writeFile` rejects content larger than 100 MiB.
+- The server warns at config-load time if it sees an inline `apiKey` instead of `apiKeyEnv`.
+- The server warns once if `~/.codex/auth.json` is group- or world-readable.
+- `CODEX_DEBUG=1` enables raw request/response logging to stderr (do not enable in environments that ship logs anywhere).
+
+## Documentation
+
+Full docs, capability matrix, configuration reference, troubleshooting, and contributor guide:
+
+→ **<https://github.com/zhixuan312/multi-model-agent#readme>**
+
+## License
+
+[MIT](./LICENSE) — Copyright (c) 2026 Zhang Zhixuan

package/dist/cli.d.ts

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+export declare const SERVER_NAME = "multi-model-agent";
+export declare const SERVER_VERSION = "0.1.0";
+export declare function buildTaskSchema(availableProviders: [string, ...string[]]): z.ZodObject<{
+    prompt: z.ZodString;
+    provider: z.ZodOptional<z.ZodEnum<{
+        [x: string]: string;
+    }>>;
+    tier: z.ZodEnum<{
+        trivial: "trivial";
+        standard: "standard";
+        reasoning: "reasoning";
+    }>;
+    requiredCapabilities: z.ZodArray<z.ZodEnum<{
+        file_read: "file_read";
+        file_write: "file_write";
+        grep: "grep";
+        glob: "glob";
+        shell: "shell";
+        web_search: "web_search";
+        web_fetch: "web_fetch";
+    }>>;
+    tools: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        full: "full";
+    }>>;
+    maxTurns: z.ZodOptional<z.ZodNumber>;
+    timeoutMs: z.ZodOptional<z.ZodNumber>;
+    cwd: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        none: "none";
+    }>>;
+    sandboxPolicy: z.ZodOptional<z.ZodEnum<{
+        none: "none";
+        "cwd-only": "cwd-only";
+    }>>;
+}, z.core.$strip>;
+export declare function buildMcpServer(config: Parameters<typeof runTasks>[1]): McpServer;
+/**
+ * MCP CLI config discovery (owned by MCP, not core):
+ * 1. --config <path> argument (explicit)
+ * 2. MULTI_MODEL_CONFIG environment variable
+ * 3. ~/.multi-model/config.json (default home-directory location)
+ */
+export declare function discoverConfig(): Promise<MultiModelConfig>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAMA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,mCAAmC,CAAC;AAGpF,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAC/C,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,wBAAgB,eAAe,CAAC,kBAAkB,EAAE,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAkBxE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,aAyCpE;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAuBhE"}

package/dist/cli.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { loadConfigFromFile } from '@zhixuan92/multi-model-agent-core/config/load';
+import { parseConfig } from '@zhixuan92/multi-model-agent-core/config/schema';
+import { runTasks } from '@zhixuan92/multi-model-agent-core/run-tasks';
+import { renderProviderRoutingMatrix } from './routing/render-provider-routing-matrix.js';
+export const SERVER_NAME = 'multi-model-agent';
+export const SERVER_VERSION = '0.1.0';
+export function buildTaskSchema(availableProviders) {
+    return z.object({
+        prompt: z.string().describe('Task prompt for the sub-agent'),
+        provider: z.enum(availableProviders).describe('Provider name').optional(),
+        tier: z.enum(['trivial', 'standard', 'reasoning'])
+            .describe('Required quality tier.'),
+        requiredCapabilities: z.array(z.enum([
+            'file_read', 'file_write', 'grep', 'glob',
+            'shell', 'web_search', 'web_fetch',
+        ])).describe('Capabilities this task requires. Empty array if none.'),
+        tools: z.enum(['none', 'full']).optional().describe('Tool access mode. Default: full'),
+        maxTurns: z.number().int().positive().optional().describe('Max agent loop turns. Default: 200'),
+        timeoutMs: z.number().int().positive().optional().describe('Timeout in ms. Default: 600000'),
+        cwd: z.string().optional().describe('Working directory for file/shell tools'),
+        effort: z.enum(['none', 'low', 'medium', 'high']).optional()
+            .describe("Reasoning effort."),
+        sandboxPolicy: z.enum(['none', 'cwd-only']).optional().describe('File-system confinement policy. Default: cwd-only'),
+    });
+}
+export function buildMcpServer(config) {
+    const providerKeys = Object.keys(config.providers);
+    if (providerKeys.length === 0) {
+        throw new Error('buildMcpServer requires at least one configured provider.');
+    }
+    const server = new McpServer({
+        name: SERVER_NAME,
+        version: SERVER_VERSION,
+    });
+    const availableProviders = providerKeys;
+    server.tool('delegate_tasks', renderProviderRoutingMatrix(config), {
+        tasks: z.array(buildTaskSchema(availableProviders)).describe('Array of tasks to execute in parallel'),
+    }, async ({ tasks }) => {
+        const results = await runTasks(tasks, config);
+        const response = {
+            results: results.map((r, i) => ({
+                provider: tasks[i].provider ?? '(auto)',
+                status: r.status,
+                output: r.output,
+                turns: r.turns,
+                files: r.files,
+                usage: r.usage,
+                ...(r.error && { error: r.error }),
+            })),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(response, null, 2) }],
+        };
+    });
+    return server;
+}
+/**
+ * MCP CLI config discovery (owned by MCP, not core):
+ * 1. --config <path> argument (explicit)
+ * 2. MULTI_MODEL_CONFIG environment variable
+ * 3. ~/.multi-model/config.json (default home-directory location)
+ */
+export async function discoverConfig() {
+    const args = process.argv.slice(2);
+    // 1. Explicit --config
+    const configFlagIdx = args.indexOf('--config');
+    if (configFlagIdx >= 0 && args[configFlagIdx + 1]) {
+        return loadConfigFromFile(args[configFlagIdx + 1]);
+    }
+    // 2. MULTI_MODEL_CONFIG env var (file path)
+    const envPath = process.env.MULTI_MODEL_CONFIG;
+    if (envPath) {
+        return loadConfigFromFile(envPath);
+    }
+    // 3. ~/.multi-model/config.json
+    const defaultPath = path.join(os.homedir(), '.multi-model', 'config.json');
+    if (fs.existsSync(defaultPath)) {
+        return loadConfigFromFile(defaultPath);
+    }
+    // Fallback: empty config
+    return parseConfig({});
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args[0] !== 'serve') {
+        console.error('Usage: multi-model-agent serve [--config <path>]');
+        process.exit(1);
+    }
+    const config = await discoverConfig();
+    const providerNames = Object.keys(config.providers);
+    if (providerNames.length === 0) {
+        console.error('No providers configured. Create ~/.multi-model/config.json or pass --config <path>.');
+        process.exit(1);
+    }
+    const server = buildMcpServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+// Only run main when executed directly
+const thisFile = fileURLToPath(import.meta.url);
+const isDirectRun = (() => {
+    if (!process.argv[1])
+        return false;
+    try {
+        return fs.realpathSync(process.argv[1]) === fs.realpathSync(thisFile);
+    }
+    catch {
+        return false;
+    }
+})();
+if (isDirectRun) {
+    main().catch((err) => {
+        console.error('Fatal:', err);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,+CAA+C,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,iDAAiD,CAAC;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AAEvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,6CAA6C,CAAC;AAE1F,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAC/C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAEtC,MAAM,UAAU,eAAe,CAAC,kBAAyC;IACvE,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;QAC5D,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;QACzE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;aAC/C,QAAQ,CAAC,wBAAwB,CAAC;QACrC,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACnC,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM;YACzC,OAAO,EAAE,YAAY,EAAE,WAAW;SACnC,CAAC,CAAC,CAAC,QAAQ,CAAC,uDAAuD,CAAC;QACrE,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;QACtF,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oCAAoC,CAAC;QAC/F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC5F,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QAC7E,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;aACzD,QAAQ,CAAC,mBAAmB,CAAC;QAChC,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;KACrH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAsC;IACnE,MAAM,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACnD,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,cAAc;KACxB,CAAC,CAAC;IAEH,MAAM,kBAAkB,GAAG,YAAqC,CAAC;IAEjE,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,2BAA2B,CAAC,MAAM,CAAC,EACnC;QACE,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,uCAAuC,CAAC;KACtG,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAClB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,KAAmB,EAAE,MAAM,CAAC,CAAC;QAE5D,MAAM,QAAQ,GAAG;YACf,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9B,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,QAAQ;gBACvC,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,KAAK,EAAE,CAAC,CAAC,KAAK;gBACd,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;aACnC,CAAC,CAAC;SACJ,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC9E,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,uBAAuB;IACvB,MAAM,aAAa,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/C,IAAI,aAAa,IAAI,CAAC,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,EAAE,CAAC;QAClD,OAAO,kBAAkB,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,4CAA4C;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC/C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,gCAAgC;IAChC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC;IAC3E,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,yBAAyB;IACzB,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC;AACzB,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAC;IACtC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAEpD,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CAAC,qFAAqF,CAAC,CAAC;QACrG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,uCAAuC;AACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAChD,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE;IACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACnC,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC,EAAE,CAAC;AACL,IAAI,WAAW,EAAE,CAAC;IAChB,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { buildMcpServer, buildTaskSchema, SERVER_NAME, SERVER_VERSION } from './cli.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,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { buildMcpServer, buildTaskSchema, SERVER_NAME, SERVER_VERSION } from './cli.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,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/routing/render-provider-routing-matrix.d.ts

@@ -0,0 +1,7 @@
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+/**
+ * Renders the full routing matrix for the MCP tool description.
+ * Helps the consuming LLM understand provider capabilities and routing rules.
+ */
+export declare function renderProviderRoutingMatrix(config: MultiModelConfig): string;
+//# sourceMappingURL=render-provider-routing-matrix.d.ts.map

package/dist/routing/render-provider-routing-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-provider-routing-matrix.d.ts","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAc,gBAAgB,EAAkB,MAAM,mCAAmC,CAAC;AAmDtG;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAkB5E"}

package/dist/routing/render-provider-routing-matrix.js

@@ -0,0 +1,63 @@
+import { getBaseCapabilities } from '@zhixuan92/multi-model-agent-core/routing/capabilities';
+import { findModelProfile, getEffectiveCostTier } from '@zhixuan92/multi-model-agent-core/routing/model-profiles';
+const ROUTING_RECIPE = `How to route a task:
+1. Capability filter (HARD): exclude providers missing any required capability.
+2. Quality filter: exclude providers whose tier is below the task's tier.
+   Tier ordering: trivial < standard < reasoning.
+3. Cost preference (STRONG): among the remainder, prefer the cheapest tier.
+   If a 'free' provider qualifies, pick it. Only escalate to paid tiers when
+   the task tier or required capabilities demand it.
+
+Tier guidance for the consumer LLM:
+- 'trivial' — well-defined edits, lookups, formatting. One obvious answer.
+- 'standard' — most code work. Clear spec, multiple valid approaches.
+- 'reasoning' — ambiguous, architectural, research, or high-stakes.
+  Use when requirements are unclear or judgment is required.
+
+Optional 'effort' knob (per task):
+- Only providers marked 'effort: supported' in the matrix honor this field.
+- Use 'high' for reasoning-tier tasks when you want maximum depth,
+  'medium' for balanced, 'low' for fast-but-shallow, 'none' to disable
+  thinking entirely on providers that default it on. Omit the field on
+  providers that do not support it.`;
+function renderProviderBlock(name, config, capabilities, profile, costSource) {
+    const cost = getEffectiveCostTier(config);
+    const costSuffix = costSource === 'config' ? ' (from config)' : '';
+    const effortLabel = profile.supportsEffort ? 'supported' : 'not supported';
+    const lines = [
+        `${name} (${config.model})`,
+        `  tools: ${capabilities.join(', ')}`,
+        `  tier: ${profile.tier} | cost: ${cost}${costSuffix} | effort: ${effortLabel}`,
+        `  best for: ${profile.bestFor}`,
+    ];
+    if (profile.notes) {
+        lines.push(`  note: ${profile.notes}`);
+    }
+    if (profile.avoidFor) {
+        lines.push(`  avoid for: ${profile.avoidFor}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Renders the full routing matrix for the MCP tool description.
+ * Helps the consuming LLM understand provider capabilities and routing rules.
+ */
+export function renderProviderRoutingMatrix(config) {
+    const blocks = Object.entries(config.providers).map(([name, providerConfig]) => {
+        const capabilities = getBaseCapabilities(providerConfig);
+        const profile = findModelProfile(providerConfig.model);
+        const costSource = providerConfig.costTier ? 'config' : 'default';
+        return renderProviderBlock(name, providerConfig, capabilities, profile, costSource);
+    });
+    return [
+        'Delegate tasks to sub-agents running on different LLM providers.',
+        'All tasks execute concurrently.',
+        '',
+        'Available providers:',
+        '',
+        blocks.join('\n\n'),
+        '',
+        ROUTING_RECIPE,
+    ].join('\n');
+}
+//# sourceMappingURL=render-provider-routing-matrix.js.map

package/dist/routing/render-provider-routing-matrix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-provider-routing-matrix.js","sourceRoot":"","sources":["../../src/routing/render-provider-routing-matrix.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,wDAAwD,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAGlH,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;oCAmBa,CAAC;AAErC,SAAS,mBAAmB,CAC1B,IAAY,EACZ,MAAsB,EACtB,YAA0B,EAC1B,OAAqB,EACrB,UAAgC;IAEhC,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,UAAU,GAAG,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,eAAe,CAAC;IAC3E,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,KAAK,MAAM,CAAC,KAAK,GAAG;QAC3B,YAAY,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACrC,WAAW,OAAO,CAAC,IAAI,YAAY,IAAI,GAAG,UAAU,cAAc,WAAW,EAAE;QAC/E,eAAe,OAAO,CAAC,OAAO,EAAE;KACjC,CAAC;IACF,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrB,KAAK,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,2BAA2B,CAAC,MAAwB;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,EAAE;QAC7E,MAAM,YAAY,GAAG,mBAAmB,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,OAAO,GAAG,gBAAgB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACvD,MAAM,UAAU,GAAyB,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,OAAO,mBAAmB,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,kEAAkE;QAClE,iCAAiC;QACjC,EAAE;QACF,sBAAsB;QACtB,EAAE;QACF,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;QACnB,EAAE;QACF,cAAc;KACf,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@zhixuan92/multi-model-agent-mcp",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "MCP server for multi-model-agent. Exposes a delegate_tasks tool that routes work to Claude, Codex, or OpenAI-compatible sub-agents based on capability, quality tier, and cost.",
+  "author": "Zhang Zhixuan <zhangzhixuan312@gmail.com>",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "llm",
+    "claude",
+    "codex",
+    "openai",
+    "agent",
+    "multi-model",
+    "delegation"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zhixuan312/multi-model-agent.git",
+    "directory": "packages/mcp"
+  },
+  "homepage": "https://github.com/zhixuan312/multi-model-agent#readme",
+  "bugs": "https://github.com/zhixuan312/multi-model-agent/issues",
+  "files": ["dist"],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "multi-model-agent": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./routing/render-provider-routing-matrix": {
+      "types": "./dist/routing/render-provider-routing-matrix.d.ts",
+      "import": "./dist/routing/render-provider-routing-matrix.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "engines": { "node": ">=22.0.0" },
+  "dependencies": {
+    "@zhixuan92/multi-model-agent-core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^4.0.0"
+  },
+  "peerDependencies": {
+    "@openai/agents": "^0.8.0",
+    "openai": "^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@openai/agents": { "optional": true },
+    "openai": { "optional": true }
+  }
+}