@runpod/mcp-server 4.7.0 → 4.8.0

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @runpod/mcp-server
 
+## 4.8.0
+
+### Minor Changes
+
+- 8f53070: Export the server profile module as `@runpod/mcp-server/profile` (`ServerProfile`, `DIRECTORY_PATH`, `DIRECTORY_TOOLS`, `profileForPath`, `directoryIncludes`, `directoryOmittedInputs`) so an HTTP host can resolve the directory profile from the package instead of reaching into `src/`.
+- 4c51d2a: Resync the vendored v2 OpenAPI spec with production as of 2026-10-27 and regenerate the SDK schema and the tools. Adds `list-organization-users` and `get-organization-user`, documents the 413 response on list operations, and requires a non-empty mount `path`.
+
+### Patch Changes
+
+- 2658966: Record the tool surface on each `runpod_mcp_tool_call` analytics event as `profile` (`directory` for `mcp.runpod.io/directory`, `default` otherwise), so directory traffic (the ChatGPT plugin and the Claude connector) can be told apart from custom connectors on `/`.
+- f3efa2e: Avoid suggesting immediate retries when a timed-out or failed create may already have completed upstream.
+
 ## 4.7.0
 
 ### Minor Changes

package/README.md

@@ -226,3 +226,6 @@ the new generated surface. Applications should connect to the server through
 MCP using the `runpod-mcp` CLI, or use `handleMcpRequest` from
 `@runpod/mcp-server/http` when embedding the HTTP handler. The HTTP entry point
 also no longer re-exports the legacy `registerTools` or `ToolContext`.
+
+An HTTP host that serves the directory profile can import `DIRECTORY_PATH`
+and `profileForPath` from `@runpod/mcp-server/profile`.

package/dist/chunk-6IETGSON.mjs

