@runpod/mcp-server 4.2.0 → 4.3.0

package/dist/stdio.cjs

@@ -224,7 +224,7 @@ function jsonClient(opts) {
       (opts.detectPaths?.() ?? [path.dirname(opts.configPath())]).some(exists)
     ),
     add: (mode) => {
-      const value = mode.kind === "local" ? localServerConfig(mode.apiKey, serverProperty) : hostedServerConfig(hostedStrategy, serverProperty, mode.url);
+      const value = opts.serverValue ? opts.serverValue(mode) : mode.kind === "local" ? localServerConfig(mode.apiKey, serverProperty) : hostedServerConfig(hostedStrategy, serverProperty, mode.url);
       return Promise.resolve(
         upsertJsonServer(opts.configPath(), serverProperty, value, opts.dialect)
       );
@@ -702,6 +702,31 @@ function vsCodeConfigPath() {
     "mcp.json"
   );
 }
+function xdgConfigHome() {
+  return absoluteEnvDir(
+    process.env.XDG_CONFIG_HOME,
+    () => path.join(home, ".config")
+  );
+}
+function opencodeConfigPath() {
+  const dir = path.join(xdgConfigHome(), "opencode");
+  const jsoncPath = path.join(dir, "opencode.jsonc");
+  return exists(jsoncPath) ? jsoncPath : path.join(dir, "opencode.json");
+}
+function opencodeServerValue(mode) {
+  return mode.kind === "local" ? {
+    type: "local",
+    command: ["npx", "-y", NPM_PACKAGE],
+    environment: { RUNPOD_API_KEY: mode.apiKey },
+    enabled: true
+  } : { type: "remote", url: mode.url, enabled: true };
+}
+function piMcpConfigPath() {
+  const configured = process.env.PI_CODING_AGENT_DIR?.trim();
+  if (!configured) return path.join(home, ".pi", "agent", "mcp.json");
+  const expanded = configured === "~" ? home : configured.startsWith("~/") ? path.join(home, configured.slice(2)) : configured;
+  return path.join(expanded, "mcp.json");
+}
 var fs, os, path, import_child_process, jsonc, SERVER_NAME2, NPM_PACKAGE, HOSTED_URL, PROJECT_BOUNDARY_MARKERS, CMD_META, KEY_PLACEHOLDER, claudeCodeClient, home, CLIENTS;
 var init_clients = __esm({
   "src/install/clients.ts"() {
@@ -770,6 +795,25 @@ var init_clients = __esm({
         dialect: "jsonc",
         configPath: vsCodeConfigPath,
         detectPaths: () => [path.dirname(vsCodeConfigPath())]
+      }),
+      jsonClient({
+        id: "opencode",
+        name: "opencode",
+        serverProperty: "mcp",
+        // Loaded a commented, trailing-comma config when run; see ConfigDialect.
+        dialect: "jsonc",
+        configPath: opencodeConfigPath,
+        detectPaths: () => [path.dirname(opencodeConfigPath())],
+        serverValue: opencodeServerValue
+      }),
+      jsonClient({
+        id: "pi",
+        name: "Pi",
+        // Rejected a single comment when run; see ConfigDialect.
+        dialect: "json",
+        // Native Streamable HTTP (`pi mcp add --url` writes exactly `{ url }`).
+        configPath: piMcpConfigPath,
+        detectPaths: () => [path.dirname(piMcpConfigPath())]
       })
     ];
   }
@@ -802,6 +846,68 @@ var init_verify_key = __esm({
   }
 });
 
