mcp-agents 0.5.3 → 0.5.5

package/README.md

@@ -37,7 +37,9 @@ mcp-agents
 # Specific provider
 mcp-agents --provider claude
 mcp-agents --provider gemini
-mcp-agents --provider gemini --sandbox false
+
+# Optional: enable Gemini sandbox mode
+mcp-agents --provider gemini --sandbox true
 ```
 
 The server speaks [JSON-RPC over stdio](https://modelcontextprotocol.io/docs/concepts/transports#stdio). It prints `[mcp-agents] ready (provider: <name>)` to stderr when it's listening.
@@ -57,7 +59,9 @@ Each `--provider` flag maps to a single exposed tool:
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `prompt` | `string` | yes | The prompt to send to Claude Code |
-| `timeout_ms` | `integer` | no | Timeout in ms (default: 120 000) |
+| `timeout_ms` | `integer` | no | Timeout in ms (default: 300 000 / 5 minutes) |
+
+Any additional `tools/call` arguments are ignored (for example `model` or `model_reasoning_effort`).
 
 ### `gemini` parameters
 
@@ -65,7 +69,9 @@ Each `--provider` flag maps to a single exposed tool:
 |-----------|------|----------|-------------|
 | `prompt` | `string` | yes | The prompt to send to Gemini CLI |
 | `sandbox` | `boolean` | no | Run in sandbox mode (`-s` flag, default: false) |
-| `timeout_ms` | `integer` | no | Timeout in ms (default: 120 000) |
+| `timeout_ms` | `integer` | no | Timeout in ms (default: 300 000 / 5 minutes) |
+
+Any additional `tools/call` arguments are ignored (for example `model` or `model_reasoning_effort`).
 
 ### `codex` (pass-through)
 
@@ -92,20 +98,33 @@ Add entries to your project's `.mcp.json` (requires `npm i -g mcp-agents`):
     },
     "gemini": {
       "command": "mcp-agents",
-      "args": ["--provider", "gemini", "--sandbox", "false"]
+      "args": ["--provider", "gemini"]
+    }
+  }
+}
+```
+
+Optional Gemini sandbox mode in `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "gemini": {
+      "command": "mcp-agents",
+      "args": ["--provider", "gemini", "--sandbox", "true"]
     }
   }
 }
 ```
 
-Override codex defaults:
+Override codex defaults at server startup (not via `tools/call` arguments):
 
 ```json
 {
   "mcpServers": {
     "codex": {
       "command": "mcp-agents",
-      "args": ["--provider", "codex", "--model", "o3-pro", "--model_reasoning_effort", "medium"]
+      "args": ["--provider", "codex", "--model", "gpt-5.3-codex", "--model_reasoning_effort", "medium"]
     }
   }
 }
@@ -132,16 +151,28 @@ Override codex defaults:
 
 ## Integration with OpenAI Codex
 
-Add two entries to `~/.codex/config.toml` — one per provider you want available:
+Add two entries to `~/.codex/config.toml` — one per provider you want available.
+Set `tool_timeout_sec = 300` to avoid Codex MCP's default 60s per-tool timeout:
 
 ```toml
 [mcp_servers.claude-code]
 command = "mcp-agents"
 args = ["--provider", "claude"]
+tool_timeout_sec = 300
+
+[mcp_servers.gemini]
+command = "mcp-agents"
+args = ["--provider", "gemini"]
+tool_timeout_sec = 300
+```
 
+Optional Gemini sandbox mode in Codex config:
+
+```toml
 [mcp_servers.gemini]
 command = "mcp-agents"
-args = ["--provider", "gemini", "--sandbox", "false"]
+args = ["--provider", "gemini", "--sandbox", "true"]
+tool_timeout_sec = 300
 ```
 
 Then in a Codex session you can call the `claude_code` or `gemini` tools, which shell out to the respective CLIs.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-agents",
-  "version": "0.5.3",
+  "version": "0.5.5",
   "description": "MCP server that wraps AI CLI tools (Claude Code, Gemini CLI, Codex CLI) for use by any MCP client",
   "type": "module",
   "bin": {

package/server.js

@@ -29,7 +29,8 @@ const CLI_BACKENDS = {
   claude: {
     command: "claude",
     toolName: "claude_code",
-    description: "Run Claude Code CLI with a prompt (via stdin).",
+    description:
+      "Run Claude Code CLI with a prompt (via stdin). Supports prompt + optional timeout_ms only; other arguments are ignored.",
     stdinPrompt: true,
     buildArgs: () => ["--no-session-persistence", "-p"],
     extraProperties: {},
@@ -37,7 +38,8 @@ const CLI_BACKENDS = {
   gemini: {
     command: "gemini",
     toolName: "gemini",
-    description: "Run Gemini CLI (gemini -p) with a prompt.",
+    description:
+      "Run Gemini CLI (gemini -p) with a prompt. Supports prompt + optional timeout_ms/sandbox only; other arguments are ignored.",
     stdinPrompt: false,
     buildArgs: (prompt, opts) => {
       const args = [];
@@ -352,7 +354,7 @@ async function main() {
   const properties = {
     prompt: {
       type: "string",
-      description: `Prompt for ${backend.command}`,
+      description: `Prompt for ${backend.command}. Unsupported extra arguments are ignored.`,
     },
     timeout_ms: {
       type: "integer",
@@ -379,7 +381,7 @@ async function main() {
         description: backend.description,
         inputSchema: {
           type: "object",
-          additionalProperties: false,
+          additionalProperties: true,
           properties,
           required: ["prompt"],
         },
@@ -404,8 +406,26 @@ async function main() {
       };
     }
 
-    const prompt = toStringArg(params.arguments?.prompt);
-    const timeoutMsRaw = params.arguments?.timeout_ms;
+    const rawArgs =
+      params.arguments && typeof params.arguments === "object"
+        ? params.arguments
+        : {};
+    const allowedArgKeys = new Set([
+      "prompt",
+      "timeout_ms",
+      ...Object.keys(backend.extraProperties),
+    ]);
+    const ignoredArgKeys = Object.keys(rawArgs).filter(
+      (key) => !allowedArgKeys.has(key),
+    );
+    if (ignoredArgKeys.length > 0) {
+      logErr(
+        `[mcp-agents] tools/call: ignoring unsupported args: ${ignoredArgKeys.join(", ")}`,
+      );
+    }
+
+    const prompt = toStringArg(rawArgs.prompt);
+    const timeoutMsRaw = rawArgs.timeout_ms;
     const timeoutMs = Number.isInteger(timeoutMsRaw)
       ? timeoutMsRaw
       : effectiveTimeout;
@@ -424,7 +444,7 @@ async function main() {
 
     const extraOpts = {};
     for (const key of Object.keys(backend.extraProperties)) {
-      extraOpts[key] = params.arguments?.[key] ?? backend.extraProperties[key].default;
+      extraOpts[key] = rawArgs[key] ?? backend.extraProperties[key].default;
     }
 
     const cliArgs = backend.stdinPrompt