@@ -0,0 +1,135 @@
+// src/specgen/profile.ts
+var DIRECTORY_PATH = "/directory";
+var IN = { include: true };
+var CREDENTIAL_MANAGEMENT = "Manages stored credentials; OpenAI restricts plugins that handle access credentials, so the directory leaves the whole credential family out.";
+var CREDENTIAL_INPUT = "Takes a secret or password as input; directories forbid collecting credentials.";
+var ALP = "Collects conversation-derived data beyond the task; the directory profile never serves it.";
+var DIRECTORY_TOOLS = {
+  "cancel-job": IN,
+  "create-cluster": IN,
+  "create-delegation": IN,
+  "create-endpoint": IN,
+  "create-global-volume": IN,
+  "create-network-volume": IN,
+  "create-pod": IN,
+  "create-template": IN,
+  "delete-cluster": IN,
+  "delete-endpoint": IN,
+  "delete-global-volume": IN,
+  "delete-network-volume": IN,
+  "delete-pod": IN,
+  "delete-template": IN,
+  "deploy-hub-repo": IN,
+  "endpoint-health": IN,
+  "get-capacity": IN,
+  "get-cluster": IN,
+  "get-cpu-type": IN,
+  "get-data-center": IN,
+  "get-endpoint": IN,
+  "get-endpoint-build": IN,
+  "get-global-volume": IN,
+  "get-gpu-type": IN,
+  "get-job-status": IN,
+  "get-network-volume": IN,
+  "get-organization": IN,
+  "get-organization-user": IN,
+  "get-pod": IN,
+  "get-ssh-keys": IN,
+  "get-template": IN,
+  "list-audit-logs": IN,
+  "list-billing": IN,
+  "list-cluster-billing": IN,
+  "list-cluster-pods": IN,
+  "list-clusters": IN,
+  "list-cpu-types": IN,
+  "list-data-centers": IN,
+  "list-delegations": IN,
+  "list-endpoint-billing": IN,
+  "list-endpoint-builds": IN,
+  "list-endpoint-releases": IN,
+  "list-endpoint-workers": IN,
+  "list-endpoints": IN,
+  "list-global-volumes": IN,
+  "list-gpu-types": IN,
+  "list-hub-repos": IN,
+  "list-network-volume-billing": IN,
+  "list-network-volumes": IN,
+  "list-organization-users": IN,
+  "list-pod-billing": IN,
+  "list-pods": IN,
+  "list-public-endpoints": IN,
+  "list-public-templates": IN,
+  "list-serverless-billing": IN,
+  "list-templates": IN,
+  "lookup-concept": IN,
+  "purge-endpoint-queue": IN,
+  "retry-job": IN,
+  "revoke-delegation": IN,
+  "search-concepts": IN,
+  "search-docs": IN,
+  "set-endpoint-gpus": IN,
+  "stream-job": IN,
+  "stream-pod-logs": IN,
+  "stream-worker-logs": IN,
+  "update-cluster": IN,
+  "update-endpoint": IN,
+  "update-global-volume": IN,
+  "update-network-volume": IN,
+  "update-pod": IN,
+  "update-ssh-keys": IN,
+  "update-template": IN,
+  "run-endpoint": { include: true, omitInputs: ["s3Config"] },
+  "runsync-endpoint": { include: true, omitInputs: ["s3Config"] },
+  "pod-action": {
+    include: false,
+    reason: "Takes the transition as an argument; OpenAI asks for one tool per operation, so the directory serves start-pod, stop-pod and restart-pod (terminate is delete-pod)."
+  },
+  "start-pod": IN,
+  "stop-pod": IN,
+  "restart-pod": IN,
+  "list-guides": {
+    include: false,
+    reason: "Serves playbooks that instruct the model how to behave."
+  },
+  "read-guide": {
+    include: false,
+    reason: "Serves playbooks that instruct the model how to behave."
+  },
+  "describe-tool": {
+    include: false,
+    reason: "Fetches schemas the directory already lists in full; directories reject schema fetching."
+  },
+  "create-secret": { include: false, reason: CREDENTIAL_INPUT },
+  "get-secret": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "list-secrets": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "delete-secret": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "get-registry": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "list-registries": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "delete-registry": { include: false, reason: CREDENTIAL_MANAGEMENT },
+  "update-secret": { include: false, reason: CREDENTIAL_INPUT },
+  "create-registry": { include: false, reason: CREDENTIAL_INPUT },
+  report_feedback: { include: false, reason: ALP },
+  report_how_user_found_runpod: { include: false, reason: ALP },
+  save_to_journal: { include: false, reason: ALP },
+  read_journal: { include: false, reason: ALP },
+  ask_question: { include: false, reason: ALP }
+};
+function directoryIncludes(name) {
+  return DIRECTORY_TOOLS[name]?.include === true;
+}
+function directoryOmittedInputs(name) {
+  const decision = DIRECTORY_TOOLS[name];
+  return decision?.include ? decision.omitInputs ?? [] : [];
+}
+function profileForPath(pathname) {
+  return pathname.replace(/\/+$/, "") === DIRECTORY_PATH ? "directory" : "default";
+}
+
+export {
+  DIRECTORY_PATH,
+  DIRECTORY_TOOLS,
+  directoryIncludes,
+  directoryOmittedInputs,
+  profileForPath
+};
+//# sourceMappingURL=chunk-6IETGSON.mjs.map