+// src/install/args.ts
+function parseWizardArgs(argv, knownIds) {
+  const parsed = { help: false, list: false, errors: [] };
+  const addClients = (raw, flag) => {
+    if (raw === void 0 || raw.startsWith("-")) {
+      parsed.errors.push(`${flag} needs a value, e.g. ${flag} cursor`);
+      return;
+    }
+    for (const id of raw.split(",").map((s) => s.trim().toLowerCase())) {
+      if (!id) continue;
+      if (!knownIds.includes(id)) {
+        parsed.errors.push(
+          `unknown client "${id}". Supported: ${knownIds.join(", ")}`
+        );
+        continue;
+      }
+      parsed.clients ??= [];
+      if (!parsed.clients.includes(id)) parsed.clients.push(id);
+    }
+  };
+  const setMode = (mode) => {
+    if (parsed.mode && parsed.mode !== mode)
+      parsed.errors.push("--hosted and --local cannot be combined");
+    parsed.mode = mode;
+  };
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "-h" || arg === "--help") parsed.help = true;
+    else if (arg === "--list") parsed.list = true;
+    else if (arg === "--hosted") setMode("hosted");
+    else if (arg === "--local") setMode("local");
+    else if (arg === "--client" || arg === "-c") addClients(argv[++i], arg);
+    else if (arg.startsWith("--client="))
+      addClients(arg.slice("--client=".length), "--client");
+    else parsed.errors.push(`unknown option "${arg}"`);
+  }
+  return parsed;
+}
+function wizardUsage(knownIds) {
+  return [
+    "Usage:",
+    "  npx @runpod/mcp-server@latest add                       interactive setup (needs a terminal)",
+    "  npx @runpod/mcp-server@latest add --client <ids>        no prompts: configure these clients",
+    "  npx @runpod/mcp-server@latest remove --client <ids>     no prompts: remove Runpod from them",
+    "  npx @runpod/mcp-server@latest add --list                list clients, whether each is detected, and its config file",
+    "",
+    "Options:",
+    `  -c, --client <ids>  comma-separated or repeated: ${knownIds.join(", ")}`,
+    "  --hosted            connect to the hosted server and sign in with Runpod (OAuth); the default",
+    "  --local             run the server locally with the API key in RUNPOD_API_KEY",
+    "                      (read from the environment only, never from an argument)",
+    "  -h, --help          show this help",
+    "",
+    "Exit codes: 0 configured, 1 a client failed, 2 bad usage or no terminal for prompts."
+  ].join("\n");
+}
+var init_args = __esm({
+  "src/install/args.ts"() {
+    "use strict";
+  }
+});
+
 // src/install/wizard.ts
 var wizard_exports = {};
 __export(wizard_exports, {
@@ -950,15 +1056,107 @@ async function runRemove() {
   p.note(results.join("\n"), "Results");
   p.outro("Done.");
 }
-async function runWizard(subcommand2) {
+function signInStep(client) {
+  return SIGN_IN[client.id] ?? 'restart it; it opens "Sign in with Runpod" when it connects';
+}
+async function runNonInteractive(subcommand2, clientIds, requestedMode) {
+  const clients = clientIds.map((id) => CLIENTS.find((c) => c.id === id));
+  if (subcommand2 === "remove") {
+    let failed2 = 0;
+    for (const client of clients) {
+      const result = await client.remove();
+      if (!result.success) failed2++;
+      console.log(
+        `${result.success ? "\u2713" : "\u2717"} ${client.name}${result.message ? ` \u2014 ${result.message}` : ""}`
+      );
+    }
+    return failed2 ? 1 : 0;
+  }
+  let mode = { kind: "hosted", url: HOSTED_URL };
+  if (requestedMode === "local") {
+    const apiKey = process.env.RUNPOD_API_KEY?.trim();
+    if (!apiKey) {
+      console.error(
+        "--local reads the API key from RUNPOD_API_KEY, which is not set. Export it, or use --hosted to sign in with Runpod instead."
+      );
+      return 2;
+    }
+    const valid = await verifyApiKey(apiKey);
+    if (valid === false) {
+      console.error(
+        "RUNPOD_API_KEY was rejected by Runpod. Nothing was configured."
+      );
+      return 1;
+    }
+    if (valid === null)
+      console.error("Could not verify RUNPOD_API_KEY (offline?). Continuing.");
+    mode = { kind: "local", apiKey };
+  }
+  let failed = 0;
+  for (const client of clients) {
+    const result = await client.add(mode);
+    if (result.success) {
+      console.log(
+        `\u2713 ${client.name} \u2014 ${result.message ? `${result.message}; ` : ""}${client.describeTarget()}`
+      );
+    } else {
+      failed++;
+      console.log(`\u2717 ${client.name} \u2014 ${result.message ?? "unknown error"}`);
+    }
+  }
+  for (const client of clients) {
+    console.log(
+      mode.kind === "hosted" ? `Next for ${client.name}: ${signInStep(client)}.` : `Next for ${client.name}: restart it (or reconnect MCP) to load the Runpod tools.`
+    );
+  }
+  return failed ? 1 : 0;
+}
+async function listClients() {
+  const detected = await detectAll();
+  for (const client of CLIENTS) {
+    console.log(
+      `${client.id.padEnd(15)} ${detected.get(client.id) ? "detected    " : "not detected"}  ${client.describeTarget()}`
+    );
+  }
+}
+async function runWizard(subcommand2, argv = process.argv.slice(3), isInteractive = Boolean(process.stdin.isTTY && process.stdout.isTTY)) {
+  const ids = CLIENTS.map((c) => c.id);
+  const args = parseWizardArgs(argv, ids);
+  if (args.errors.length) {
+    for (const error of args.errors) console.error(`error: ${error}`);
+    console.error(`
+${wizardUsage(ids)}`);
+    return 2;
+  }
+  if (args.help) {
+    console.log(wizardUsage(ids));
+    return 0;
+  }
+  if (args.list) {
+    await listClients();
+    return 0;
+  }
+  if (args.clients) {
+    return runNonInteractive(subcommand2, args.clients, args.mode);
+  }
+  if (!isInteractive) {
+    console.error(
+      `This installer needs an interactive terminal to show its prompts, and none is attached. Nothing was configured.
+To run it without prompts, name the clients: npx @runpod/mcp-server@latest ${subcommand2} --client <ids>
+
+${wizardUsage(ids)}`
+    );
+    return 2;
+  }
   p.intro("Runpod MCP server installer");
   if (subcommand2 === "remove") {
     await runRemove();
   } else {
     await runAdd();
   }
+  return 0;
 }
-var import_child_process2, p, API_KEYS_URL;
+var import_child_process2, p, API_KEYS_URL, SIGN_IN;
 var init_wizard = __esm({
   "src/install/wizard.ts"() {
     "use strict";
@@ -966,7 +1164,13 @@ var init_wizard = __esm({
     p = __toESM(require("@clack/prompts"), 1);
     init_clients();
     init_verify_key();
+    init_args();
     API_KEYS_URL = "https://www.runpod.io/console/user/settings";
+    SIGN_IN = {
+      "claude-code": "in Claude Code run /mcp \u2192 runpod \u2192 Sign in with Runpod",
+      opencode: "run `opencode mcp auth runpod`",
+      pi: "run `pi mcp login runpod`"
+    };
   }
 });
 
@@ -975,11 +1179,11 @@ var import_stdio = require("@modelcontextprotocol/sdk/server/stdio.js");
 
 // src/server.ts
 var SERVER_NAME = "Runpod API Server";
-var SERVER_VERSION = true ? "4.2.0" : "dev";
+var SERVER_VERSION = true ? "4.3.0" : "dev";
 
 // src/specgen/server.ts
 var import_server3 = require("@modelcontextprotocol/sdk/server/index.js");
-var import_types = require("@modelcontextprotocol/sdk/types.js");
+var import_types2 = require("@modelcontextprotocol/sdk/types.js");
 
 // src/_shared/rate-limit.ts
 var GENERIC_RATE_LIMIT_HINT = "rate limited \u2014 back off before retrying, and pace bulk operations";
@@ -1179,10 +1383,13 @@ function validateArguments(inputSchema, args) {
 async function dispatchGeneratedTool(client, tool, args) {
   const rejected = validateArguments(tool.inputSchema, args);
   if (rejected) return rejected;
+  const required = new Set(tool.inputSchema.required ?? []);
   const pathParams = {};
   const query = {};
   for (const param of tool.params) {
     if (args[param.name] === void 0) continue;
+    if (param.location === "query" && !required.has(param.name) && isEmptyValue(args[param.name]))
+      continue;
     if (param.location === "path") {
       pathParams[param.name] = args[param.name];
       continue;
@@ -1204,6 +1411,11 @@ async function dispatchGeneratedTool(client, tool, args) {
       };
     }
   }
+  if (tool.hasBody && requestBody !== void 0) {
+    const properties = tool.inputSchema.properties ?? {};
+    const defs = tool.inputSchema.$defs ?? {};
+    requestBody = coerceScalars(requestBody, properties.body, defs);
+  }
   const verbs = client;
   const { data, error, response } = await verbs[tool.method](tool.path, {
     params: { path: pathParams, query },
@@ -1216,6 +1428,79 @@ async function dispatchGeneratedTool(client, tool, args) {
     payload: data ?? { status: response.status }
   };
 }
+function isEmptyValue(value) {
+  return value === null || value === "" || Array.isArray(value) && !value.length;
+}
+function asSchema(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
+}
+function resolveSchema(schema, defs, depth = 0) {
+  const node = asSchema(schema);
+  if (!node || depth > 16) return node;
+  const ref = node.$ref;
+  if (typeof ref === "string" && ref.startsWith("#/$defs/"))
+    return resolveSchema(defs[ref.slice("#/$defs/".length)], defs, depth + 1);
+  return node;
+}
+function branches(schema, defs, depth = 0) {
+  const node = resolveSchema(schema, defs);
+  if (!node || depth > 16) return [];
+  const out = [node];
+  for (const key of ["allOf", "anyOf", "oneOf"]) {
+    const list = node[key];
+    if (Array.isArray(list))
+      for (const sub of list) out.push(...branches(sub, defs, depth + 1));
+  }
+  return out;
+}
+function types(schemas) {
+  const out = /* @__PURE__ */ new Set();
+  for (const s of schemas) {
+    if (typeof s.type === "string") out.add(s.type);
+    else if (Array.isArray(s.type)) {
+      for (const t of s.type) if (typeof t === "string") out.add(t);
+    }
+  }
+  return out;
+}
+var NUMERIC = /^-?(?:0|[1-9]\d*)(?:\.\d+)?$/;
+function coerceScalars(value, schema, defs, depth = 0) {
+  if (depth > 32) return value;
+  const applicable = branches(schema, defs);
+  if (!applicable.length) return value;
+  const allowed = types(applicable);
+  if (typeof value === "string") {
+    if (allowed.has("string")) return value;
+    if ((allowed.has("integer") || allowed.has("number")) && NUMERIC.test(value)) {
+      const n = Number(value);
+      if (allowed.has("number") || Number.isInteger(n)) return n;
+    }
+    if (allowed.has("boolean") && (value === "true" || value === "false"))
+      return value === "true";
+    return value;
+  }
+  if (Array.isArray(value)) {
+    const items = applicable.map((s) => s.items).filter(Boolean);
+    if (!items.length) return value;
+    return value.map(
+      (item) => coerceScalars(item, { anyOf: items }, defs, depth + 1)
+    );
+  }
+  const object = asSchema(value);
+  if (!object) return value;
+  const out = {};
+  for (const [key, child] of Object.entries(object)) {
+    const childSchemas = [];
+    for (const s of applicable) {
+      const props = asSchema(s.properties);
+      if (props && key in props) childSchemas.push(props[key]);
+      else if (asSchema(s.additionalProperties))
+        childSchemas.push(s.additionalProperties);
+    }
+    out[key] = childSchemas.length ? coerceScalars(child, { anyOf: childSchemas }, defs, depth + 1) : child;
+  }
+  return out;
+}
 
 // src/specgen/generated/tools.gen.ts
 var generatedTools = [
@@ -1233,6 +1518,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -1244,11 +1530,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -1260,7 +1545,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -1270,7 +1555,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -1306,6 +1591,21 @@ var generatedTools = [
             }
           }
         },
+        BaseMounts: {
+          type: "object",
+          properties: {
+            persistent: {
+              $ref: "#/$defs/PersistentMount"
+            },
+            network: {
+              type: "array",
+              maxItems: 1,
+              items: {
+                $ref: "#/$defs/NetworkMount"
+              }
+            }
+          }
+        },
         ClusterCompute: {
           type: "object",
           additionalProperties: false,
@@ -1333,6 +1633,15 @@ var generatedTools = [
             }
           }
         },
+        ClusterMounts: {
+          description: "Storage mounts for a cluster create: `persistent` or `network`, not both. Clusters cannot mount global volumes, so `global` is rejected.",
+          allOf: [
+            {
+              $ref: "#/$defs/BaseMounts"
+            }
+          ],
+          unevaluatedProperties: false
+        },
         ClusterType: {
           type: "string",
           description: "Cluster type. TRAINING is the generic distributed-training cluster; SLURM provisions a managed Slurm controller/compute topology; RAY provisions a managed Ray head/worker topology; APPLICATION is a general multi-node application cluster.",
@@ -1347,7 +1656,7 @@ var generatedTools = [
             {
               type: "object",
               required: ["name", "type", "compute"],
-              description: "Request body for creating a cluster. `compute` defines the\nhomogeneous pod shape; the container configuration (image, env, ports,\n\u2026) applies to every pod. Pass `templateId` to provision every member\npod from a pod template instead of inline container fields \u2014 the\ntemplate also supplies the container registry credential, the only\nprivate-image path for clusters (a bare `registry` property on this\nbody is rejected).\n",
+              description: "Request body for creating a cluster. `compute` defines the homogeneous pod shape; the container configuration (image, env, ports, \u2026) applies to every pod.",
               properties: {
                 compute: {
                   $ref: "#/$defs/ClusterCompute"
@@ -1363,7 +1672,7 @@ var generatedTools = [
                 templateId: {
                   type: "string",
                   minLength: 1,
-                  description: "ID of a pod template to provision every member pod from. The\ntemplate supplies the container settings (image, args, disk,\nenv, ports) and the container registry credential for private\nimages \u2014 the only private-image path for clusters. Mutually\nexclusive with `image`, `args`, `entrypoint`, `cmd`, `disk`,\n`env`, `ports`, and `mounts` (rejected with 400). The cluster\nretains the link: the `template` response field is set. Must be\na non-serverless pod template accessible to the caller.\n",
+                  description: "ID of a pod template to provision every member pod from: it supplies the container settings (image, args, disk, env, ports) and the registry credential for private images \u2014 the only private-image path for clusters. Mutually exclusive with the inline container fields (`image`, `args`, `entrypoint`, `cmd`, `disk`, `env`, `ports`, `mounts`). Must be a non-serverless template you can access.",
                   examples: ["30zmvf89kd"]
                 },
                 dataCenterIds: {
@@ -1371,11 +1680,11 @@ var generatedTools = [
                   items: {
                     type: "string"
                   },
-                  description: "Preferred data centers for placement. Omit or pass an empty\narray to let the scheduler choose. A cluster is always placed\nwithin a single data center.\n",
+                  description: "Preferred data centers for placement. Omit or pass an empty array to let the scheduler choose. A cluster is always placed within a single data center.",
                   example: ["US-TX-3"]
                 },
                 mounts: {
-                  $ref: "#/$defs/Mounts"
+                  $ref: "#/$defs/ClusterMounts"
                 },
                 startJupyter: {
                   type: "boolean",
@@ -1392,28 +1701,11 @@ var generatedTools = [
           ],
           unevaluatedProperties: false
         },
-        Mounts: {
-          type: "object",
-          additionalProperties: false,
-          description: "Storage mounts attached to a pod. At-most-one of `persistent` or\n`network` may be set today (mutually exclusive, enforced at the\nhandler with 400 if both are present). The `network` field is an\narray for forward compatibility with eventual multi-network-volume\nsupport, but `maxItems` is 1 today.\n\nPATCH semantics:\n- Omitting `mounts` or sending `{}` leaves the existing mount\n  unchanged.\n- An explicit `network: []` is rejected with 400 (clearing mounts\n  is not supported).\n- Mount kind is fixed at create \u2014 a PATCH that introduces a kind\n  not present at create (persistent on a network pod, network on\n  a persistent pod, or any mount on a previously-mountless pod)\n  is rejected with 400.\n- The `volumeId` of a network mount is immutable; a PATCH that\n  names a different `volumeId` is rejected with 400.\n- Partial mounts are not supported \u2014 every mount entry must\n  include the full schema (`size` + `path` for persistent,\n  `volumeId` + `path` for network). Missing required fields \u2192 422.\n",
-          properties: {
-            persistent: {
-              $ref: "#/$defs/PersistentMount"
-            },
-            network: {
-              type: "array",
-              maxItems: 1,
-              items: {
-                $ref: "#/$defs/NetworkMount"
-              }
-            }
-          }
-        },
         NetworkMount: {
           type: "object",
           required: ["volumeId", "path"],
           additionalProperties: false,
-          description: "Reference to a NetworkVolume. Custom paths are honored at runtime on\nboth GPU and CPU pods. The underlying `volumeId` is immutable\npost-create; the mount `path` may be changed via PATCH.\n",
+          description: "Reference to a NetworkVolume. Custom paths are honored at runtime on both GPU and CPU pods. The underlying `volumeId` is immutable post-create; the mount `path` may be changed via PATCH.",
           properties: {
             volumeId: {
               type: "string",
@@ -1431,7 +1723,7 @@ var generatedTools = [
           type: "object",
           required: ["size", "path"],
           additionalProperties: false,
-          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data\ndoes not survive a host failure. Disallowed on CPU pods. Mutually\nexclusive with NetworkMount. Deprecated: prefer NetworkMount for any\ndata you cannot recreate.\n",
+          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data does not survive a host failure. Disallowed on CPU pods. Mutually exclusive with NetworkMount. Deprecated: prefer NetworkMount for any data you cannot recreate.",
           properties: {
             size: {
               type: "integer",
@@ -1508,6 +1800,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -1519,11 +1812,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -1535,7 +1827,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -1545,7 +1837,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -1605,7 +1897,7 @@ var generatedTools = [
             pools: {
               type: "array",
               minItems: 1,
-              description: 'Serverless GPU pool IDs (as returned by `GET /v2/catalog/gpus` in\n`pool`). Workers are placed on whichever listed pool has capacity.\nNarrow a pool down to specific cards with `excludedTypes`.\n\nOn `PATCH`, `pools` and `excludedTypes` are one selection and are\nreplaced together, so sending `pools` by itself **clears the\nexclusions**. Two cases:\n\n- **Changing pools, keeping exclusions** \u2014 send both fields in one\n  request: `{"gpu": {"pools": ["ADA_24"], "excludedTypes":\n  ["NVIDIA L40"]}}`. `GET` the endpoint first to read the current\n  `excludedTypes` and resend the ones that still apply to the new\n  pools; an exclusion naming a type outside `pools` is a 400.\n- **Changing only `count` or a CUDA constraint** \u2014 omit `pools`:\n  `{"gpu": {"minCudaVersion": "12.4"}}`. The pool list and the\n  exclusions are both left exactly as they are.\n\n`excludedTypes` documents the full rule.\n',
+              description: "Serverless GPU pool IDs (the `pool` field of `list-gpu-types`). Workers are placed on whichever listed pool has capacity; narrow to specific cards with `excludedTypes`. On update, `pools` and `excludedTypes` are replaced together, so sending `pools` alone clears the exclusions.",
               items: {
                 type: "string"
               },
@@ -1614,7 +1906,7 @@ var generatedTools = [
             excludedTypes: {
               type: "array",
               uniqueItems: true,
-              description: 'GPU **type** IDs to subtract from the selected pools \u2014 the `id`\nfield of `GET /v2/catalog/gpus`, the same identifiers pods take in\n`gpu.id`. Workers run on every type in `pools` except these. Omit to\nuse the whole pool.\n\nPools stay the unit of selection; types are the unit of\nsubtraction. There is no inclusive allowlist: a card later added to\none of your pools becomes eligible, which is the honest reading of\n"this pool, minus these".\n\nTied to `pools`, because the two together are one selection:\nsupplying `pools` replaces that selection wholesale, so a `PATCH`\nsending `pools` **without `excludedTypes`** **clears** them \u2014\nrestate them to keep them. A `PATCH` that omits `pools` leaves both\nthe pools and the exclusions untouched, so changing only a CUDA\nconstraint cannot widen a pinned endpoint.\n\nRejected with 400 if a value is not a GPU type in one of `pools`;\nupstream accepts unrecognized exclusions silently, so a typo would\notherwise produce a filter that does nothing. Surrounding whitespace\nis trimmed, so `" NVIDIA L40"` and `"NVIDIA L40"` mean the same card.\n',
+              description: "GPU type IDs to subtract from the selected pools \u2014 the `id` field of `list-gpu-types`, the same identifiers pods take in `gpu.id`. Workers run on every type in `pools` except these; omit to use the whole pool. A value outside `pools` is rejected. On update, restate them whenever you send `pools`, or they are cleared.",
               items: {
                 type: "string",
                 pattern: "^\\s*[^-\\s]"
@@ -1631,7 +1923,6 @@ var generatedTools = [
           }
         },
         ContainerConfig: {
-          description: "Reusable container configuration shared across templates, pods, and serverless endpoints. Adding a field here automatically propagates to all three resources.\n",
           allOf: [
             {
               $ref: "#/$defs/BaseContainerConfig"
@@ -1657,7 +1948,7 @@ var generatedTools = [
           unevaluatedProperties: false
         },
         CreateEndpointGpuConfig: {
-          description: "GPU request for an endpoint create. Carries the CUDA constraints, which\nlive here rather than at the body's top level so they are\nunrepresentable on a CPU endpoint.\n",
+          description: "GPU request for an endpoint create. Carries the CUDA constraints, which live here rather than at the body's top level so they are unrepresentable on a CPU endpoint.",
           allOf: [
             {
               $ref: "#/$defs/BaseEndpointGpuConfig"
@@ -1672,13 +1963,13 @@ var generatedTools = [
                     type: "string",
                     pattern: "^\\d+\\.\\d+$"
                   },
-                  description: "Acceptable CUDA versions for worker placement, as\n`major.minor`. Omit to accept any version (or inherit the\ntemplate's constraint when creating from `templateId`).\nMatching is exact \u2014 discover valid values per GPU type via\n`GET /v2/catalog/gpus?include=AVAILABILITY&product=SERVERLESS`\n(`cudaVersions`).\n\nA non-empty set is mutually exclusive with minCudaVersion (400\nif both are sent). An explicit `[]` states no constraint, so it\nmay accompany a floor.\n",
+                  description: "Acceptable CUDA versions for worker placement, as `major.minor`. Omit to accept any version (or inherit the template's constraint when creating from `templateId`).",
                   examples: [["12.8", "12.6"]]
                 },
                 minCudaVersion: {
                   type: "string",
                   pattern: "^\\d+\\.\\d+$",
-                  description: "Lowest acceptable CUDA version for worker placement, as\n`major.minor`, compared numerically rather than as a decimal \u2014\nso 12.11 is above 12.2. Use this for an open-ended floor and\nallowedCudaVersions for an exact set.\n\nMutually exclusive with a non-empty allowedCudaVersions (400 if\nboth are sent); an explicit `[]` there states no constraint and\nmay accompany this floor.\n",
+                  description: "Lowest acceptable CUDA version for worker placement, as `major.minor`, compared numerically rather than as a decimal \u2014 so 12.11 is above 12.2. Use this for an open-ended floor and allowedCudaVersions for an exact set.",
                   examples: ["12.1"]
                 }
               }
@@ -1722,13 +2013,13 @@ var generatedTools = [
                       $ref: "#/$defs/EndpointType"
                     }
                   ],
-                  description: "Request-routing model. Required \u2014 it determines the valid scaler\nand request URLs, so it must be chosen explicitly on every create.\n"
+                  description: "Request-routing model. Required \u2014 it determines the valid scaler and request URLs, so it must be chosen explicitly on every create."
                 },
                 cpu: {
                   type: "array",
                   minItems: 1,
                   uniqueItems: true,
-                  description: "Eligible CPU configurations for each worker. Memory is derived from the\nselected flavor's catalog RAM multiplier. Exact duplicate configurations\nare rejected; the same flavor may be listed at different vCPU counts.\n",
+                  description: "Eligible CPU configurations for each worker. Memory is derived from the selected flavor's catalog RAM multiplier. Exact duplicate configurations are rejected; the same flavor may be listed at different vCPU counts.",
                   items: {
                     $ref: "#/$defs/CreateCpuConfig"
                   }
@@ -1752,12 +2043,17 @@ var generatedTools = [
                   type: "array",
                   items: {
                     type: "string"
-                  }
+                  },
+                  description: "Network volume IDs.",
+                  deprecated: true
+                },
+                mounts: {
+                  $ref: "#/$defs/EndpointMountsInput"
                 },
                 templateId: {
                   type: "string",
                   minLength: 1,
-                  description: "ID of a serverless template to base this endpoint on. The\ntemplate is resolved at create time into the same container\nsettings you could otherwise spread into this body (image,\nargs, disk, ports, env, registry); explicit body fields\noverride the template's, except `env`, which is merged per\nkey with body values winning. The template's\nallowedCudaVersions seeds `gpu.allowedCudaVersions` when the\nbody omits it \u2014 but only for a GPU create, since a CPU endpoint\nhas no gpu block to seed into, and not when the body sets\n`gpu.minCudaVersion`, since seeding a set beside a floor would\nmanufacture the mutual-exclusion 400 from a valid request. Its\npod-specific startSsh/startJupyter flags are\nignored. Later template edits do not affect the endpoint.\nThe template may be one of your own or a public catalog\ntemplate \u2014 see `GET /v2/catalog/templates` (unknown or\ninaccessible ID \u2192 404) \u2014 and must be a serverless template\n(\u2192 422).\n",
+                  description: "ID of a serverless template to base this endpoint on (must be serverless). Its container settings (image, args, disk, ports, env, registry) fill in what this body omits; body fields win, and `env` merges per key with body winning. Its allowedCudaVersions seeds `gpu.allowedCudaVersions` when the body omits it; pod-only flags are ignored. Copied once: later edits do not apply.",
                   examples: ["30zmvf89kd"]
                 },
                 timeout: {
@@ -1805,8 +2101,42 @@ var generatedTools = [
             }
           }
         },
+        EndpointMount: {
+          type: "object",
+          required: ["volumeId"],
+          additionalProperties: false,
+          description: "A volume mounted on every worker, always at `/runpod-volume`. Custom paths are not supported yet.",
+          properties: {
+            volumeId: {
+              type: "string",
+              description: "ID of a NetworkVolume (under `network`) or GlobalVolume (under `global`).",
+              examples: ["vol_abc"]
+            }
+          }
+        },
+        EndpointMountsInput: {
+          type: "object",
+          additionalProperties: false,
+          description: "Volumes to mount on the endpoint's workers. A `network` or `global` list that is present replaces the endpoint's current list of that kind; an empty list detaches it, and an omitted list is left unchanged.",
+          properties: {
+            network: {
+              type: "array",
+              description: "Network volumes, at most one per data center.",
+              items: {
+                $ref: "#/$defs/EndpointMount"
+              }
+            },
+            global: {
+              type: "array",
+              maxItems: 1,
+              items: {
+                $ref: "#/$defs/EndpointMount"
+              }
+            }
+          }
+        },
         EndpointScaling: {
-          description: "Autoscaling signal \u2014 a discriminated union on `type`: `QUEUE_DELAY`\n(queue-based endpoints only) or `REQUEST_COUNT`. The scaler is chosen\nindependently of the endpoint's routing `type` and can be switched on\nupdate.\n",
+          description: "Autoscaling signal \u2014 a discriminated union on `type`: `QUEUE_DELAY` (queue-based endpoints only) or `REQUEST_COUNT`. The scaler is chosen independently of the endpoint's routing `type` and can be switched on update.",
           oneOf: [
             {
               $ref: "#/$defs/QueueDelayScaling"
@@ -1825,7 +2155,7 @@ var generatedTools = [
         },
         EndpointType: {
           type: "string",
-          description: "Request-routing semantics for a modern serverless endpoint.\n- `QUEUE` \u2014 submit asynchronous or synchronous jobs through the managed queue.\n- `LOAD_BALANCER` \u2014 send requests directly to worker-defined HTTP paths.\n  Configure via `env`: `PORT` (server port, default 80), `PORT_HEALTH`\n  (health-check port, default 80), and `HEALTH_CHECK_PATH` (path the\n  load balancer polls for worker health, default `/ping`).\n",
+          description: "Request-routing semantics for a modern serverless endpoint. `QUEUE` \u2014 submit asynchronous or synchronous jobs through the managed queue. `LOAD_BALANCER` \u2014 send requests directly to worker-defined HTTP paths.",
           "x-enum-varnames": ["EndpointTypeQueue", "EndpointTypeLoadBalancer"],
           enum: ["QUEUE", "LOAD_BALANCER"]
         },
@@ -1849,14 +2179,14 @@ var generatedTools = [
               type: "integer",
               minimum: 1,
               maximum: 3600,
-              description: "Seconds before idle workers scale down. Not applicable to queue-based\nendpoints scaling on `requestCount` \u2014 rejected on create/update and\nomitted from responses for that combination.\n",
+              description: "Seconds before idle workers scale down. Not applicable to queue-based endpoints scaling on `requestCount` \u2014 rejected on create/update and omitted from responses for that combination.",
               examples: [5]
             }
           }
         },
         FlashBoot: {
           type: "string",
-          description: "FlashBoot cold-start acceleration mode.\n- `OFF`                \u2014 disabled\n- `FLASHBOOT`          \u2014 enabled\n- `PRIORITY_FLASHBOOT` \u2014 enabled with priority capacity\n",
+          description: "FlashBoot cold-start acceleration mode. `OFF` \u2014 disabled. `FLASHBOOT` \u2014 enabled. `PRIORITY_FLASHBOOT` \u2014 enabled with priority capacity",
           enum: ["OFF", "FLASHBOOT", "PRIORITY_FLASHBOOT"]
         },
         QueueDelayScaling: {
@@ -1882,7 +2212,7 @@ var generatedTools = [
         RequestCountScaling: {
           type: "object",
           additionalProperties: false,
-          description: "Scale on concurrent in-flight requests per worker. Required for\nload-balancing endpoints; also selectable for queue-based.\n",
+          description: "Scale on concurrent in-flight requests per worker. Required for load-balancing endpoints; also selectable for queue-based.",
           required: ["type", "requestCount"],
           properties: {
             type: {
@@ -1901,6 +2231,47 @@ var generatedTools = [
       }
     }
   },
+  {
+    name: "create-global-volume",
+    operationId: "createGlobalVolume",
+    description: "Create a global volume. Provisions a new global volume \u2014 storage that mounts into workloads in any data center. Only a `name` is required; storage is provisioned for you. Accounts have a cap on how many global volumes they can hold; creating one past it fails with `400`. Returns `201` with the created global volume, including its assigned `id`.",
+    method: "POST",
+    path: "/v2/global-volumes",
+    params: [],
+    hasBody: true,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        body: {
+          $ref: "#/$defs/CreateGlobalVolumeRequest"
+        }
+      },
+      required: ["body"],
+      $defs: {
+        CreateGlobalVolumeRequest: {
+          type: "object",
+          additionalProperties: false,
+          required: ["name"],
+          properties: {
+            name: {
+              type: "string",
+              minLength: 1,
+              maxLength: 191,
+              pattern: "[^\\p{Z}\\t-\\r\x85]",
+              description: "Human-readable name, 1\u2013191 characters with at least one non-whitespace character. Leading and trailing whitespace is trimmed.",
+              examples: ["training-data"]
+            }
+          }
+        }
+      }
+    }
+  },
   {
     name: "create-network-volume",
     operationId: "createNetworkVolume",
@@ -1954,7 +2325,7 @@ var generatedTools = [
                   $ref: "#/$defs/VolumeType"
                 }
               ],
-              description: "Storage tier for the volume. Optional. When omitted, the volume is\nprovisioned using the requested data center's default (primary)\nstorage tier. HIGH_PERFORMANCE provisions a high-performance (HPS)\nvolume; STANDARD provisions a standard volume. A volume's tier is\nimmutable after creation.\n"
+              description: "Storage tier for the volume. Optional. When omitted, the volume is provisioned using the requested data center's default (primary) storage tier."
             }
           }
         },
@@ -1980,6 +2351,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -1991,11 +2363,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -2007,7 +2378,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -2017,7 +2388,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -2089,13 +2460,27 @@ var generatedTools = [
             }
           }
         },
+        BaseMounts: {
+          type: "object",
+          properties: {
+            persistent: {
+              $ref: "#/$defs/PersistentMount"
+            },
+            network: {
+              type: "array",
+              maxItems: 1,
+              items: {
+                $ref: "#/$defs/NetworkMount"
+              }
+            }
+          }
+        },
         Cloud: {
           type: "string",
-          description: "Cloud tier.\n- `SECURE`    \u2014 Runpod-owned datacenter hardware\n- `COMMUNITY` \u2014 community-hosted hardware\n",
+          description: "Cloud tier. `SECURE` \u2014 Runpod-owned datacenter hardware. `COMMUNITY` \u2014 community-hosted hardware",
           enum: ["SECURE", "COMMUNITY"]
         },
         ContainerConfig: {
-          description: "Reusable container configuration shared across templates, pods, and serverless endpoints. Adding a field here automatically propagates to all three resources.\n",
           allOf: [
             {
               $ref: "#/$defs/BaseContainerConfig"
@@ -2121,7 +2506,7 @@ var generatedTools = [
           unevaluatedProperties: false
         },
         CreateGpuConfig: {
-          description: "GPU request for a pod create. Carries the CUDA host constraints, which\nlive here rather than at the body's top level so they are\nunrepresentable on a CPU pod.\n",
+          description: "GPU request for a pod create. Carries the CUDA host constraints, which live here rather than at the body's top level so they are unrepresentable on a CPU pod.",
           allOf: [
             {
               $ref: "#/$defs/BaseGpuConfig"
@@ -2135,13 +2520,13 @@ var generatedTools = [
                     type: "string",
                     pattern: "^\\d+\\.\\d+$"
                   },
-                  description: "Acceptable CUDA versions for the host machine, as `major.minor`.\nOmit to accept any version. Matching is exact, so a version no\nmachine reports yields a capacity error rather than a fallback \u2014\ndiscover valid values per GPU type via\n`GET /v2/catalog/gpus?include=AVAILABILITY&product=POD`\n(`cudaVersions`).\n\nA non-empty set is mutually exclusive with minCudaVersion (400\nif both are sent). An explicit `[]` states no constraint, so it\nmay accompany a floor.\n",
+                  description: "Acceptable CUDA versions for the host machine, as `major.minor`. Omit to accept any version.",
                   examples: [["12.8", "12.6"]]
                 },
                 minCudaVersion: {
                   type: "string",
                   pattern: "^\\d+\\.\\d+$",
-                  description: "Lowest acceptable CUDA version for the host machine, as\n`major.minor`, compared numerically rather than as a decimal \u2014\nso 12.11 is above 12.2. Use this for an open-ended floor and\nallowedCudaVersions for an exact set.\n\nMutually exclusive with a non-empty allowedCudaVersions (400 if\nboth are sent); an explicit `[]` there states no constraint and\nmay accompany this floor.\n",
+                  description: "Lowest acceptable CUDA version for the host machine, as `major.minor`, compared numerically rather than as a decimal \u2014 so 12.11 is above 12.2. Use this for an open-ended floor and allowedCudaVersions for an exact set.",
                   examples: ["12.1"]
                 },
                 minRamPerGpu: {
@@ -2169,7 +2554,7 @@ var generatedTools = [
             {
               type: "object",
               required: ["name"],
-              description: "Request body for creating a pod. Exactly one of `gpu` or `cpu`\nmust be set \u2014 enforced at the handler layer. For CPU pods, memory\nis derived by the API from the selected flavor's RAM multiplier;\nclients provide only CPU flavor and vCPU count. CPU pods support\ncontainer disk and network volumes only; `mounts.persistent` is\ninvalid when `cpu` is set.\n\n`image` is required unless `templateId` is set.\n",
+              description: "Request body for creating a pod. Exactly one of `gpu` or `cpu` must be set \u2014 enforced at the handler layer.",
               properties: {
                 name: {
                   type: "string",
@@ -2193,13 +2578,13 @@ var generatedTools = [
                   items: {
                     type: "string"
                   },
-                  description: "Preferred data centers for placement. Omit or pass an empty\narray to let the scheduler choose.\n",
+                  description: "Preferred data centers for placement. Omit or pass an empty array to let the scheduler choose.",
                   examples: [["US-TX-3"]]
                 },
                 globalNetworking: {
                   type: "boolean",
                   default: false,
-                  description: "Enable global networking, giving the pod a private IP reachable across data centers. Requires an NVIDIA GPU and a global-networking-enabled data center (both enforced upstream). See `GET /v2/catalog/datacenters` (`globalNetwork`) for eligible data centers.",
+                  description: "Enable global networking, giving the pod a private IP reachable across data centers. Requires an NVIDIA GPU and a global-networking-enabled data center (both enforced upstream).",
                   examples: [false]
                 },
                 gpu: {
@@ -2211,19 +2596,19 @@ var generatedTools = [
                 startJupyter: {
                   type: "boolean",
                   default: false,
-                  description: "Create-time flag telling the provisioner to start JupyterLab:\ninjects a generated `JUPYTER_PASSWORD` environment variable,\nunless the request already sets one. Only images that honor\nthe convention start Jupyter from it (Runpod official images\ndo); expose `8888/http` in `ports` to reach it.\n\nNot part of the pod's readable config \u2014 never returned by\nGET and not changeable by PATCH.\n",
+                  description: "Create-time flag: starts JupyterLab by injecting a generated `JUPYTER_PASSWORD` environment variable, unless the request sets one. Expose `8888/http` in `ports` to reach it.",
                   examples: [true]
                 },
                 startSsh: {
                   type: "boolean",
                   default: false,
-                  description: "Create-time flag telling the provisioner to set up SSH\naccess: injects a `PUBLIC_KEY` environment variable carrying\nyour account's registered SSH public keys, unless the request\nalready sets one. **Requires registered keys** (`PUT\n/v2/account/ssh-keys`) \u2014 with none registered the flag does\nnothing and the pod has no SSH access. Only images that honor\nthe convention start sshd from it (all Runpod official images\ndo). Connect using the pod's `ssh` block; the `ssh.direct`\nvariant additionally needs a `22/tcp` entry in `ports`.\n\nNot part of the pod's readable config \u2014 never returned by\nGET and not changeable by PATCH.\n",
+                  description: "Create-time flag: sets up SSH access by injecting a `PUBLIC_KEY` environment variable with your account's registered SSH keys (`update-ssh-keys`), unless the request sets one. With no registered keys it does nothing and the pod has no SSH access. Direct SSH also needs a `22/tcp` entry in `ports`.",
                   examples: [true]
                 },
                 templateId: {
                   type: "string",
                   minLength: 1,
-                  description: "ID of a pod template to base this pod on. The template is\nresolved at create time into the same container settings you\ncould otherwise spread into this body (image, args, disk,\nports, env, registry, persistent mount, startSsh,\nstartJupyter, allowedCudaVersions); explicit body fields\noverride the template's, except `env`, which is merged per\nkey with body values winning. Sending either CUDA field\n(`gpu.allowedCudaVersions` or `gpu.minCudaVersion`) replaces\nthe template's CUDA constraint entirely, and CPU pods ignore\nit (like the persistent mount). The template is a one-time\nsource of settings: later template edits do not affect the\npod, and the created pod does not retain a link to the\ntemplate (`template` stays null). The template may be one\nof your own or a public catalog template \u2014 see\n`GET /v2/catalog/templates` (unknown or inaccessible ID \u2192\n404) \u2014 and must not be a serverless template (\u2192 422). CPU\npods do not inherit a template's persistent mount.\n",
+                  description: "ID of a pod template to base this pod on (not a serverless one). Its container settings (image, args, disk, ports, env, registry, persistent mount) fill in what this body omits; body fields win, and `env` merges per key with body winning. A CUDA field in `gpu` replaces the template's CUDA constraint; CPU pods ignore its mount. Copied once: later template edits do not affect the pod.",
                   examples: ["30zmvf89kd"]
                 }
               }
@@ -2239,28 +2624,51 @@ var generatedTools = [
             required: ["image"]
           }
         },
-        Mounts: {
+        GlobalMount: {
           type: "object",
+          required: ["volumeId"],
           additionalProperties: false,
-          description: "Storage mounts attached to a pod. At-most-one of `persistent` or\n`network` may be set today (mutually exclusive, enforced at the\nhandler with 400 if both are present). The `network` field is an\narray for forward compatibility with eventual multi-network-volume\nsupport, but `maxItems` is 1 today.\n\nPATCH semantics:\n- Omitting `mounts` or sending `{}` leaves the existing mount\n  unchanged.\n- An explicit `network: []` is rejected with 400 (clearing mounts\n  is not supported).\n- Mount kind is fixed at create \u2014 a PATCH that introduces a kind\n  not present at create (persistent on a network pod, network on\n  a persistent pod, or any mount on a previously-mountless pod)\n  is rejected with 400.\n- The `volumeId` of a network mount is immutable; a PATCH that\n  names a different `volumeId` is rejected with 400.\n- Partial mounts are not supported \u2014 every mount entry must\n  include the full schema (`size` + `path` for persistent,\n  `volumeId` + `path` for network). Missing required fields \u2192 422.\n",
+          description: "Reference to a GlobalVolume. Usage-billed, so it has no size. The underlying `volumeId` is immutable post-create; the mount `path` may be changed via PATCH.",
           properties: {
-            persistent: {
-              $ref: "#/$defs/PersistentMount"
+            volumeId: {
+              type: "string",
+              description: "ID of an existing GlobalVolume.",
+              examples: ["gsb_abc"]
             },
-            network: {
-              type: "array",
-              maxItems: 1,
-              items: {
-                $ref: "#/$defs/NetworkMount"
-              }
+            path: {
+              type: "string",
+              description: "Mount path inside the container. Optional on create, where a default is chosen for you; a PATCH that omits it leaves the path unchanged.",
+              examples: ["/data"]
             }
           }
         },
+        Mounts: {
+          description: "Storage mounts for the pod: `persistent` (size + path) excludes both `network` and `global`; `network` (volumeId + path) and `global` (volumeId, optional path) take one entry each and can be combined. Every entry needs its full shape. On update, omit the field to leave the mounts as they are; the mount kind and a volume's volumeId cannot change, and mounts cannot be cleared.",
+          allOf: [
+            {
+              $ref: "#/$defs/BaseMounts"
+            },
+            {
+              type: "object",
+              properties: {
+                global: {
+                  type: "array",
+                  maxItems: 1,
+                  description: "At most one global volume, on GPU and CPU pods, with no data center constraint. Combinable with `network` but not with `persistent` (rejected): upstream drops a persistent disk whenever a volume is attached.",
+                  items: {
+                    $ref: "#/$defs/GlobalMount"
+                  }
+                }
+              }
+            }
+          ],
+          unevaluatedProperties: false
+        },
         NetworkMount: {
           type: "object",
           required: ["volumeId", "path"],
           additionalProperties: false,
-          description: "Reference to a NetworkVolume. Custom paths are honored at runtime on\nboth GPU and CPU pods. The underlying `volumeId` is immutable\npost-create; the mount `path` may be changed via PATCH.\n",
+          description: "Reference to a NetworkVolume. Custom paths are honored at runtime on both GPU and CPU pods. The underlying `volumeId` is immutable post-create; the mount `path` may be changed via PATCH.",
           properties: {
             volumeId: {
               type: "string",
@@ -2278,7 +2686,7 @@ var generatedTools = [
           type: "object",
           required: ["size", "path"],
           additionalProperties: false,
-          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data\ndoes not survive a host failure. Disallowed on CPU pods. Mutually\nexclusive with NetworkMount. Deprecated: prefer NetworkMount for any\ndata you cannot recreate.\n",
+          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data does not survive a host failure. Disallowed on CPU pods. Mutually exclusive with NetworkMount. Deprecated: prefer NetworkMount for any data you cannot recreate.",
           properties: {
             size: {
               type: "integer",
@@ -2361,6 +2769,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -2380,7 +2789,7 @@ var generatedTools = [
               minLength: 1,
               maxLength: 191,
               pattern: "^[a-zA-Z_][a-zA-Z0-9_.\\-/]*$",
-              description: "Unique name for the secret \u2014 referenced from environment variables as `{{ RUNPOD_SECRET_<name> }}`; immutable after creation. Maximum 191 characters, must start with a letter or underscore, and may contain letters, digits, and `_.-/`. Names beginning with the reserved prefix `RUNPOD` are rejected (case-insensitive).",
+              description: "Unique name for the secret \u2014 referenced from environment variables as `{{ RUNPOD_SECRET_<name> }}`; immutable after creation. Maximum 191 characters, must start with a letter or underscore, and may contain letters, digits, and `_.-/`.",
               examples: ["hf-token"]
             },
             value: {
@@ -2414,6 +2823,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -2425,11 +2835,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -2441,7 +2850,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -2451,7 +2860,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -2488,7 +2897,6 @@ var generatedTools = [
           }
         },
         ContainerConfig: {
-          description: "Reusable container configuration shared across templates, pods, and serverless endpoints. Adding a field here automatically propagates to all three resources.\n",
           allOf: [
             {
               $ref: "#/$defs/BaseContainerConfig"
@@ -2525,7 +2933,7 @@ var generatedTools = [
                     type: "string",
                     pattern: "^\\d+\\.\\d+$"
                   },
-                  description: "Acceptable CUDA versions for containers created from this\ntemplate, as `major.minor`. Omit to accept any version \u2014 see\nthe same field on `createPod` for matching semantics.\nExpanded into GPU pod and serverless endpoint creates; CPU\npods ignore it.\n",
+                  description: "Acceptable CUDA versions for containers created from this template, as `major.minor`. Omit to accept any version \u2014 see the same field on `createPod` for matching semantics.",
                   examples: [["12.8", "12.6"]]
                 },
                 category: {
@@ -2551,13 +2959,13 @@ var generatedTools = [
                 startJupyter: {
                   type: "boolean",
                   default: true,
-                  description: "Start JupyterLab in containers created from this template:\ninjects a generated `JUPYTER_PASSWORD` environment variable,\nunless `env` already sets one. Only images that honor the\nconvention start Jupyter from it (Runpod official images do);\nexpose `8888/http` in `ports` to reach it. Defaults to `true`\nwhen omitted, matching console-created templates.\n",
+                  description: "Start JupyterLab in containers created from this template: injects a generated `JUPYTER_PASSWORD` environment variable, unless `env` already sets one.",
                   examples: [false]
                 },
                 startSsh: {
                   type: "boolean",
                   default: true,
-                  description: "Provision SSH access in containers created from this template:\ninjects a `PUBLIC_KEY` environment variable carrying the\ndeployer's registered SSH public keys (`PUT\n/v2/account/ssh-keys` \u2014 with none registered the flag does\nnothing), unless `env` already sets one. Only images that\nhonor the convention start sshd from it (all Runpod official\nimages do); direct SSH also needs a `22/tcp` entry in\n`ports`. Defaults to `true` when omitted, matching\nconsole-created templates.\n",
+                  description: "Provision SSH access in containers created from this template: injects a `PUBLIC_KEY` environment variable carrying the deployer's registered SSH public keys (`update-ssh-keys` \u2014 with none registered the flag does nothing), unless `env` already sets one.",
                   examples: [true]
                 }
               }
@@ -2569,7 +2977,7 @@ var generatedTools = [
           type: "object",
           required: ["size", "path"],
           additionalProperties: false,
-          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data\ndoes not survive a host failure. Disallowed on CPU pods. Mutually\nexclusive with NetworkMount. Deprecated: prefer NetworkMount for any\ndata you cannot recreate.\n",
+          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data does not survive a host failure. Disallowed on CPU pods. Mutually exclusive with NetworkMount. Deprecated: prefer NetworkMount for any data you cannot recreate.",
           properties: {
             size: {
               type: "integer",
@@ -2586,13 +2994,13 @@ var generatedTools = [
         },
         TemplateCategory: {
           type: "string",
-          description: "Controls how the template is grouped and filtered in the Runpod console.\nIt does not affect hardware selection, scheduling, or billing.\n- `CPU`    \u2014 CPU-only workloads\n- `NVIDIA` \u2014 NVIDIA GPU workloads\n- `AMD`    \u2014 AMD GPU workloads\n",
+          description: "Controls how the template is grouped and filtered in the Runpod console. It does not affect hardware selection, scheduling, or billing. `CPU` \u2014 CPU-only workloads. `NVIDIA` \u2014 NVIDIA GPU workloads. `AMD` \u2014 AMD GPU workloads",
           enum: ["CPU", "NVIDIA", "AMD"]
         },
         TemplateMounts: {
           type: "object",
           additionalProperties: false,
-          description: "Storage mounts attached to a template. Templates support only a\nsingle persistent mount today; any `network` property is rejected\nwith 422 by the schema validator.\n\nPATCH semantics: omitting `mounts` or sending `{}` leaves the\nexisting mount unchanged.\n",
+          description: "Storage mounts for containers from this template: a single `persistent` mount only (`network` is rejected). On update, omitting `mounts` or sending `{}` leaves the existing mount unchanged.",
           properties: {
             persistent: {
               $ref: "#/$defs/PersistentMount"
@@ -2662,6 +3070,36 @@ var generatedTools = [
       required: ["id"]
     }
   },
+  {
+    name: "delete-global-volume",
+    operationId: "deleteGlobalVolume",
+    description: "Delete a global volume. Permanently deletes a global volume and its stored data. Fails with `409` while the volume is still mounted: terminate every pod that mounts it (stopped pods count) and detach it from every serverless endpoint first. Nothing is detached or terminated on your behalf.",
+    method: "DELETE",
+    path: "/v2/global-volumes/{id}",
+    params: [
+      {
+        name: "id",
+        location: "path"
+      }
+    ],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Global volume identifier"
+        }
+      },
+      required: ["id"]
+    }
+  },
   {
     name: "delete-network-volume",
     operationId: "deleteNetworkVolume",
@@ -3027,12 +3465,42 @@ var generatedTools = [
         },
         buildId: {
           type: "string",
-          description: "GitHub build identifier (from GET /v2/serverless/{id}/builds or a release's `buildId`)"
+          description: "GitHub build identifier (from `list-endpoint-builds` or a release's `buildId`)"
         }
       },
       required: ["id", "buildId"]
     }
   },
+  {
+    name: "get-global-volume",
+    operationId: "getGlobalVolume",
+    description: "Get a global volume. Returns a single global volume by ID.",
+    method: "GET",
+    path: "/v2/global-volumes/{id}",
+    params: [
+      {
+        name: "id",
+        location: "path"
+      }
+    ],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Global volume identifier"
+        }
+      },
+      required: ["id"]
+    }
+  },
   {
     name: "get-gpu-type",
     operationId: "getGpuType",
@@ -3103,7 +3571,7 @@ var generatedTools = [
           items: {
             $ref: "#/$defs/Product"
           },
-          description: "Comma-separated availability product contexts. Supported values: POD, CLUSTER, SERVERLESS. Required with include=AVAILABILITY, and valid only with it (400 either way). There is no default: the same GPU type can be scarce for pods and plentiful for serverless, so the context has to be stated rather than assumed."
+          description: "Comma-separated availability product contexts. Supported values: POD, CLUSTER, SERVERLESS. Required with include=AVAILABILITY, and valid only with it (400 either way)."
         },
         count: {
           type: "integer",
@@ -3121,7 +3589,7 @@ var generatedTools = [
             type: "string",
             pattern: "^[A-Z]{2}$"
           },
-          description: "Comma-separated ISO 3166-1 alpha-2 country codes, uppercase, to constrain availability to \u2014 e.g. FR or FR,DE. Values within this filter use OR semantics. Valid only with include=AVAILABILITY (400 otherwise); a malformed entry is a 422. Scopes availability, lowest-price calculations and the dataCenters array to those countries, so a listed data center outside them is omitted rather than returned with availability NONE. On the list endpoint a GPU type with no data center in those countries drops out entirely; the single-GPU endpoint still returns the requested type, with availability NONE and dataCenters omitted, so a 404 keeps meaning the GPU type does not exist. Read the NONE on availability rather than the absence of dataCenters, which is also absent when availability was not requested."
+          description: "Comma-separated ISO 3166-1 alpha-2 country codes, uppercase, to constrain availability to \u2014 e.g. FR or FR,DE. Values within this filter use OR semantics. Valid only with include=AVAILABILITY; a malformed entry is a 422."
         },
         cudaVersions: {
           type: "array",
@@ -3129,12 +3597,12 @@ var generatedTools = [
             type: "string",
             pattern: "^\\d+\\.\\d+$"
           },
-          description: "Comma-separated CUDA versions to scope availability and lowest-price calculations to, matched exactly. Format: major.minor, e.g. 12.8 \u2014 a bare major is rejected here because it identifies no version. Valid only with include=AVAILABILITY (400 otherwise) and mutually exclusive with minCudaVersion (400 if both are sent); a malformed entry is a 422. Also narrows the returned cudaVersions array; omit it to enumerate every version offered."
+          description: "Comma-separated CUDA versions to scope availability and lowest-price calculations to, matched exactly. Format: major.minor, e.g. 12.8 \u2014 a bare major is rejected here because it identifies no version."
         },
         minCudaVersion: {
           type: "string",
           pattern: "^\\d+(\\.\\d+)?$",
-          description: "Lowest acceptable CUDA version to scope availability and lowest-price calculations to, compared numerically. Format: integer major or major.minor, e.g. 12 or 12.1 \u2014 unlike the `gpu.minCudaVersion` body field on pod and endpoint create, a bare major is accepted here and means any release of that major, because this filter only widens a read. Valid only with include=AVAILABILITY (400 otherwise) and mutually exclusive with cudaVersions (400 if both are sent); a malformed value is a 422. Use this for an open-ended floor and cudaVersions for an exact set."
+          description: "Lowest acceptable CUDA version to scope availability and lowest-price calculations to, compared numerically."
         }
       },
       required: ["id"],
@@ -3187,6 +3655,25 @@ var generatedTools = [
       required: ["id"]
     }
   },
+  {
+    name: "get-organization",
+    operationId: "getOrganization",
+    description: "Get your current organization. Returns the authenticated caller's current organization. Organization context comes from the caller's membership; no organization selector is required. Returns 404 when the caller does not belong to an organization, or 403 when organizations are unavailable to the caller.",
+    method: "GET",
+    path: "/v2/organization",
+    params: [],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
   {
     name: "get-pod",
     operationId: "getPod",
@@ -3361,12 +3848,12 @@ var generatedTools = [
         startTime: {
           type: "string",
           format: "date-time",
-          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.\n"
+          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago."
         },
         endTime: {
           type: "string",
           format: "date-time",
-          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.\n"
+          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records."
         },
         bucketSize: {
           $ref: "#/$defs/BillingBucketSize",
@@ -3375,7 +3862,7 @@ var generatedTools = [
         lastN: {
           type: "integer",
           minimum: 1,
-          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.\n'
+          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days".'
         }
       },
       $defs: {
@@ -3437,12 +3924,12 @@ var generatedTools = [
         startTime: {
           type: "string",
           format: "date-time",
-          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.\n"
+          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago."
         },
         endTime: {
           type: "string",
           format: "date-time",
-          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.\n"
+          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records."
         },
         bucketSize: {
           $ref: "#/$defs/BillingBucketSize",
@@ -3451,7 +3938,7 @@ var generatedTools = [
         lastN: {
           type: "integer",
           minimum: 1,
-          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.\n'
+          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days".'
         },
         clusterId: {
           type: "string",
@@ -3509,10 +3996,19 @@ var generatedTools = [
   {
     name: "list-clusters",
     operationId: "listClusters",
-    description: "List clusters. Returns all clusters owned by the authenticated user.",
+    description: "List clusters. Returns clusters owned by the authenticated user, cursor-paginated newest-first; an omitted `limit` defaults to 1000. Follow `pagination.nextCursor` until `hasNextPage` is false.",
     method: "GET",
     path: "/v2/clusters",
-    params: [],
+    params: [
+      {
+        name: "cursor",
+        location: "query"
+      },
+      {
+        name: "limit",
+        location: "query"
+      }
+    ],
     hasBody: false,
     annotations: {
       readOnlyHint: true,
@@ -3522,7 +4018,19 @@ var generatedTools = [
     },
     inputSchema: {
       type: "object",
-      properties: {}
+      properties: {
+        cursor: {
+          type: "string",
+          minLength: 1,
+          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 1e3,
+          description: "Page size, 1\u20131000. Defaults to 1000 when omitted."
+        }
+      }
     }
   },
   {
@@ -3776,12 +4284,12 @@ var generatedTools = [
         startTime: {
           type: "string",
           format: "date-time",
-          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.\n"
+          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago."
         },
         endTime: {
           type: "string",
           format: "date-time",
-          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.\n"
+          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records."
         },
         bucketSize: {
           $ref: "#/$defs/BillingBucketSize",
@@ -3790,7 +4298,7 @@ var generatedTools = [
         lastN: {
           type: "integer",
           minimum: 1,
-          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.\n'
+          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days".'
         }
       },
       $defs: {
@@ -3848,7 +4356,7 @@ var generatedTools = [
         cursor: {
           type: "string",
           minLength: 1,
-          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected with 422.\n"
+          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected."
         },
         limit: {
           type: "integer",
@@ -3897,7 +4405,7 @@ var generatedTools = [
         cursor: {
           type: "string",
           minLength: 1,
-          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected with 422.\n"
+          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected."
         },
         limit: {
           type: "integer",
@@ -3910,15 +4418,49 @@ var generatedTools = [
     }
   },
   {
-    name: "list-endpoint-workers",
-    operationId: "listEndpointWorkers",
-    description: "List serverless endpoint workers. Lists the active workers for a serverless endpoint. **Returns.** A `200` with a `ListEndpointWorkersResponse`: a `workers` array (one entry per active worker, each carrying its `id`, `status`, and runtime details) plus a `summary` of worker counts grouped by status. Only currently active workers are included; scaled-down workers are not returned. **How `status` is determined.** Each worker's `status` is derived by reconciling the worker pod's lifecycle status with the endpoint's live job-queue view (which workers are actively serving requests). When the job-queue view is unavailable, the response degrades gracefully: the shape is unchanged, but each `status` and the summary counts fall back to pod lifecycle alone.",
+    name: "list-endpoint-workers",
+    operationId: "listEndpointWorkers",
+    description: "List serverless endpoint workers. Lists the active workers for a serverless endpoint. **Returns.** A `200` with a `ListEndpointWorkersResponse`: a `workers` array (one entry per active worker, each carrying its `id`, `status`, and runtime details) plus a `summary` of worker counts grouped by status. Only currently active workers are included; scaled-down workers are not returned. **How `status` is determined.** Each worker's `status` is derived by reconciling the worker pod's lifecycle status with the endpoint's live job-queue view (which workers are actively serving requests). When the job-queue view is unavailable, the response degrades gracefully: the shape is unchanged, but each `status` and the summary counts fall back to pod lifecycle alone.",
+    method: "GET",
+    path: "/v2/serverless/{id}/workers",
+    params: [
+      {
+        name: "id",
+        location: "path"
+      }
+    ],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Serverless endpoint identifier"
+        }
+      },
+      required: ["id"]
+    }
+  },
+  {
+    name: "list-global-volumes",
+    operationId: "listGlobalVolumes",
+    description: "List global volumes. Returns global volumes owned by the authenticated user, cursor-paginated newest-first; an omitted `limit` defaults to 1000. Follow `pagination.nextCursor` until `hasNextPage` is false.",
     method: "GET",
-    path: "/v2/serverless/{id}/workers",
+    path: "/v2/global-volumes",
     params: [
       {
-        name: "id",
-        location: "path"
+        name: "cursor",
+        location: "query"
+      },
+      {
+        name: "limit",
+        location: "query"
       }
     ],
     hasBody: false,
@@ -3931,12 +4473,18 @@ var generatedTools = [
     inputSchema: {
       type: "object",
       properties: {
-        id: {
+        cursor: {
           type: "string",
-          description: "Serverless endpoint identifier"
+          minLength: 1,
+          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 1e3,
+          description: "Page size, 1\u20131000. Defaults to 1000 when omitted."
         }
-      },
-      required: ["id"]
+      }
     }
   },
   {
@@ -4002,7 +4550,7 @@ var generatedTools = [
           items: {
             $ref: "#/$defs/Product"
           },
-          description: "Comma-separated availability product contexts. Supported values: POD, CLUSTER, SERVERLESS. Required with include=AVAILABILITY, and valid only with it (400 either way). There is no default: the same GPU type can be scarce for pods and plentiful for serverless, so the context has to be stated rather than assumed."
+          description: "Comma-separated availability product contexts. Supported values: POD, CLUSTER, SERVERLESS. Required with include=AVAILABILITY, and valid only with it (400 either way)."
         },
         count: {
           type: "integer",
@@ -4020,7 +4568,7 @@ var generatedTools = [
             type: "string",
             pattern: "^[A-Z]{2}$"
           },
-          description: "Comma-separated ISO 3166-1 alpha-2 country codes, uppercase, to constrain availability to \u2014 e.g. FR or FR,DE. Values within this filter use OR semantics. Valid only with include=AVAILABILITY (400 otherwise); a malformed entry is a 422. Scopes availability, lowest-price calculations and the dataCenters array to those countries, so a listed data center outside them is omitted rather than returned with availability NONE. On the list endpoint a GPU type with no data center in those countries drops out entirely; the single-GPU endpoint still returns the requested type, with availability NONE and dataCenters omitted, so a 404 keeps meaning the GPU type does not exist. Read the NONE on availability rather than the absence of dataCenters, which is also absent when availability was not requested."
+          description: "Comma-separated ISO 3166-1 alpha-2 country codes, uppercase, to constrain availability to \u2014 e.g. FR or FR,DE. Values within this filter use OR semantics. Valid only with include=AVAILABILITY; a malformed entry is a 422."
         },
         cudaVersions: {
           type: "array",
@@ -4028,12 +4576,12 @@ var generatedTools = [
             type: "string",
             pattern: "^\\d+\\.\\d+$"
           },
-          description: "Comma-separated CUDA versions to scope availability and lowest-price calculations to, matched exactly. Format: major.minor, e.g. 12.8 \u2014 a bare major is rejected here because it identifies no version. Valid only with include=AVAILABILITY (400 otherwise) and mutually exclusive with minCudaVersion (400 if both are sent); a malformed entry is a 422. Also narrows the returned cudaVersions array; omit it to enumerate every version offered."
+          description: "Comma-separated CUDA versions to scope availability and lowest-price calculations to, matched exactly. Format: major.minor, e.g. 12.8 \u2014 a bare major is rejected here because it identifies no version."
         },
         minCudaVersion: {
           type: "string",
           pattern: "^\\d+(\\.\\d+)?$",
-          description: "Lowest acceptable CUDA version to scope availability and lowest-price calculations to, compared numerically. Format: integer major or major.minor, e.g. 12 or 12.1 \u2014 unlike the `gpu.minCudaVersion` body field on pod and endpoint create, a bare major is accepted here and means any release of that major, because this filter only widens a read. Valid only with include=AVAILABILITY (400 otherwise) and mutually exclusive with cudaVersions (400 if both are sent); a malformed value is a 422. Use this for an open-ended floor and cudaVersions for an exact set."
+          description: "Lowest acceptable CUDA version to scope availability and lowest-price calculations to, compared numerically."
         }
       },
       $defs: {
@@ -4096,12 +4644,12 @@ var generatedTools = [
         startTime: {
           type: "string",
           format: "date-time",
-          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.\n"
+          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago."
         },
         endTime: {
           type: "string",
           format: "date-time",
-          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.\n"
+          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records."
         },
         bucketSize: {
           $ref: "#/$defs/BillingBucketSize",
@@ -4110,7 +4658,7 @@ var generatedTools = [
         lastN: {
           type: "integer",
           minimum: 1,
-          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.\n'
+          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days".'
         },
         networkVolumeId: {
           type: "string",
@@ -4138,10 +4686,19 @@ var generatedTools = [
   {
     name: "list-network-volumes",
     operationId: "listNetworkVolumes",
-    description: "List network volumes. Returns all network volumes owned by the authenticated user.",
+    description: "List network volumes. Returns network volumes owned by the authenticated user, cursor-paginated newest-first; an omitted `limit` defaults to 1000. Follow `pagination.nextCursor` until `hasNextPage` is false.",
     method: "GET",
     path: "/v2/network-volumes",
-    params: [],
+    params: [
+      {
+        name: "cursor",
+        location: "query"
+      },
+      {
+        name: "limit",
+        location: "query"
+      }
+    ],
     hasBody: false,
     annotations: {
       readOnlyHint: true,
@@ -4151,7 +4708,19 @@ var generatedTools = [
     },
     inputSchema: {
       type: "object",
-      properties: {}
+      properties: {
+        cursor: {
+          type: "string",
+          minLength: 1,
+          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected."
+        },
+        limit: {
+          type: "integer",
+          minimum: 1,
+          maximum: 1e3,
+          description: "Page size, 1\u20131000. Defaults to 1000 when omitted."
+        }
+      }
     }
   },
   {
@@ -4195,12 +4764,12 @@ var generatedTools = [
         startTime: {
           type: "string",
           format: "date-time",
-          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.\n"
+          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago."
         },
         endTime: {
           type: "string",
           format: "date-time",
-          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.\n"
+          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records."
         },
         bucketSize: {
           $ref: "#/$defs/BillingBucketSize",
@@ -4209,7 +4778,7 @@ var generatedTools = [
         lastN: {
           type: "integer",
           minimum: 1,
-          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.\n'
+          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days".'
         },
         podId: {
           type: "string",
@@ -4237,7 +4806,7 @@ var generatedTools = [
   {
     name: "list-pods",
     operationId: "listPods",
-    description: "List pods. Returns pods owned by the authenticated user. Cluster member pods are excluded by default; set `includeClusterPods=true` to include them (each carries a non-null `cluster` membership block). Results are cursor-paginated newest-first; an omitted `limit` defaults to 1000. When cluster member pods are excluded, the exclusion applies to each page after it is cut, so a page may hold fewer than `limit` pods \u2014 follow `pagination.nextCursor` until `hasNextPage` is false rather than counting items.",
+    description: "List pods. Returns pods owned by the authenticated user. Cluster member pods are excluded by default; set `includeClusterPods=true` to include them (each carries a non-null `cluster` membership block). Results are cursor-paginated newest-first; an omitted `limit` defaults to 1000. The cluster-member exclusion is applied before the page is cut, so a page holds `limit` pods whenever that many remain. Follow `pagination.nextCursor` until `hasNextPage` is false.",
     method: "GET",
     path: "/v2/pods",
     params: [
@@ -4272,7 +4841,7 @@ var generatedTools = [
         cursor: {
           type: "string",
           minLength: 1,
-          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected with 422.\n"
+          description: "Opaque resume cursor \u2014 pass the previous response's `pagination.nextCursor` through verbatim; omit for the first page. A cursor is only valid for the operation and parameters that issued it; a malformed or foreign cursor is rejected."
         },
         limit: {
           type: "integer",
@@ -4309,7 +4878,7 @@ var generatedTools = [
           type: "string",
           enum: ["official", "verified", "community"],
           default: "official",
-          description: "Which slice of the catalog to return: `official` for\nRunpod-curated templates (default), `verified` for\nRunpod-verified community templates, or `community` for all other\npublicly shared templates.\n"
+          description: "Which slice of the catalog to return: `official` for Runpod-curated templates (default), `verified` for Runpod-verified community templates, or `community` for all other publicly shared templates."
         }
       }
     }
@@ -4403,12 +4972,12 @@ var generatedTools = [
         startTime: {
           type: "string",
           format: "date-time",
-          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago. Snapped down to the start of its bucketSize bucket so the window aligns with the returned records; provide a boundary-aligned value (e.g. midnight for bucketSize=day) to avoid widening.\n"
+          description: "Start of the billing period (RFC 3339). Defaults to 30 days ago."
         },
         endTime: {
           type: "string",
           format: "date-time",
-          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records.\n"
+          description: "End of the billing period (RFC 3339), exclusive. Defaults to now. Snapped up to the end of the bucketSize bucket it lands in (unless already on a boundary) so the window aligns with the returned records."
         },
         bucketSize: {
           $ref: "#/$defs/BillingBucketSize",
@@ -4417,7 +4986,7 @@ var generatedTools = [
         lastN: {
           type: "integer",
           minimum: 1,
-          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days". The resolved window is aligned to bucket boundaries: startTime is the start of the earliest bucket (e.g. midnight of the earliest day) and endTime is the end of the current bucket. Mutually exclusive with startTime/endTime; provide one or the other, not both.\n'
+          description: 'Return the last N buckets of bucketSize, ending with the current (in-progress) bucket \u2014 e.g. lastN=100 with bucketSize=day is "last 100 days".'
         },
         serverlessId: {
           type: "string",
@@ -4556,7 +5125,7 @@ var generatedTools = [
           type: "object",
           additionalProperties: false,
           minProperties: 1,
-          description: "Request body for updating a cluster. Only the cluster name can be\nchanged \u2014 this endpoint is a rename. Compute shape, type, and container\nconfiguration are fixed at creation.\n",
+          description: "Request body for updating a cluster. Only the cluster name can be changed \u2014 this endpoint is a rename. Compute shape, type, and container configuration are fixed at creation.",
           properties: {
             name: {
               type: "string",
@@ -4587,6 +5156,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -4602,11 +5172,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -4618,7 +5187,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -4628,7 +5197,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -4688,7 +5257,7 @@ var generatedTools = [
             pools: {
               type: "array",
               minItems: 1,
-              description: 'Serverless GPU pool IDs (as returned by `GET /v2/catalog/gpus` in\n`pool`). Workers are placed on whichever listed pool has capacity.\nNarrow a pool down to specific cards with `excludedTypes`.\n\nOn `PATCH`, `pools` and `excludedTypes` are one selection and are\nreplaced together, so sending `pools` by itself **clears the\nexclusions**. Two cases:\n\n- **Changing pools, keeping exclusions** \u2014 send both fields in one\n  request: `{"gpu": {"pools": ["ADA_24"], "excludedTypes":\n  ["NVIDIA L40"]}}`. `GET` the endpoint first to read the current\n  `excludedTypes` and resend the ones that still apply to the new\n  pools; an exclusion naming a type outside `pools` is a 400.\n- **Changing only `count` or a CUDA constraint** \u2014 omit `pools`:\n  `{"gpu": {"minCudaVersion": "12.4"}}`. The pool list and the\n  exclusions are both left exactly as they are.\n\n`excludedTypes` documents the full rule.\n',
+              description: "Serverless GPU pool IDs (the `pool` field of `list-gpu-types`). Workers are placed on whichever listed pool has capacity; narrow to specific cards with `excludedTypes`. On update, `pools` and `excludedTypes` are replaced together, so sending `pools` alone clears the exclusions.",
               items: {
                 type: "string"
               },
@@ -4697,7 +5266,7 @@ var generatedTools = [
             excludedTypes: {
               type: "array",
               uniqueItems: true,
-              description: 'GPU **type** IDs to subtract from the selected pools \u2014 the `id`\nfield of `GET /v2/catalog/gpus`, the same identifiers pods take in\n`gpu.id`. Workers run on every type in `pools` except these. Omit to\nuse the whole pool.\n\nPools stay the unit of selection; types are the unit of\nsubtraction. There is no inclusive allowlist: a card later added to\none of your pools becomes eligible, which is the honest reading of\n"this pool, minus these".\n\nTied to `pools`, because the two together are one selection:\nsupplying `pools` replaces that selection wholesale, so a `PATCH`\nsending `pools` **without `excludedTypes`** **clears** them \u2014\nrestate them to keep them. A `PATCH` that omits `pools` leaves both\nthe pools and the exclusions untouched, so changing only a CUDA\nconstraint cannot widen a pinned endpoint.\n\nRejected with 400 if a value is not a GPU type in one of `pools`;\nupstream accepts unrecognized exclusions silently, so a typo would\notherwise produce a filter that does nothing. Surrounding whitespace\nis trimmed, so `" NVIDIA L40"` and `"NVIDIA L40"` mean the same card.\n',
+              description: "GPU type IDs to subtract from the selected pools \u2014 the `id` field of `list-gpu-types`, the same identifiers pods take in `gpu.id`. Workers run on every type in `pools` except these; omit to use the whole pool. A value outside `pools` is rejected. On update, restate them whenever you send `pools`, or they are cleared.",
               items: {
                 type: "string",
                 pattern: "^\\s*[^-\\s]"
@@ -4714,7 +5283,6 @@ var generatedTools = [
           }
         },
         ContainerConfig: {
-          description: "Reusable container configuration shared across templates, pods, and serverless endpoints. Adding a field here automatically propagates to all three resources.\n",
           allOf: [
             {
               $ref: "#/$defs/BaseContainerConfig"
@@ -4739,8 +5307,42 @@ var generatedTools = [
           ],
           unevaluatedProperties: false
         },
+        EndpointMount: {
+          type: "object",
+          required: ["volumeId"],
+          additionalProperties: false,
+          description: "A volume mounted on every worker, always at `/runpod-volume`. Custom paths are not supported yet.",
+          properties: {
+            volumeId: {
+              type: "string",
+              description: "ID of a NetworkVolume (under `network`) or GlobalVolume (under `global`).",
+              examples: ["vol_abc"]
+            }
+          }
+        },
+        EndpointMountsInput: {
+          type: "object",
+          additionalProperties: false,
+          description: "Volumes to mount on the endpoint's workers. A `network` or `global` list that is present replaces the endpoint's current list of that kind; an empty list detaches it, and an omitted list is left unchanged.",
+          properties: {
+            network: {
+              type: "array",
+              description: "Network volumes, at most one per data center.",
+              items: {
+                $ref: "#/$defs/EndpointMount"
+              }
+            },
+            global: {
+              type: "array",
+              maxItems: 1,
+              items: {
+                $ref: "#/$defs/EndpointMount"
+              }
+            }
+          }
+        },
         EndpointScaling: {
-          description: "Autoscaling signal \u2014 a discriminated union on `type`: `QUEUE_DELAY`\n(queue-based endpoints only) or `REQUEST_COUNT`. The scaler is chosen\nindependently of the endpoint's routing `type` and can be switched on\nupdate.\n",
+          description: "Autoscaling signal \u2014 a discriminated union on `type`: `QUEUE_DELAY` (queue-based endpoints only) or `REQUEST_COUNT`. The scaler is chosen independently of the endpoint's routing `type` and can be switched on update.",
           oneOf: [
             {
               $ref: "#/$defs/QueueDelayScaling"
@@ -4777,14 +5379,14 @@ var generatedTools = [
               type: "integer",
               minimum: 1,
               maximum: 3600,
-              description: "Seconds before idle workers scale down. Not applicable to queue-based\nendpoints scaling on `requestCount` \u2014 rejected on create/update and\nomitted from responses for that combination.\n",
+              description: "Seconds before idle workers scale down. Not applicable to queue-based endpoints scaling on `requestCount` \u2014 rejected on create/update and omitted from responses for that combination.",
               examples: [5]
             }
           }
         },
         FlashBoot: {
           type: "string",
-          description: "FlashBoot cold-start acceleration mode.\n- `OFF`                \u2014 disabled\n- `FLASHBOOT`          \u2014 enabled\n- `PRIORITY_FLASHBOOT` \u2014 enabled with priority capacity\n",
+          description: "FlashBoot cold-start acceleration mode. `OFF` \u2014 disabled. `FLASHBOOT` \u2014 enabled. `PRIORITY_FLASHBOOT` \u2014 enabled with priority capacity",
           enum: ["OFF", "FLASHBOOT", "PRIORITY_FLASHBOOT"]
         },
         QueueDelayScaling: {
@@ -4810,7 +5412,7 @@ var generatedTools = [
         RequestCountScaling: {
           type: "object",
           additionalProperties: false,
-          description: "Scale on concurrent in-flight requests per worker. Required for\nload-balancing endpoints; also selectable for queue-based.\n",
+          description: "Scale on concurrent in-flight requests per worker. Required for load-balancing endpoints; also selectable for queue-based.",
           required: ["type", "requestCount"],
           properties: {
             type: {
@@ -4827,7 +5429,7 @@ var generatedTools = [
           }
         },
         UpdateEndpointGpuConfig: {
-          description: "Partial GPU update \u2014 every field is optional and an omitted one is left\nunchanged. Unlike create, `pools` is optional, so changing only a CUDA\nconstraint does not require resending the pool list.\n\n`excludedTypes` requires `pools`, because the two are one selection and\nonly a supplied `pools` replaces it \u2014 an exclusion on its own would\notherwise be silently dropped.\n",
+          description: "Partial GPU update \u2014 every field is optional and an omitted one is left unchanged. `pools` is optional here, so a CUDA-only change does not resend the pool list; `excludedTypes` needs `pools` in the same request, and `pools` sent alone clears the exclusions.",
           allOf: [
             {
               $ref: "#/$defs/BaseEndpointGpuConfig"
@@ -4844,12 +5446,12 @@ var generatedTools = [
                     type: "string",
                     pattern: "^\\d+\\.\\d+$"
                   },
-                  description: "Acceptable CUDA versions for worker placement, as\n`major.minor`. An explicit `[]` clears the constraint;\nomitting the field leaves it unchanged. Takes effect as\nworkers are replaced.\n\nA non-empty set is mutually exclusive with minCudaVersion (400\nif both are sent). An explicit `[]` states no constraint, so it\nmay accompany a floor.\nSetting one does not clear the other \u2014 clear it explicitly in\nthe same patch if the endpoint already carries it.\n"
+                  description: "Acceptable CUDA versions for worker placement, as `major.minor`. An explicit `[]` clears the constraint; omitting the field leaves it unchanged. A non-empty set cannot be sent with minCudaVersion, and setting one does not clear the other: clear the other explicitly in the same patch. Takes effect as workers are replaced."
                 },
                 minCudaVersion: {
                   type: "string",
                   pattern: "^$|^\\d+\\.\\d+$",
-                  description: 'Lowest acceptable CUDA version for worker placement, as\n`major.minor`. An explicit `""` clears the floor; omitting the\nfield leaves it unchanged. Takes effect as workers are\nreplaced.\n\nMutually exclusive with a non-empty allowedCudaVersions (400 if\nboth are sent); an explicit `[]` there states no constraint and\nmay accompany this floor.\n',
+                  description: 'Lowest acceptable CUDA version for worker placement, as `major.minor`. An explicit `""` clears the floor; omitting the field leaves it unchanged. Cannot be sent with a non-empty allowedCudaVersions (an explicit `[]` there is fine); clear that explicitly in the same patch if the endpoint carries one. Takes effect as workers are replaced.',
                   examples: ["12.1"]
                 }
               }
@@ -4870,7 +5472,7 @@ var generatedTools = [
                   type: "array",
                   minItems: 1,
                   uniqueItems: true,
-                  description: "Complete replacement CPU selection. Valid only for an existing CPU\nendpoint; endpoint compute family cannot be changed.\n",
+                  description: "Complete replacement CPU selection. Valid only for an existing CPU endpoint; endpoint compute family cannot be changed.",
                   items: {
                     $ref: "#/$defs/CreateCpuConfig"
                   }
@@ -4896,14 +5498,19 @@ var generatedTools = [
                   type: "array",
                   items: {
                     type: "string"
-                  }
+                  },
+                  description: "Network volume IDs. Pass `[]` to detach.",
+                  deprecated: true
+                },
+                mounts: {
+                  $ref: "#/$defs/EndpointMountsInput"
                 },
                 scaling: {
                   $ref: "#/$defs/EndpointScaling"
                 },
                 templateId: {
                   type: "string",
-                  description: "ID of a serverless template whose container settings are\napplied as if they were provided in this PATCH body (image,\nargs, disk, ports, env, registry). Explicit body fields\noverride the template's; `env` merges template and body per\nkey (body wins) and, per PATCH semantics, replaces the\nendpoint's env. One-time application \u2014 no link to the\ntemplate is retained. Must be one of your templates or a\npublic template (unknown or inaccessible ID \u2192 404); must be\na serverless template (\u2192 422).\n",
+                  description: "ID of a serverless template whose container settings (image, args, disk, ports, env, registry) are applied as if sent in this PATCH body; explicit body fields win. `env` merges template and body per key (body wins) and replaces the endpoint's existing env. Applied once; must be a serverless template you can access.",
                   examples: ["30zmvf89kd"]
                 },
                 timeout: {
@@ -4920,6 +5527,57 @@ var generatedTools = [
       }
     }
   },
+  {
+    name: "update-global-volume",
+    operationId: "updateGlobalVolume",
+    description: "Update a global volume. Updates mutable fields on a global volume. Only provided fields are changed.",
+    method: "PATCH",
+    path: "/v2/global-volumes/{id}",
+    params: [
+      {
+        name: "id",
+        location: "path"
+      }
+    ],
+    hasBody: true,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {
+        id: {
+          type: "string",
+          description: "Global volume identifier"
+        },
+        body: {
+          $ref: "#/$defs/UpdateGlobalVolumeRequest"
+        }
+      },
+      required: ["id", "body"],
+      $defs: {
+        UpdateGlobalVolumeRequest: {
+          type: "object",
+          additionalProperties: false,
+          minProperties: 1,
+          description: "Only the provided fields are updated. At least one field must be present; an empty body is rejected.",
+          properties: {
+            name: {
+              type: "string",
+              minLength: 1,
+              maxLength: 191,
+              pattern: "[^\\p{Z}\\t-\\r\x85]",
+              description: "New human-readable name, 1\u2013191 characters with at least one non-whitespace character. Leading and trailing whitespace is trimmed.",
+              examples: ["renamed-volume"]
+            }
+          }
+        }
+      }
+    }
+  },
   {
     name: "update-network-volume",
     operationId: "updateNetworkVolume",
@@ -4956,7 +5614,7 @@ var generatedTools = [
           type: "object",
           additionalProperties: false,
           minProperties: 1,
-          description: "Only the provided fields are updated. At least one field must be\npresent; an empty body is rejected.\n",
+          description: "Only the provided fields are updated. At least one field must be present; an empty body is rejected.",
           properties: {
             name: {
               type: "string",
@@ -4968,7 +5626,7 @@ var generatedTools = [
               type: "integer",
               minimum: 10,
               maximum: 4096,
-              description: "New size in GB. Must be greater than or equal to the current size \u2014\nnetwork volume storage cannot be reduced.\n",
+              description: "New size in GB. Must be greater than or equal to the current size \u2014 network volume storage cannot be reduced.",
               examples: [100]
             }
           }
@@ -4995,6 +5653,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -5010,11 +5669,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -5026,7 +5684,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -5036,7 +5694,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -5072,8 +5730,22 @@ var generatedTools = [
             }
           }
         },
+        BaseMounts: {
+          type: "object",
+          properties: {
+            persistent: {
+              $ref: "#/$defs/PersistentMount"
+            },
+            network: {
+              type: "array",
+              maxItems: 1,
+              items: {
+                $ref: "#/$defs/NetworkMount"
+              }
+            }
+          }
+        },
         ContainerConfig: {
-          description: "Reusable container configuration shared across templates, pods, and serverless endpoints. Adding a field here automatically propagates to all three resources.\n",
           allOf: [
             {
               $ref: "#/$defs/BaseContainerConfig"
@@ -5090,28 +5762,51 @@ var generatedTools = [
             }
           ]
         },
-        Mounts: {
+        GlobalMount: {
           type: "object",
+          required: ["volumeId"],
           additionalProperties: false,
-          description: "Storage mounts attached to a pod. At-most-one of `persistent` or\n`network` may be set today (mutually exclusive, enforced at the\nhandler with 400 if both are present). The `network` field is an\narray for forward compatibility with eventual multi-network-volume\nsupport, but `maxItems` is 1 today.\n\nPATCH semantics:\n- Omitting `mounts` or sending `{}` leaves the existing mount\n  unchanged.\n- An explicit `network: []` is rejected with 400 (clearing mounts\n  is not supported).\n- Mount kind is fixed at create \u2014 a PATCH that introduces a kind\n  not present at create (persistent on a network pod, network on\n  a persistent pod, or any mount on a previously-mountless pod)\n  is rejected with 400.\n- The `volumeId` of a network mount is immutable; a PATCH that\n  names a different `volumeId` is rejected with 400.\n- Partial mounts are not supported \u2014 every mount entry must\n  include the full schema (`size` + `path` for persistent,\n  `volumeId` + `path` for network). Missing required fields \u2192 422.\n",
+          description: "Reference to a GlobalVolume. Usage-billed, so it has no size. The underlying `volumeId` is immutable post-create; the mount `path` may be changed via PATCH.",
           properties: {
-            persistent: {
-              $ref: "#/$defs/PersistentMount"
+            volumeId: {
+              type: "string",
+              description: "ID of an existing GlobalVolume.",
+              examples: ["gsb_abc"]
             },
-            network: {
-              type: "array",
-              maxItems: 1,
-              items: {
-                $ref: "#/$defs/NetworkMount"
-              }
+            path: {
+              type: "string",
+              description: "Mount path inside the container. Optional on create, where a default is chosen for you; a PATCH that omits it leaves the path unchanged.",
+              examples: ["/data"]
             }
           }
         },
+        Mounts: {
+          description: "Storage mounts for the pod: `persistent` (size + path) excludes both `network` and `global`; `network` (volumeId + path) and `global` (volumeId, optional path) take one entry each and can be combined. Every entry needs its full shape. On update, omit the field to leave the mounts as they are; the mount kind and a volume's volumeId cannot change, and mounts cannot be cleared.",
+          allOf: [
+            {
+              $ref: "#/$defs/BaseMounts"
+            },
+            {
+              type: "object",
+              properties: {
+                global: {
+                  type: "array",
+                  maxItems: 1,
+                  description: "At most one global volume, on GPU and CPU pods, with no data center constraint. Combinable with `network` but not with `persistent` (rejected): upstream drops a persistent disk whenever a volume is attached.",
+                  items: {
+                    $ref: "#/$defs/GlobalMount"
+                  }
+                }
+              }
+            }
+          ],
+          unevaluatedProperties: false
+        },
         NetworkMount: {
           type: "object",
           required: ["volumeId", "path"],
           additionalProperties: false,
-          description: "Reference to a NetworkVolume. Custom paths are honored at runtime on\nboth GPU and CPU pods. The underlying `volumeId` is immutable\npost-create; the mount `path` may be changed via PATCH.\n",
+          description: "Reference to a NetworkVolume. Custom paths are honored at runtime on both GPU and CPU pods. The underlying `volumeId` is immutable post-create; the mount `path` may be changed via PATCH.",
           properties: {
             volumeId: {
               type: "string",
@@ -5129,7 +5824,7 @@ var generatedTools = [
           type: "object",
           required: ["size", "path"],
           additionalProperties: false,
-          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data\ndoes not survive a host failure. Disallowed on CPU pods. Mutually\nexclusive with NetworkMount. Deprecated: prefer NetworkMount for any\ndata you cannot recreate.\n",
+          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data does not survive a host failure. Disallowed on CPU pods. Mutually exclusive with NetworkMount. Deprecated: prefer NetworkMount for any data you cannot recreate.",
           properties: {
             size: {
               type: "integer",
@@ -5154,7 +5849,7 @@ var generatedTools = [
               properties: {
                 globalNetworking: {
                   type: "boolean",
-                  description: "Enable (true) or disable (false) global networking. Takes effect on the next pod start/restart, not live. Requires an NVIDIA GPU and a global-networking-enabled data center (both enforced upstream). See `GET /v2/catalog/datacenters` (`globalNetwork`) for eligible data centers."
+                  description: "Enable (true) or disable (false) global networking. Takes effect on the next pod start/restart, not live. Requires an NVIDIA GPU and a global-networking-enabled data center (both enforced upstream)."
                 },
                 locked: {
                   type: "boolean",
@@ -5169,7 +5864,7 @@ var generatedTools = [
                 },
                 templateId: {
                   type: "string",
-                  description: "ID of a pod template whose container settings are applied as\nif they were provided in this PATCH body (image, args, disk,\nports, env, registry \u2014 mounts are not applied on update).\nExplicit body fields override the template's; `env` merges\ntemplate and body per key (body wins) and, per PATCH\nsemantics, replaces the pod's env. One-time application \u2014\nno link to the template is retained. Must be one of your\ntemplates or a public template (unknown or inaccessible ID\n\u2192 404); must not be a serverless template (\u2192 422).\n",
+                  description: "ID of a pod template whose container settings (image, args, disk, ports, env, registry; not mounts) are applied as if sent in this PATCH body; explicit body fields win. `env` merges template and body per key (body wins) and replaces the pod's existing env. Applied once; must be a non-serverless template you can access.",
                   examples: ["30zmvf89kd"]
                 }
               }
@@ -5199,6 +5894,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -5216,7 +5912,7 @@ var generatedTools = [
           type: "object",
           additionalProperties: false,
           minProperties: 1,
-          description: "Only the provided fields are updated; at least one field is required.\nThe secret's `name` is immutable.\n",
+          description: "Only the provided fields are updated; at least one field is required. The secret's `name` is immutable.",
           properties: {
             value: {
               type: "string",
@@ -5268,7 +5964,7 @@ var generatedTools = [
                 type: "string",
                 pattern: "^(ssh|ecdsa|sk)-[^\\s]+ [^\\s]+([ \\t][^\\n\\r]*)?$"
               },
-              description: "The full set of SSH public keys to register \u2014 this is a complete\nreplacement, not a merge. Each entry is an authorized_keys-style\nline: `<type> <base64-key> [comment]`, e.g. from\n`~/.ssh/id_ed25519.pub`. Send `[]` to remove all keys. These keys\nare provisioned into pods created with `startSsh` and\nauthenticate both SSH paths reported in the pod's `ssh` block.\n",
+              description: "The full set of SSH public keys to register \u2014 this is a complete replacement, not a merge. Each entry is an authorized_keys-style line: `<type> <base64-key> [comment]`, e.g. from `~/.ssh/id_ed25519.pub`. Send `[]` to remove all keys.",
               examples: [
                 [
                   "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILXGDN/SclOozk1xsDztpmhGiKkkrfQB9SKoO8dSIQQZ me@example.com"
@@ -5299,6 +5995,7 @@ var generatedTools = [
       idempotentHint: false,
       openWorldHint: true
     },
+    schemaOnDemand: true,
     inputSchema: {
       type: "object",
       properties: {
@@ -5313,11 +6010,10 @@ var generatedTools = [
       $defs: {
         BaseContainerConfig: {
           type: "object",
-          description: "Container configuration universal to every containerized resource. Compose ContainerConfig instead unless the resource cannot support a direct registry credential (clusters \u2014 there the registry credential arrives via a pod template, see CreateClusterRequest.templateId).\n",
           properties: {
             args: {
               type: "string",
-              description: 'The container\'s command, as a single raw string. This is the field `entrypoint` and `cmd` encode into, exposed in its stored form.\n\nTwo shapes are accepted. A bare shell string is treated as CMD and split into arguments, which is what the console\'s "Container start command" field writes. A JSON object of the form `{"entrypoint":[...],"cmd":[...]}` sets either or both explicitly.\n\nResponses always return both representations: `args` exactly as stored, plus the deconstructed `entrypoint` and `cmd`. Supplying `args` together with `entrypoint` or `cmd` is allowed only when they describe the same command, so a read-modify-write client can send back everything it received. Send `""` to clear, omit to leave unchanged.\n',
+              description: 'The container\'s command as one raw string: a bare shell string is treated as CMD and split into arguments; a JSON object `{"entrypoint":[...],"cmd":[...]}` sets either or both. Send `""` to clear; omit to leave unchanged.',
               examples: [
                 "--model meta-llama/Llama-3-8B --max-model-len 8192",
                 '{"entrypoint":["/bin/bash","-c"],"cmd":["python -u main.py"]}',
@@ -5329,7 +6025,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container CMD in exec form. When the image defines an ENTRYPOINT, this is the argument list passed to it. Encoded into the `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container CMD in exec form: when the image defines an ENTRYPOINT, the argument list passed to it. Encoded into `args`; supply both only when they describe the same command. Send `[]` to clear; omit to leave unchanged.",
               examples: [
                 ["--model", "meta-llama/Llama-3-8B", "--max-model-len", "8192"]
               ]
@@ -5339,7 +6035,7 @@ var generatedTools = [
               items: {
                 type: "string"
               },
-              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.\n",
+              description: "Container ENTRYPOINT in exec form, overriding the image's own. Encoded into `args` field; supplying both is allowed only when they describe the same command. Send `[]` to clear, omit to leave unchanged.",
               examples: [["/bin/bash", "-c"]]
             },
             disk: {
@@ -5376,7 +6072,6 @@ var generatedTools = [
           }
         },
         ContainerConfig: {
-          description: "Reusable container configuration shared across templates, pods, and serverless endpoints. Adding a field here automatically propagates to all three resources.\n",
           allOf: [
             {
               $ref: "#/$defs/BaseContainerConfig"
@@ -5397,7 +6092,7 @@ var generatedTools = [
           type: "object",
           required: ["size", "path"],
           additionalProperties: false,
-          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data\ndoes not survive a host failure. Disallowed on CPU pods. Mutually\nexclusive with NetworkMount. Deprecated: prefer NetworkMount for any\ndata you cannot recreate.\n",
+          description: "Host-local persistent storage. Pinned to the pod's host machine \u2014 data does not survive a host failure. Disallowed on CPU pods. Mutually exclusive with NetworkMount. Deprecated: prefer NetworkMount for any data you cannot recreate.",
           properties: {
             size: {
               type: "integer",
@@ -5414,13 +6109,13 @@ var generatedTools = [
         },
         TemplateCategory: {
           type: "string",
-          description: "Controls how the template is grouped and filtered in the Runpod console.\nIt does not affect hardware selection, scheduling, or billing.\n- `CPU`    \u2014 CPU-only workloads\n- `NVIDIA` \u2014 NVIDIA GPU workloads\n- `AMD`    \u2014 AMD GPU workloads\n",
+          description: "Controls how the template is grouped and filtered in the Runpod console. It does not affect hardware selection, scheduling, or billing. `CPU` \u2014 CPU-only workloads. `NVIDIA` \u2014 NVIDIA GPU workloads. `AMD` \u2014 AMD GPU workloads",
           enum: ["CPU", "NVIDIA", "AMD"]
         },
         TemplateMounts: {
           type: "object",
           additionalProperties: false,
-          description: "Storage mounts attached to a template. Templates support only a\nsingle persistent mount today; any `network` property is rejected\nwith 422 by the schema validator.\n\nPATCH semantics: omitting `mounts` or sending `{}` leaves the\nexisting mount unchanged.\n",
+          description: "Storage mounts for containers from this template: a single `persistent` mount only (`network` is rejected). On update, omitting `mounts` or sending `{}` leaves the existing mount unchanged.",
           properties: {
             persistent: {
               $ref: "#/$defs/PersistentMount"
@@ -6968,7 +7663,7 @@ var listTemplates = {
 // src/specgen/tools/logs.ts
 init_hosts();
 
-// node_modules/.pnpm/@runpod+typescript-api-sdk@0.2.0/node_modules/@runpod/typescript-api-sdk/dist/index.js
+// node_modules/.pnpm/@runpod+typescript-api-sdk@0.3.0/node_modules/@runpod/typescript-api-sdk/dist/index.js
 var PATH_PARAM_RE = /\{[^{}]+\}/g;
 var supportsRequestInitExt = () => {
   return typeof process === "object" && Number.parseInt(process?.versions?.node?.substring(0, 2)) >= 18 && process.versions.undici;
@@ -8656,6 +9351,7 @@ var source = {
 var listGuides = {
   name: "list-guides",
   annotations: bundledRead,
+  recordedArguments: ["kind", "query", "concept"],
   description: "List the official Runpod guides: skills (how to work with each tool), reference docs (how Runpod works), and golden paths (live-verified end-to-end walkthroughs such as a dev pod, a Whisper endpoint or a fine-tune-to-serverless pipeline). Read one with read-guide. For a golden path, mcp says whether an agent with only these MCP tools can finish it: full (follow it with tool calls), partial (use it for the plan and facts; name the step the user must run in a terminal), none (reference only). Skills and reference docs have mcp null. concepts lists the concept ids it works with (see lookup-concept). Filter with kind, query or concept.",
   inputSchema: {
     type: "object",
@@ -8691,6 +9387,8 @@ var listGuides = {
 var readGuide = {
   name: "read-guide",
   annotations: bundledRead,
+  recordedArguments: ["id"],
+  recordedGuideKind: (args) => knowledge.guides.find((guide) => guide.id === String(args.id).trim())?.kind,
   description: 'Read one official Runpod guide in full, by the id list-guides returns (for example "runpod-usage/storage" or "golden-path/06-dev-pod").',
   inputSchema: {
     type: "object",
@@ -8728,6 +9426,7 @@ var readGuide = {
 var lookupConcept = {
   name: "lookup-concept",
   annotations: bundledRead,
+  recordedArguments: ["concept"],
   description: 'Look up one Runpod concept (pod, network volume, machine, worker, template, \u2026) by id, name or alias; case, plurals and small typos are tolerated, and `matched_as` shows the key used when the match was not exact. Returns its summary, fields, states, relations and rules, each rule with the public source it comes from, the concepts that point at it, and the linked guides: examples (golden paths that use it, with their mcp level) and docs (skills and reference docs that explain it). Use it for exact facts, for example "is a volume disk tied to one machine" or "what happens to a stopped pod\'s GPU".',
   inputSchema: {
     type: "object",
@@ -8780,6 +9479,7 @@ var lookupConcept = {
 var searchConcepts = {
   name: "search-concepts",
   annotations: bundledRead,
+  recordedArguments: ["query", "limit"],
   description: 'Search the rules of the Runpod concept graph by words, for example "restart stopped pod no gpu" or "network volume data center". Returns the best-matching rules with their concept and public evidence. Follow up with lookup-concept for the full concept.',
   inputSchema: {
     type: "object",
@@ -8844,6 +9544,140 @@ var guideResources = knowledge.guides.map((guide) => ({
   text: guide.body
 }));
 
+// src/specgen/prose.ts
+var ABBREVIATIONS = ["e.g.", "i.e.", "etc.", "vs."];
+var DOT = "\0";
+function splitSentences(text) {
+  let guarded = text;
+  for (const abbreviation of ABBREVIATIONS) {
+    guarded = guarded.replaceAll(
+      abbreviation,
+      abbreviation.replaceAll(".", DOT)
+    );
+  }
+  return guarded.split(/(?<=[.!?])\s+(?=[A-Z`"'([])/).map((sentence) => sentence.replaceAll(DOT, ".").trim()).filter(Boolean);
+}
+function leadSentence(text) {
+  return splitSentences(text)[0] ?? text;
+}
+
+// src/specgen/on-demand.ts
+var DESCRIBE_TOOL_NAME = "describe-tool";
+var ON_DEMAND_POINTER = ` Call ${DESCRIBE_TOOL_NAME} for the full argument schema before the first use.`;
+function listedAnnotations(annotations) {
+  const { idempotentHint, ...listed } = annotations;
+  return idempotentHint ? annotations : listed;
+}
+function listTool(tool) {
+  const { name, description, inputSchema } = tool;
+  const annotations = listedAnnotations(tool.annotations);
+  if (!tool.schemaOnDemand)
+    return { name, description, inputSchema, annotations };
+  return {
+    name,
+    description: description + ON_DEMAND_POINTER,
+    inputSchema: callShape(inputSchema),
+    annotations
+  };
+}
+function callShape(schema) {
+  const defs = schema.$defs ?? {};
+  const resolve2 = (node) => {
+    if (typeof node.$ref !== "string") return node;
+    const name = node.$ref.split("/").pop() ?? "";
+    return defs[name] ?? {};
+  };
+  const properties = Object.fromEntries(
+    Object.entries(schema.properties ?? {}).map(
+      ([key, value]) => [key, shallowProperty(resolve2(value), resolve2)]
+    )
+  );
+  return {
+    type: "object",
+    properties,
+    ...schema.required ? { required: schema.required } : {}
+  };
+}
+function shallowProperty(node, resolve2) {
+  const out = {};
+  const type = schemaType(node, resolve2);
+  if (type !== void 0) out.type = type;
+  if (type === "array") {
+    const items = resolve2(node.items ?? {});
+    const itemType = schemaType(items, resolve2);
+    if (itemType !== void 0) out.items = { type: itemType };
+  }
+  if (Array.isArray(node.enum)) out.enum = node.enum;
+  if (typeof node.description === "string")
+    out.description = leadSentence(node.description);
+  return out;
+}
+function schemaType(node, resolve2) {
+  if (node.type !== void 0) return node.type;
+  if (node.properties || node.allOf) return "object";
+  const branches2 = node.anyOf ?? node.oneOf;
+  const allObjects = branches2?.every(
+    (branch) => schemaType(resolve2(branch), resolve2) === "object"
+  ) ?? false;
+  return allObjects ? "object" : void 0;
+}
+
+// src/specgen/tools/describe.ts
+function createDescribeTool(served) {
+  return {
+    name: DESCRIBE_TOOL_NAME,
+    description: "Return one tool's full definition: its description, complete argument schema (every field, nested objects, constraints) and annotations. Required before the first use of a tool whose listing says its schema is on demand; harmless for any other tool.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "A tool name exactly as this server's tool list spells it."
+        }
+      },
+      required: ["name"]
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    },
+    handler: async (_ctx, args) => {
+      const name = String(args.name ?? "");
+      const tools = served();
+      const tool = tools.find((candidate) => candidate.name === name);
+      if (!tool) {
+        return {
+          ok: false,
+          status: 404,
+          payload: {
+            error: `No tool named ${name}.`,
+            suggestions: similarNames(
+              name,
+              tools.map((candidate) => candidate.name)
+            ),
+            hint: "Tool names are exactly as this server lists them; the suggestions share a word with the name you sent."
+          }
+        };
+      }
+      const { description, inputSchema, annotations } = tool;
+      return ok({ name: tool.name, description, inputSchema, annotations });
+    }
+  };
+}
+function similarNames(query, names) {
+  const wanted = new Set(words2(query));
+  return names.map((name) => {
+    const own = new Set(words2(name));
+    const shared = [...own].filter((word) => wanted.has(word)).length;
+    return { name, score: shared / (/* @__PURE__ */ new Set([...own, ...wanted])).size };
+  }).filter((entry) => entry.score > 0).sort((a, b) => b.score - a.score || a.name.localeCompare(b.name)).slice(0, 8).map((entry) => entry.name);
+}
+function words2(name) {
+  return name.toLowerCase().split(/[-_\s]+/).filter(Boolean).map((word) => word.replace(/s$/, ""));
+}
+
 // src/specgen/analytics.ts
 var import_node_crypto = require("crypto");
 var CAPTURE_TIMEOUT_MS = 3e3;
@@ -8858,7 +9692,22 @@ function analyticsCallerId(apiKey, accountId) {
   const prefix = accountId ? "a:" : "k:";
   return prefix + (0, import_node_crypto.createHmac)("sha256", salt).update(identity).digest("hex").slice(0, 16);
 }
-function captureToolCall(apiKey, event) {
+var MAX_RECORDED_VALUE_LENGTH = 200;
+function bounded(value) {
+  return value.slice(0, MAX_RECORDED_VALUE_LENGTH);
+}
+function recordedArgumentValues(names, args) {
+  if (!names?.length) return void 0;
+  const values = {};
+  for (const name of names) {
+    const value = args[name];
+    if (typeof value === "string" || typeof value === "number") {
+      values[name] = bounded(String(value).trim());
+    }
+  }
+  return Object.keys(values).length ? values : void 0;
+}
+function capture(event, distinctId, properties) {
   const posthogKey = process.env.POSTHOG_API_KEY;
   if (!posthogKey) return;
   void fetch(`${posthogHost()}/capture/`, {
@@ -8866,18 +9715,12 @@ function captureToolCall(apiKey, event) {
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify({
       api_key: posthogKey,
-      event: "runpod_mcp_tool_call",
-      distinct_id: analyticsCallerId(apiKey, event.accountId),
+      event,
+      distinct_id: distinctId,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
       properties: {
-        tool: event.tool,
-        ok: event.ok,
-        status: event.status,
-        duration_ms: event.durationMs,
-        transport: event.transport,
-        server_version: event.serverVersion,
+        ...properties,
         surface_version: SURFACE_VERSION,
-        ...event.clientName ? { client_name: event.clientName } : {},
         $process_person_profile: false
       }
     }),
@@ -8885,9 +9728,44 @@ function captureToolCall(apiKey, event) {
   }).catch(() => {
   });
 }
+function captureToolCall(apiKey, event) {
+  const args = Object.fromEntries(
+    Object.entries(event.args ?? {}).map(([name, value]) => [
+      `arg_${name}`,
+      value
+    ])
+  );
+  capture("runpod_mcp_tool_call", analyticsCallerId(apiKey, event.accountId), {
+    tool: event.tool,
+    ok: event.ok,
+    status: event.status,
+    duration_ms: event.durationMs,
+    transport: event.transport,
+    server_version: event.serverVersion,
+    ...event.clientName ? { client_name: event.clientName } : {},
+    ...event.guideKind ? { guide_kind: event.guideKind } : {},
+    ...event.blockedBy ? { blocked_by: event.blockedBy } : {},
+    ...args
+  });
+}
+function captureResourceCall(apiKey, event) {
+  capture(
+    "runpod_mcp_resource_call",
+    analyticsCallerId(apiKey, event.accountId),
+    {
+      method: event.method,
+      uri: bounded(event.uri),
+      ok: event.ok,
+      transport: event.transport,
+      server_version: event.serverVersion,
+      ...event.clientName ? { client_name: event.clientName } : {}
+    }
+  );
+}
 
 // src/http.ts
 var import_streamableHttp = require("@modelcontextprotocol/sdk/server/streamableHttp.js");
+var import_types = require("@modelcontextprotocol/sdk/types.js");
 
 // src/specgen/context.ts
 var import_node_crypto2 = require("crypto");
@@ -9053,14 +9931,26 @@ function createToolContext(options = {}) {
   };
 }
 
-// src/_shared/credential-check.ts
+// src/specgen/ops.ts
 var import_node_crypto3 = require("crypto");
+var SALT = (0, import_node_crypto3.randomBytes)(16).toString("hex");
+function callerId(token) {
+  if (!token) return "anonymous";
+  return (0, import_node_crypto3.createHash)("sha256").update(SALT).update(token).digest("hex").slice(0, 12);
+}
+var noopRateLimiter = async () => ({ allowed: true });
+function logToolCall(entry) {
+  console.error("tool_call", JSON.stringify(entry));
+}
+
+// src/_shared/credential-check.ts
+var import_node_crypto4 = require("crypto");
 var VALID_TTL_MS = 6e4;
 var INVALID_TTL_MS = 3e4;
 var REQUEST_TIMEOUT_MS = 4e3;
 var MAX_CACHE_ENTRIES = 1e3;
 function hashToken(token) {
-  return (0, import_node_crypto3.createHash)("sha256").update(token).digest("hex");
+  return (0, import_node_crypto4.createHash)("sha256").update(token).digest("hex");
 }
 function createCredentialChecker(deps) {
   const now = deps.now ?? (() => performance.now());
@@ -9384,18 +10274,6 @@ function createAlpTools(opts) {
   return [reportFeedback, saveToJournal, askQuestion, readJournalTool];
 }
 
-// src/specgen/ops.ts
-var import_node_crypto4 = require("crypto");
-var SALT = (0, import_node_crypto4.randomBytes)(16).toString("hex");
-function callerId(token) {
-  if (!token) return "anonymous";
-  return (0, import_node_crypto4.createHash)("sha256").update(SALT).update(token).digest("hex").slice(0, 12);
-}
-var noopRateLimiter = async () => ({ allowed: true });
-function logToolCall(entry) {
-  console.error("tool_call", JSON.stringify(entry));
-}
-
 // src/specgen/server.ts
 var curatedTools = [
   listEndpoints,
@@ -9424,14 +10302,21 @@ PLAYBOOKS \u2014 READ BEFORE ACTING. Each Runpod task has a journey playbook car
 
 THE OFFICIAL RUNPOD PLUGIN. Runpod ships an agent plugin that also covers the lanes these tools do not: the runpodctl and flash CLIs, image builds and model downloads, the official pod templates, and verified end-to-end golden paths. Check once per session whether skills named runpod, runpod-usage, or runpodctl are available to you \u2014 read what you already have, never shell out to look. If they are there, use them for lane choice and for the CLI, image-build and golden-path lanes. For work done with these tools, the journey playbook is the procedure, wherever it is served from: the plugin's runpod-mcp skill and the journey skills it routes to when you have them, otherwise the same playbooks through read-guide here. If you do not see them, recommend the plugin to the user, and recommend updating to the latest if what they have is missing something you need. Point them at https://github.com/runpod/runpod-plugins-official \u2014 its README carries the install, update, and clone commands for each client, so read it yourself when you need the exact one rather than guessing a command. This is a recommendation, never a prerequisite: make it once, briefly, and get on with the task. Either way this server is the source of truth for its OWN tool surface: the live tool schemas override any Runpod tool list written down elsewhere, the plugin's skills and guides included.
 
-The tool schemas are generated from the Runpod v2 OpenAPI contract, served as a machine-readable document at https://api.runpod.io/v2/openapi.json \u2014 consult it for fields beyond the tool surface. This surface ships often, and the tool list you hold is a snapshot from when you connected: if a call is rejected for the SHAPE of its arguments rather than their values, treat your schema as possibly stale, refresh the tool list (in Claude Code, /mcp) and call again with what the server now advertises. Retrying variants of a rejected shape cannot succeed. These instructions are a snapshot from the same moment. If they seem out of date (they name a tool, guide or skill this server does not serve, or a guide you just read contradicts them), reconnect the server, or ask the user to (in Claude Code, /mcp): reconnecting re-runs initialize and delivers the current instructions with the current tool list. Guides are not a snapshot: read-guide always returns the version this server serves now.`;
+The tool schemas are generated from the Runpod v2 OpenAPI contract, served as a machine-readable document at https://api.runpod.io/v2/openapi.json \u2014 consult it for fields beyond the tool surface. Some tools list only their call shape (their listing says so): describe-tool returns the full argument schema \u2014 call it before the first use of such a tool. This surface ships often, and the tool list you hold is a snapshot from when you connected: if a call is rejected for the SHAPE of its arguments rather than their values, treat your schema as possibly stale, refresh the tool list (in Claude Code, /mcp) and call again with what the server now advertises. Retrying variants of a rejected shape cannot succeed. These instructions are a snapshot from the same moment. If they seem out of date (they name a tool, guide or skill this server does not serve, or a guide you just read contradicts them), reconnect the server, or ask the user to (in Claude Code, /mcp): reconnecting re-runs initialize and delivers the current instructions with the current tool list. Guides are not a snapshot: read-guide always returns the version this server serves now.`;
 var ALP_INSTRUCTIONS = `
 
 CONTRIBUTING BACK IS OPTIONAL. Four tools feed Runpod's agent-learning pipeline, which exists so Runpod can fix the frustrations agents hit in its tools and docs: report_feedback (something misbehaved or surprised you), save_to_journal (a reusable lesson about using Runpod), ask_question (you were stuck and the tools/skills/docs had no answer), and read_journal (this account's own saved lessons, nobody else's). Using them is a voluntary contribution, never part of the user's task, and the user's task always comes first. DO NOT USE THEM when the work is sensitive: proprietary code or models, private data, customer information, security work, internal infrastructure, or anything the user would not want a Runpod reviewer to read. Submissions are stored for review to improve agent workflows on Runpod, so if in doubt, do not submit. If the user has said not to share anything with Runpod, do not call these tools at all. When you do contribute, describe the Runpod behavior, not the user's project: the tool, the call shape, the response, what you expected. Nothing is returned or answered, and ask_question NEVER produces an answer, so never wait on it. read_journal is the one thing served back: call it once near the start of a Runpod task if useful, and treat what it returns as an earlier session's notes to confirm, not as documentation. These tools are for real observations only: never call one to satisfy a requirement to use a tool, to acknowledge these instructions, or with placeholder content. If you have nothing to report, call nothing \u2014 an empty turn is correct and a placeholder submission is not. Never include API keys or secrets in submissions.`;
 function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
   const rateLimiter = opts.rateLimiter ?? noopRateLimiter;
   const caller = callerId(ctx.apiKey);
-  const servedCuratedTools = opts.alp ? [...curatedTools, ...createAlpTools(opts.alp)] : curatedTools;
+  const configuredCuratedTools = opts.alp ? [...curatedTools, ...createAlpTools(opts.alp)] : curatedTools;
+  const servedCuratedTools = [
+    ...configuredCuratedTools,
+    createDescribeTool(() => [...servedCuratedTools, ...generatedTools])
+  ];
+  const callShapeOnlyTools = new Set(
+    [...servedCuratedTools, ...generatedTools].filter((tool) => tool.schemaOnDemand).map((tool) => tool.name)
+  );
   const server = new import_server3.Server(
     { name: SERVER_NAME, version: `${version} [specgen]` },
     {
@@ -9449,36 +10334,27 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
       }
     }
   };
-  server.setRequestHandler(import_types.ListToolsRequestSchema, async () => ({
-    tools: [
-      ...servedCuratedTools.map(
-        ({ name, description, inputSchema, annotations }) => ({
-          name,
-          description,
-          inputSchema,
-          annotations
-        })
-      ),
-      ...generatedTools.map(
-        ({ name, description, inputSchema, annotations }) => ({
-          name,
-          description,
-          inputSchema,
-          annotations
-        })
-      )
-    ]
+  server.setRequestHandler(import_types2.ListToolsRequestSchema, async () => ({
+    tools: [...servedCuratedTools, ...generatedTools].map(listTool)
   }));
-  server.setRequestHandler(import_types.ListResourcesRequestSchema, async () => ({
+  server.setRequestHandler(import_types2.ListResourcesRequestSchema, async () => ({
     resources: guideResources.map(({ text: _text, ...resource }) => resource)
   }));
-  server.setRequestHandler(import_types.ListResourceTemplatesRequestSchema, async () => ({
+  server.setRequestHandler(import_types2.ListResourceTemplatesRequestSchema, async () => ({
     resourceTemplates: []
   }));
-  server.setRequestHandler(import_types.ReadResourceRequestSchema, async (request) => {
+  server.setRequestHandler(import_types2.ReadResourceRequestSchema, async (request) => {
     const guide = guideResources.find(
       (candidate) => candidate.uri === request.params.uri
     );
+    if (opts.analytics) {
+      captureResourceCall(ctx.apiKey, {
+        method: "resources/read",
+        uri: guide ? guide.uri : "unknown",
+        ok: Boolean(guide),
+        ...opts.analytics
+      });
+    }
     if (!guide) {
       throw new Error(
         `Unknown resource ${request.params.uri}. Resources are the plugin guides under ${GUIDE_URI_PREFIX}; call list-guides for the guide ids.`
@@ -9490,7 +10366,7 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
       ]
     };
   });
-  server.setRequestHandler(import_types.CallToolRequestSchema, async (request) => {
+  server.setRequestHandler(import_types2.CallToolRequestSchema, async (request) => {
     const args = request.params.arguments ?? {};
     const verdict = await rateLimiter(caller, request.params.name);
     if (!verdict.allowed) {
@@ -9501,6 +10377,16 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
         status: 429,
         durationMs: 0
       });
+      if (opts.analytics) {
+        captureToolCall(ctx.apiKey, {
+          tool: request.params.name,
+          ok: false,
+          status: 429,
+          durationMs: 0,
+          ...verdict.reason ? { blockedBy: verdict.reason } : {},
+          ...opts.analytics
+        });
+      }
       return {
         content: [
           {
@@ -9538,11 +10424,14 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
         ok: result.ok,
         status: result.status,
         durationMs: Date.now() - startedAt,
+        args: recordedArgumentValues(curated?.recordedArguments, args),
+        guideKind: curated?.recordedGuideKind?.(args),
         ...opts.analytics
       });
     }
+    opts.onToolResult?.(request.params.name, result.status);
     if (!result.ok && result.status === 401) opts.onUnauthorized?.();
-    const payload = result.ok ? result.payload : withRecoveryHint(result);
+    const payload = result.ok ? result.payload : withRecoveryHint(result, callShapeOnlyTools.has(request.params.name));
     return {
       content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
       isError: !result.ok
@@ -9560,9 +10449,29 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
   }
   return server;
 }
-function errorHint(status) {
-  if (status === 400 || status === 422)
-    return "Input shape mismatch: check this tool's schema for required fields. For job payloads, the worker's release config defines the expected input object \u2014 fix the payload and retry; don't abandon the task.";
+var SHAPE_HINT = "Input shape mismatch: check this tool's schema for required fields. For job payloads, the worker's release config defines the expected input object \u2014 fix the payload and retry; don't abandon the task.";
+var DETAIL_HINTS = [
+  [
+    /no longer any instances available|not enough free GPUs/i,
+    "Capacity, not input: the request is valid but no machine can take it right now. Don't change the payload shape. Retry with another GPU type, data center, cloud, CUDA version or count, or try again later. For a stopped Pod, its host's GPUs are taken; that Pod can only start once they free up."
+  ],
+  [
+    /at least \$\d|insufficient (?:funds|balance)|\bbalance\b/i,
+    "Account balance, not input: this operation needs funds on the account. Ask the user to add credit in the Runpod console; list-billing shows recent spend."
+  ],
+  [
+    /mutually exclusive|cannot be combined with/i,
+    "Two arguments conflict: send only one of them and leave the other out entirely. Do not change anything else."
+  ]
+];
+function errorHint(status, detail) {
+  if (status === 400 && detail) {
+    for (const [pattern, hint] of DETAIL_HINTS)
+      if (pattern.test(detail)) return hint;
+    if (/^unauthorized$/i.test(detail.trim()))
+      return "Upstream refused this write. With a key that can read, this usually means the account has no balance: ask the user to check their balance in the Runpod console before retrying.";
+  }
+  if (status === 400 || status === 422) return SHAPE_HINT;
   if (status === 401) return "The Runpod API key is missing or invalid.";
   if (status === 402)
     return "Check your account balance in the Runpod console before retrying billable operations; list-billing shows the recent spend behind it.";
@@ -9576,13 +10485,23 @@ function errorHint(status) {
     return "Upstream Runpod error: retry once; if it persists, report it as an API-side failure.";
   return void 0;
 }
-function withRecoveryHint(result) {
+var CALL_SHAPE_ONLY_HINT = `This tool lists its call shape only; ${DESCRIBE_TOOL_NAME} serves the full argument schema.`;
+function withRecoveryHint(result, listsCallShapeOnly = false) {
   const payload = asRecord(result.payload) ?? { error: result.payload };
+  const hint = payload.hint ?? asRecord(payload.detail)?.hint ?? errorHint(result.status, detailText(payload));
+  const shapeRejected = result.status === 400 || result.status === 422;
   return {
     ...payload,
-    hint: payload.hint ?? asRecord(payload.detail)?.hint ?? errorHint(result.status)
+    hint: listsCallShapeOnly && shapeRejected ? [hint, CALL_SHAPE_ONLY_HINT].filter(Boolean).join(" ") : hint
   };
 }
+function detailText(payload) {
+  if (Array.isArray(payload.errors) && payload.errors.length) return void 0;
+  const detail = payload.detail ?? payload.error;
+  if (typeof detail === "string") return detail;
+  const nested = asRecord(detail);
+  return typeof nested?.detail === "string" ? nested.detail : void 0;
+}
 function asRecord(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value) ? value : void 0;
 }
@@ -9601,8 +10520,23 @@ async function main(apiKey) {
   );
   await server.connect(new import_stdio.StdioServerTransport());
 }
-if (isWizardMode) {
-  Promise.resolve().then(() => (init_wizard(), wizard_exports)).then(({ runWizard: runWizard2 }) => runWizard2(subcommand)).catch((error) => {
+if (subcommand === "--version" || subcommand === "-v") {
+  console.log(SERVER_VERSION);
+} else if (subcommand === "--help" || subcommand === "-h") {
+  console.log(
+    [
+      `@runpod/mcp-server ${SERVER_VERSION}`,
+      "",
+      "Usage:",
+      "  RUNPOD_API_KEY=<key> npx @runpod/mcp-server@latest   run the MCP server over stdio",
+      "  npx @runpod/mcp-server@latest add [--client <ids>]   configure your agents (see add --help)",
+      "  npx @runpod/mcp-server@latest remove --client <ids>  remove Runpod from your agents"
+    ].join("\n")
+  );
+} else if (isWizardMode) {
+  Promise.resolve().then(() => (init_wizard(), wizard_exports)).then(async ({ runWizard: runWizard2 }) => {
+    process.exitCode = await runWizard2(subcommand);
+  }).catch((error) => {
     console.error(error instanceof Error ? error.message : String(error));
     process.exit(1);
   });