package/dist/chunk-6IETGSON.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/specgen/profile.ts"],"sourcesContent":["// Which tool surface a connection gets. `default` is the full surface every\n// client has always had. `directory` is what app directories (Anthropic's\n// connector directory, OpenAI's plugin directory) list: their policies forbid\n// tool descriptions that instruct the model, steer it toward other tools or\n// external instructions, or collect conversation data beyond the tool's job.\n// The directory profile is served only at DIRECTORY_PATH; nothing about the\n// default surface changes.\nexport type ServerProfile = 'default' | 'directory';\n\nexport const DIRECTORY_PATH = '/directory';\n\n/** Whether a tool is listed on the directory profile. Every tool the server\n *  can serve must have an entry, so a new tool (a spec regeneration, a new\n *  curated tool) fails tests/specgen-directory.test.ts until someone decides.\n *  The rules for deciding are in specgen/DIRECTORY_POLICY.md.\n *  `omitInputs` hides top-level arguments the directory must not ask for (a\n *  credential, for example); a call that passes one is refused. */\nexport type DirectoryDecision =\n  | { include: true; omitInputs?: readonly string[] }\n  | { include: false; reason: string };\n\nconst IN = { include: true } as const;\nconst CREDENTIAL_MANAGEMENT =\n  'Manages stored credentials; OpenAI restricts plugins that handle access credentials, so the directory leaves the whole credential family out.';\nconst CREDENTIAL_INPUT =\n  'Takes a secret or password as input; directories forbid collecting credentials.';\nconst ALP =\n  'Collects conversation-derived data beyond the task; the directory profile never serves it.';\n\nexport const DIRECTORY_TOOLS: Readonly<Record<string, DirectoryDecision>> = {\n  'cancel-job': IN,\n  'create-cluster': IN,\n  'create-delegation': IN,\n  'create-endpoint': IN,\n  'create-global-volume': IN,\n  'create-network-volume': IN,\n  'create-pod': IN,\n  'create-template': IN,\n  'delete-cluster': IN,\n  'delete-endpoint': IN,\n  'delete-global-volume': IN,\n  'delete-network-volume': IN,\n  'delete-pod': IN,\n  'delete-template': IN,\n  'deploy-hub-repo': IN,\n  'endpoint-health': IN,\n  'get-capacity': IN,\n  'get-cluster': IN,\n  'get-cpu-type': IN,\n  'get-data-center': IN,\n  'get-endpoint': IN,\n  'get-endpoint-build': IN,\n  'get-global-volume': IN,\n  'get-gpu-type': IN,\n  'get-job-status': IN,\n  'get-network-volume': IN,\n  'get-organization': IN,\n  'get-organization-user': IN,\n  'get-pod': IN,\n  'get-ssh-keys': IN,\n  'get-template': IN,\n  'list-audit-logs': IN,\n  'list-billing': IN,\n  'list-cluster-billing': IN,\n  'list-cluster-pods': IN,\n  'list-clusters': IN,\n  'list-cpu-types': IN,\n  'list-data-centers': IN,\n  'list-delegations': IN,\n  'list-endpoint-billing': IN,\n  'list-endpoint-builds': IN,\n  'list-endpoint-releases': IN,\n  'list-endpoint-workers': IN,\n  'list-endpoints': IN,\n  'list-global-volumes': IN,\n  'list-gpu-types': IN,\n  'list-hub-repos': IN,\n  'list-network-volume-billing': IN,\n  'list-network-volumes': IN,\n  'list-organization-users': IN,\n  'list-pod-billing': IN,\n  'list-pods': IN,\n  'list-public-endpoints': IN,\n  'list-public-templates': IN,\n  'list-serverless-billing': IN,\n  'list-templates': IN,\n  'lookup-concept': IN,\n  'purge-endpoint-queue': IN,\n  'retry-job': IN,\n  'revoke-delegation': IN,\n  'search-concepts': IN,\n  'search-docs': IN,\n  'set-endpoint-gpus': IN,\n  'stream-job': IN,\n  'stream-pod-logs': IN,\n  'stream-worker-logs': IN,\n  'update-cluster': IN,\n  'update-endpoint': IN,\n  'update-global-volume': IN,\n  'update-network-volume': IN,\n  'update-pod': IN,\n  'update-ssh-keys': IN,\n  'update-template': IN,\n  'run-endpoint': { include: true, omitInputs: ['s3Config'] },\n  'runsync-endpoint': { include: true, omitInputs: ['s3Config'] },\n  'pod-action': {\n    include: false,\n    reason:\n      'Takes the transition as an argument; OpenAI asks for one tool per operation, so the directory serves start-pod, stop-pod and restart-pod (terminate is delete-pod).',\n  },\n  'start-pod': IN,\n  'stop-pod': IN,\n  'restart-pod': IN,\n  'list-guides': {\n    include: false,\n    reason: 'Serves playbooks that instruct the model how to behave.',\n  },\n  'read-guide': {\n    include: false,\n    reason: 'Serves playbooks that instruct the model how to behave.',\n  },\n  'describe-tool': {\n    include: false,\n    reason:\n      'Fetches schemas the directory already lists in full; directories reject schema fetching.',\n  },\n  'create-secret': { include: false, reason: CREDENTIAL_INPUT },\n  'get-secret': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'list-secrets': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'delete-secret': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'get-registry': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'list-registries': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'delete-registry': { include: false, reason: CREDENTIAL_MANAGEMENT },\n  'update-secret': { include: false, reason: CREDENTIAL_INPUT },\n  'create-registry': { include: false, reason: CREDENTIAL_INPUT },\n  report_feedback: { include: false, reason: ALP },\n  report_how_user_found_runpod: { include: false, reason: ALP },\n  save_to_journal: { include: false, reason: ALP },\n  read_journal: { include: false, reason: ALP },\n  ask_question: { include: false, reason: ALP },\n};\n\n/** Served on the directory profile only with an explicit include. */\nexport function directoryIncludes(name: string): boolean {\n  return DIRECTORY_TOOLS[name]?.include === true;\n}\n\nexport function directoryOmittedInputs(name: string): readonly string[] {\n  const decision = DIRECTORY_TOOLS[name];\n  return decision?.include ? (decision.omitInputs ?? []) : [];\n}\n\nexport function profileForPath(pathname: string): ServerProfile {\n  return pathname.replace(/\\/+$/, '') === DIRECTORY_PATH\n    ? 'directory'\n    : 'default';\n}\n"],"mappings":"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","names":[]}

package/dist/http.cjs

@@ -566,9 +566,36 @@ var generatedTools = [
         },
         ClusterMounts: {
           description: "Storage mounts for a cluster create: `persistent` or `network`, not both. Clusters cannot mount global volumes, so `global` is rejected.",
+          "x-go-type": "BaseMounts",
           allOf: [
             {
               $ref: "#/$defs/BaseMounts"
+            },
+            {
+              type: "object",
+              properties: {
+                persistent: {
+                  type: "object",
+                  properties: {
+                    path: {
+                      type: "string",
+                      minLength: 1
+                    }
+                  }
+                },
+                network: {
+                  type: "array",
+                  items: {
+                    type: "object",
+                    properties: {
+                      path: {
+                        type: "string",
+                        minLength: 1
+                      }
+                    }
+                  }
+                }
+              }
             }
           ],
           unevaluatedProperties: false
@@ -2644,6 +2671,37 @@ var generatedTools = [
       properties: {}
     }
   },
+  {
+    name: "get-organization-user",
+    title: "Get organization user",
+    operationId: "getOrganizationUser",
+    description: "Get an organization member. Returns one member of the authenticated caller's organization by user ID, with the role they hold. Any member can read it. A user who is not a member, including one from another organization, returns 404. 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/users/{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: "User identifier"
+        }
+      },
+      required: ["id"]
+    }
+  },
   {
     name: "get-pod",
     title: "Get Pod",
@@ -3783,6 +3841,26 @@ var generatedTools = [
       }
     }
   },
+  {
+    name: "list-organization-users",
+    title: "List organization users",
+    operationId: "listOrganizationUsers",
+    description: "List organization members. Returns every member of the authenticated caller's organization with the role each holds. Any member can read the roster. The list is complete and takes no pagination parameters. 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/users",
+    params: [],
+    hasBody: false,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    },
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
   {
     name: "list-pod-billing",
     title: "List Pod billing",
@@ -5339,6 +5417,7 @@ function networkFailureResult(error) {
   return {
     ok: false,
     status: unreached ? 503 : 502,
+    requestDelivery: unreached ? "not_sent" : "uncertain",
     payload: unreached ? {
       error: "Could not reach the Runpod API.",
       cause: code,
@@ -5365,6 +5444,7 @@ async function runTool(body) {
       return {
         ok: false,
         status: 504,
+        requestDelivery: "uncertain",
         payload: {
           error: "The Runpod API did not respond before the request deadline.",
           hint: "Transient upstream stall: retry the same call once; if it persists, check https://uptime.runpod.io."
@@ -5457,6 +5537,7 @@ var DIRECTORY_TOOLS = {
   "get-job-status": IN,
   "get-network-volume": IN,
   "get-organization": IN,
+  "get-organization-user": IN,
   "get-pod": IN,
   "get-ssh-keys": IN,
   "get-template": IN,
@@ -5478,6 +5559,7 @@ var DIRECTORY_TOOLS = {
   "list-hub-repos": IN,
   "list-network-volume-billing": IN,
   "list-network-volumes": IN,
+  "list-organization-users": IN,
   "list-pod-billing": IN,
   "list-pods": IN,
   "list-public-endpoints": IN,
@@ -9097,7 +9179,7 @@ function words2(name) {
 
 // src/server.ts
 var SERVER_NAME = "Runpod API Server";
-var SERVER_VERSION = true ? "4.7.0" : "dev";
+var SERVER_VERSION = true ? "4.8.0" : "dev";
 
 // src/specgen/analytics.ts
 var import_node_crypto = require("crypto");
@@ -9166,6 +9248,7 @@ function captureToolCall(apiKey, event) {
     ...event.clientName ? { client_name: event.clientName } : {},
     ...event.guideKind ? { guide_kind: event.guideKind } : {},
     ...event.blockedBy ? { blocked_by: event.blockedBy } : {},
+    ...event.profile ? { profile: event.profile } : {},
     ...args
   });
 }
@@ -9798,6 +9881,7 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
           status: 429,
           durationMs: 0,
           ...verdict.reason ? { blockedBy: verdict.reason } : {},
+          profile,
           ...opts.analytics
         });
       }
@@ -9818,6 +9902,9 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
     const curated = servedCuratedTools.find(
       (tool) => tool.name === request.params.name
     );
+    const generated = servedGeneratedTools.find(
+      (tool) => tool.name === request.params.name
+    );
     const omitted = directory ? directoryOmittedInputs(request.params.name).filter((key) => key in args) : [];
     const rejected = omitted.length ? {
       ok: false,
@@ -9830,7 +9917,7 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
       args
     ) : null;
     const result = rejected ?? await runTool(
-      () => curated ? curated.handler(ctx, args) : dispatchTool(request.params.name, args)
+      () => curated ? curated.handler(ctx, args) : dispatchTool(generated, request.params.name, args)
     );
     logToolCall({
       tool: request.params.name,
@@ -9850,23 +9937,27 @@ function createSpecgenServer(ctx, version = "0.1.0", opts = {}) {
           args: recordedArgumentValues(curated?.recordedArguments, args),
           guideKind: curated?.recordedGuideKind?.(args)
         },
+        profile,
         ...opts.analytics
       });
     }
     opts.onToolResult?.(request.params.name, result.status);
     if (!result.ok && result.status === 401) opts.onUnauthorized?.();
+    const annotations = curated?.annotations ?? generated?.annotations;
     const payload = redactSecretEnv(
-      result.ok ? result.payload : withRecoveryHint(result, callShapeOnlyTools.has(request.params.name))
+      result.ok ? result.payload : withRecoveryHint(
+        result,
+        annotations?.idempotentHint === true,
+        request.params.name,
+        callShapeOnlyTools.has(request.params.name)
+      )
     );
     return {
       content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
       isError: !result.ok
     };
   });
-  async function dispatchTool(name, args) {
-    const tool = servedGeneratedTools.find(
-      (candidate) => candidate.name === name
-    );
+  async function dispatchTool(tool, name, args) {
     if (!tool)
       return {
         ok: false,
@@ -9914,8 +10005,24 @@ function errorHint(status, detail) {
   return void 0;
 }
 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) {
+var OUTCOME_UNKNOWN_HINT = "Runpod may have completed this operation even though its response failed. Do not submit it again yet. Check the matching get- or list- tool or the Runpod console using the original request details and time. Lists can lag; if you cannot confirm the outcome, stop and ask the user to verify before retrying.";
+var JOB_OUTCOME_UNKNOWN_HINT = "Runpod may have submitted this Serverless job even though its response failed. Do not submit it again yet. No job-list tool is available, and get-job-status requires a job ID that this failed response may not have returned. Check the endpoint in the Runpod console or ask the user to verify the submission. If the outcome remains uncertain, stop instead of retrying.";
+var RETRY_JOB_OUTCOME_UNKNOWN_HINT = "Runpod may have requeued this Serverless job even though its response failed. Do not retry it again yet. Check get-job-status with the endpoint and job IDs you supplied, or check the Runpod console. If you cannot confirm the outcome, stop and ask the user to verify before retrying.";
+var JOB_SUBMISSION_TOOLS = /* @__PURE__ */ new Set(["run-endpoint", "runsync-endpoint"]);
+function withRecoveryHint(result, idempotent, toolName, listsCallShapeOnly = false) {
   const payload = asRecord(result.payload) ?? { error: result.payload };
+  if (!idempotent && result.status >= 500 && result.requestDelivery !== "not_sent") {
+    const detail = asRecord(payload.detail);
+    const safeDetail = detail ? { ...detail } : void 0;
+    if (safeDetail) delete safeDetail.hint;
+    return {
+      ...payload,
+      ...safeDetail ? { detail: safeDetail } : {},
+      ...payload.code !== void 0 ? { upstreamCode: payload.code } : {},
+      code: "outcome_unknown",
+      hint: toolName === "retry-job" ? RETRY_JOB_OUTCOME_UNKNOWN_HINT : JOB_SUBMISSION_TOOLS.has(toolName) ? JOB_OUTCOME_UNKNOWN_HINT : OUTCOME_UNKNOWN_HINT
+    };
+  }
   const hint = payload.hint ?? asRecord(payload.detail)?.hint ?? errorHint(result.status, detailText(payload));
   const shapeRejected = result.status === 400 || result.status === 422;
   return {