@fern-api/fern-api-dev 5.58.0 → 5.60.0

package/cli.cjs

@@ -60204,6 +60204,42 @@ var init_AsymmetricAlgorithmSchema2 = __esm({
   }
 });
 
+// ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadBodySortSchema.js
+var WebhookPayloadBodySortSchema2;
+var init_WebhookPayloadBodySortSchema2 = __esm({
+  "../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadBodySortSchema.js"() {
+    "use strict";
+    init_core();
+    WebhookPayloadBodySortSchema2 = schemas_exports.enum_(["alphabetical"]);
+  }
+});
+
+// ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadComponentSchema.js
+var WebhookPayloadComponentSchema2;
+var init_WebhookPayloadComponentSchema2 = __esm({
+  "../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadComponentSchema.js"() {
+    "use strict";
+    init_core();
+    WebhookPayloadComponentSchema2 = schemas_exports.enum_(["body", "timestamp", "notification-url", "message-id"]);
+  }
+});
+
+// ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadFormatSchema.js
+var WebhookPayloadFormatSchema;
+var init_WebhookPayloadFormatSchema2 = __esm({
+  "../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadFormatSchema.js"() {
+    "use strict";
+    init_core();
+    init_WebhookPayloadBodySortSchema2();
+    init_WebhookPayloadComponentSchema2();
+    WebhookPayloadFormatSchema = schemas_exports.object({
+      components: schemas_exports.list(WebhookPayloadComponentSchema2),
+      delimiter: schemas_exports.string().optional(),
+      "body-sort": WebhookPayloadBodySortSchema2.optional()
+    });
+  }
+});
+
 // ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookSignatureEncodingSchema.js
 var WebhookSignatureEncodingSchema2;
 var init_WebhookSignatureEncodingSchema2 = __esm({
@@ -60246,6 +60282,7 @@ var init_AsymmetricSignatureSchema2 = __esm({
     "use strict";
     init_core();
     init_AsymmetricAlgorithmSchema2();
+    init_WebhookPayloadFormatSchema2();
     init_WebhookSignatureEncodingSchema2();
     init_WebhookTimestampSchema2();
     AsymmetricSignatureSchema = schemas_exports.object({
@@ -60255,47 +60292,12 @@ var init_AsymmetricSignatureSchema2 = __esm({
       "signature-prefix": schemas_exports.string().optional(),
       "jwks-url": schemas_exports.string().optional(),
       "key-id-header": schemas_exports.string().optional(),
+      "payload-format": WebhookPayloadFormatSchema.optional(),
       timestamp: WebhookTimestampSchema.optional()
     });
   }
 });
 
-// ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadBodySortSchema.js
-var WebhookPayloadBodySortSchema2;
-var init_WebhookPayloadBodySortSchema2 = __esm({
-  "../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadBodySortSchema.js"() {
-    "use strict";
-    init_core();
-    WebhookPayloadBodySortSchema2 = schemas_exports.enum_(["alphabetical"]);
-  }
-});
-
-// ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadComponentSchema.js
-var WebhookPayloadComponentSchema2;
-var init_WebhookPayloadComponentSchema2 = __esm({
-  "../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadComponentSchema.js"() {
-    "use strict";
-    init_core();
-    WebhookPayloadComponentSchema2 = schemas_exports.enum_(["body", "timestamp", "notification-url", "message-id"]);
-  }
-});
-
-// ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadFormatSchema.js
-var WebhookPayloadFormatSchema;
-var init_WebhookPayloadFormatSchema2 = __esm({
-  "../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookPayloadFormatSchema.js"() {
-    "use strict";
-    init_core();
-    init_WebhookPayloadBodySortSchema2();
-    init_WebhookPayloadComponentSchema2();
-    WebhookPayloadFormatSchema = schemas_exports.object({
-      components: schemas_exports.list(WebhookPayloadComponentSchema2),
-      delimiter: schemas_exports.string().optional(),
-      "body-sort": WebhookPayloadBodySortSchema2.optional()
-    });
-  }
-});
-
 // ../fern-definition/schema/lib/schemas/serialization/resources/webhooks/types/WebhookSignatureAlgorithmSchema.js
 var WebhookSignatureAlgorithmSchema2;
 var init_WebhookSignatureAlgorithmSchema2 = __esm({
@@ -76219,6 +76221,7 @@ var init_V2HttpEndpointExample2 = __esm({
     init_V2HttpEndpointResponse2();
     V2HttpEndpointExample = schemas_exports3.objectWithoutOptionalProperties({
       displayName: schemas_exports3.string().optional(),
+      contentType: schemas_exports3.string().optional(),
       request: V2HttpEndpointRequest.optional(),
       response: V2HttpEndpointResponse.optional(),
       codeSamples: schemas_exports3.list(V2HttpEndpointCodeSample).optional()
@@ -80569,6 +80572,42 @@ var init_AsymmetricKeySource2 = __esm({
   }
 });
 
+// ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadBodySort.js
+var WebhookPayloadBodySort2;
+var init_WebhookPayloadBodySort2 = __esm({
+  "../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadBodySort.js"() {
+    "use strict";
+    init_core2();
+    WebhookPayloadBodySort2 = schemas_exports3.enum_(["ALPHABETICAL"]);
+  }
+});
+
+// ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadComponent.js
+var WebhookPayloadComponent2;
+var init_WebhookPayloadComponent2 = __esm({
+  "../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadComponent.js"() {
+    "use strict";
+    init_core2();
+    WebhookPayloadComponent2 = schemas_exports3.enum_(["BODY", "TIMESTAMP", "NOTIFICATION_URL", "MESSAGE_ID"]);
+  }
+});
+
+// ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadFormat.js
+var WebhookPayloadFormat;
+var init_WebhookPayloadFormat2 = __esm({
+  "../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadFormat.js"() {
+    "use strict";
+    init_core2();
+    init_WebhookPayloadBodySort2();
+    init_WebhookPayloadComponent2();
+    WebhookPayloadFormat = schemas_exports3.objectWithoutOptionalProperties({
+      components: schemas_exports3.list(WebhookPayloadComponent2),
+      delimiter: schemas_exports3.string(),
+      bodySort: WebhookPayloadBodySort2.optional()
+    });
+  }
+});
+
 // ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookSignatureEncoding.js
 var WebhookSignatureEncoding2;
 var init_WebhookSignatureEncoding2 = __esm({
@@ -80614,6 +80653,7 @@ var init_AsymmetricKeySignatureVerification2 = __esm({
     init_NameAndWireValueOrString3();
     init_AsymmetricAlgorithm2();
     init_AsymmetricKeySource2();
+    init_WebhookPayloadFormat2();
     init_WebhookSignatureEncoding2();
     init_WebhookTimestampConfig2();
     AsymmetricKeySignatureVerification = schemas_exports3.objectWithoutOptionalProperties({
@@ -80622,6 +80662,7 @@ var init_AsymmetricKeySignatureVerification2 = __esm({
       encoding: WebhookSignatureEncoding2,
       signaturePrefix: schemas_exports3.string().optional(),
       keySource: AsymmetricKeySource2,
+      payloadFormat: WebhookPayloadFormat.optional(),
       timestamp: WebhookTimestampConfig.optional()
     });
   }
@@ -80637,42 +80678,6 @@ var init_HmacAlgorithm2 = __esm({
   }
 });
 
-// ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadBodySort.js
-var WebhookPayloadBodySort2;
-var init_WebhookPayloadBodySort2 = __esm({
-  "../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadBodySort.js"() {
-    "use strict";
-    init_core2();
-    WebhookPayloadBodySort2 = schemas_exports3.enum_(["ALPHABETICAL"]);
-  }
-});
-
-// ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadComponent.js
-var WebhookPayloadComponent2;
-var init_WebhookPayloadComponent2 = __esm({
-  "../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadComponent.js"() {
-    "use strict";
-    init_core2();
-    WebhookPayloadComponent2 = schemas_exports3.enum_(["BODY", "TIMESTAMP", "NOTIFICATION_URL", "MESSAGE_ID"]);
-  }
-});
-
-// ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadFormat.js
-var WebhookPayloadFormat;
-var init_WebhookPayloadFormat2 = __esm({
-  "../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/WebhookPayloadFormat.js"() {
-    "use strict";
-    init_core2();
-    init_WebhookPayloadBodySort2();
-    init_WebhookPayloadComponent2();
-    WebhookPayloadFormat = schemas_exports3.objectWithoutOptionalProperties({
-      components: schemas_exports3.list(WebhookPayloadComponent2),
-      delimiter: schemas_exports3.string(),
-      bodySort: WebhookPayloadBodySort2.optional()
-    });
-  }
-});
-
 // ../../ir-sdk/lib/sdk/serialization/resources/webhooks/types/HmacSignatureVerification.js
 var HmacSignatureVerification;
 var init_HmacSignatureVerification2 = __esm({
@@ -116904,6 +116909,7 @@ var init_DocsYmlSchemas = __esm({
       chatgpt: external_exports.boolean().optional(),
       claude: external_exports.boolean().optional(),
       cursor: external_exports.boolean().optional(),
+      mcp: external_exports.boolean().optional(),
       vscode: external_exports.boolean().optional(),
       custom: external_exports.array(CustomPageAction).optional()
     });
@@ -122910,6 +122916,7 @@ var init_PageActionOptions2 = __esm({
       claude: schemas_exports6.boolean().optional(),
       claudeCode: schemas_exports6.property("claude-code", schemas_exports6.boolean().optional()),
       cursor: schemas_exports6.boolean().optional(),
+      mcp: schemas_exports6.boolean().optional(),
       vscode: schemas_exports6.boolean().optional(),
       custom: schemas_exports6.list(CustomPageAction2).optional(),
       skills: SkillsPageActionConfig.optional()
@@ -137416,6 +137423,42 @@ var init_AsymmetricAlgorithm4 = __esm({
   }
 });
 
+// ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadBodySort.js
+var WebhookPayloadBodySort4;
+var init_WebhookPayloadBodySort4 = __esm({
+  "../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadBodySort.js"() {
+    "use strict";
+    init_core7();
+    WebhookPayloadBodySort4 = schemas_exports9.enum_(["alphabetical"]);
+  }
+});
+
+// ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadComponent.js
+var WebhookPayloadComponent4;
+var init_WebhookPayloadComponent4 = __esm({
+  "../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadComponent.js"() {
+    "use strict";
+    init_core7();
+    WebhookPayloadComponent4 = schemas_exports9.enum_(["body", "timestamp", "notification-url", "message-id"]);
+  }
+});
+
+// ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadFormat.js
+var WebhookPayloadFormat2;
+var init_WebhookPayloadFormat4 = __esm({
+  "../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadFormat.js"() {
+    "use strict";
+    init_core7();
+    init_WebhookPayloadBodySort4();
+    init_WebhookPayloadComponent4();
+    WebhookPayloadFormat2 = schemas_exports9.objectWithoutOptionalProperties({
+      components: schemas_exports9.list(WebhookPayloadComponent4),
+      delimiter: schemas_exports9.string().optional(),
+      bodySort: WebhookPayloadBodySort4.optional()
+    });
+  }
+});
+
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookSignatureEncoding.js
 var WebhookSignatureEncoding4;
 var init_WebhookSignatureEncoding4 = __esm({
@@ -137458,6 +137501,7 @@ var init_AsymmetricWebhookSignatureVerification2 = __esm({
     "use strict";
     init_core7();
     init_AsymmetricAlgorithm4();
+    init_WebhookPayloadFormat4();
     init_WebhookSignatureEncoding4();
     init_WebhookTimestamp2();
     AsymmetricWebhookSignatureVerification = schemas_exports9.objectWithoutOptionalProperties({
@@ -137467,6 +137511,7 @@ var init_AsymmetricWebhookSignatureVerification2 = __esm({
       signaturePrefix: schemas_exports9.string().optional(),
       jwksUrl: schemas_exports9.string().optional(),
       keyIdHeader: schemas_exports9.string().optional(),
+      payloadFormat: WebhookPayloadFormat2.optional(),
       timestamp: WebhookTimestamp.optional()
     });
   }
@@ -138426,42 +138471,6 @@ var init_GlobalSecurity2 = __esm({
   }
 });
 
-// ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadBodySort.js
-var WebhookPayloadBodySort4;
-var init_WebhookPayloadBodySort4 = __esm({
-  "../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadBodySort.js"() {
-    "use strict";
-    init_core7();
-    WebhookPayloadBodySort4 = schemas_exports9.enum_(["alphabetical"]);
-  }
-});
-
-// ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadComponent.js
-var WebhookPayloadComponent4;
-var init_WebhookPayloadComponent4 = __esm({
-  "../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadComponent.js"() {
-    "use strict";
-    init_core7();
-    WebhookPayloadComponent4 = schemas_exports9.enum_(["body", "timestamp", "notification-url", "message-id"]);
-  }
-});
-
-// ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadFormat.js
-var WebhookPayloadFormat2;
-var init_WebhookPayloadFormat4 = __esm({
-  "../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookPayloadFormat.js"() {
-    "use strict";
-    init_core7();
-    init_WebhookPayloadBodySort4();
-    init_WebhookPayloadComponent4();
-    WebhookPayloadFormat2 = schemas_exports9.objectWithoutOptionalProperties({
-      components: schemas_exports9.list(WebhookPayloadComponent4),
-      delimiter: schemas_exports9.string().optional(),
-      bodySort: WebhookPayloadBodySort4.optional()
-    });
-  }
-});
-
 // ../api-importers/openapi/openapi-ir/lib/sdk/serialization/resources/finalIr/types/WebhookSignatureAlgorithm.js
 var WebhookSignatureAlgorithm2;
 var init_WebhookSignatureAlgorithm2 = __esm({
@@ -146032,6 +146041,7 @@ function convertSignatureVerification(signatureVerification) {
         "signature-prefix": signatureVerification.signaturePrefix,
         "jwks-url": signatureVerification.jwksUrl,
         "key-id-header": signatureVerification.keyIdHeader,
+        "payload-format": convertPayloadFormat(signatureVerification.payloadFormat),
         timestamp: convertTimestamp(signatureVerification.timestamp)
       };
     default:
@@ -165270,6 +165280,7 @@ function convertSignatureSchema(extension4) {
       signaturePrefix: extension4["signature-prefix"],
       jwksUrl: extension4["jwks-url"],
       keyIdHeader: extension4["key-id-header"],
+      payloadFormat: convertPayloadFormat2(extension4["payload-format"]),
       timestamp: convertTimestamp2(extension4.timestamp)
     });
   }
@@ -232161,6 +232172,7 @@ function convertPageActions(pageActions, absoluteFilepathToDocsConfig) {
       claude: pageActions.options?.claude ?? true,
       cursor: pageActions.options?.cursor ?? true,
       claudeCode: pageActions.options?.claudeCode ?? true,
+      mcp: pageActions.options?.mcp ?? true,
       vscode: pageActions.options?.vscode ?? false,
       custom: (pageActions.options?.custom ?? []).map((action) => convertCustomPageAction(action, absoluteFilepathToDocsConfig)),
       skills: convertSkillsPageAction(pageActions.options?.skills)
@@ -263778,6 +263790,7 @@ function maybeCreateAndStoreExample({ key: key2, displayName, request: request7,
   if (!exampleStore.has(key2)) {
     const example = {
       displayName,
+      contentType: void 0,
       request: request7,
       response,
       codeSamples: void 0
@@ -273611,6 +273624,7 @@ function convertAsymmetricSignature({ asymmetric, file: file4 }) {
     encoding: convertSignatureEncoding2(asymmetric.encoding),
     signaturePrefix: asymmetric["signature-prefix"],
     keySource: convertKeySource({ asymmetric, file: file4 }),
+    payloadFormat: asymmetric["payload-format"] != null ? convertPayloadFormat3(asymmetric["payload-format"]) : void 0,
     timestamp: convertTimestampConfig({ timestamp: asymmetric.timestamp, file: file4 })
   };
 }
@@ -323787,6 +323801,17 @@ var init_fern_schema = __esm({
                 ],
                 description: "HTTP header containing the key ID for JWKS key selection."
               },
+              "payload-format": {
+                oneOf: [
+                  {
+                    $ref: "#/definitions/webhooks.WebhookPayloadFormatSchema"
+                  },
+                  {
+                    type: "null"
+                  }
+                ],
+                description: 'Describes how the signed payload is constructed.\nDefaults to body-only (components: [body], delimiter: "").'
+              },
               timestamp: {
                 oneOf: [
                   {
@@ -328092,6 +328117,17 @@ var init_package_yml_schema = __esm({
                 ],
                 description: "HTTP header containing the key ID for JWKS key selection."
               },
+              "payload-format": {
+                oneOf: [
+                  {
+                    $ref: "#/definitions/webhooks.WebhookPayloadFormatSchema"
+                  },
+                  {
+                    type: "null"
+                  }
+                ],
+                description: 'Describes how the signed payload is constructed.\nDefaults to body-only (components: [body], delimiter: "").'
+              },
               timestamp: {
                 oneOf: [
                   {
@@ -350712,6 +350748,19 @@ var init_OperationConverter = __esm({
             }
           }
         }
+        if (Object.keys(fernExamples.examples).length === 0 && Object.keys(fernExamples.streamExamples).length === 0 && convertedRequestBodies != null && convertedRequestBodies.length > 1) {
+          const perContentTypeExamples = this.synthesizeEndpointExamplesFromPerContentTypeRequestBodies({
+            convertedRequestBodies,
+            httpPath: path119,
+            httpMethod,
+            baseUrl
+          });
+          if (perContentTypeExamples != null) {
+            for (const [name2, example] of Object.entries(perContentTypeExamples)) {
+              fernExamples.examples[name2] = example;
+            }
+          }
+        }
         const endpointLevelSecuritySchemes = new Set(this.operation.security?.flatMap((securityRequirement) => Object.keys(securityRequirement)) ?? []);
         const securityHeaders = this.authSchemeToHeaders(Array.from(endpointLevelSecuritySchemes));
         if (securityHeaders.length > 0) {
@@ -351235,6 +351284,7 @@ var init_OperationConverter = __esm({
             if (resolvedValue != null) {
               result[name2] = {
                 displayName: void 0,
+                contentType: void 0,
                 request: {
                   docs: void 0,
                   endpoint: {
@@ -351298,6 +351348,104 @@ var init_OperationConverter = __esm({
         }
         return void 0;
       }
+      /**
+       * Synthesizes endpoint-level v2Examples from per-content-type request body
+       * examples that have already been extracted by the RequestBodyConverter.
+       *
+       * This handles the case where multiple content types (e.g. application/json
+       * and application/ld+json) reference the same schema but have distinct
+       * per-content-type examples. The RequestBodyConverter correctly extracts
+       * these into each body's v2Examples, but they need to be elevated to
+       * endpoint-level examples (tagged with contentType) for docs rendering.
+       */
+      synthesizeEndpointExamplesFromPerContentTypeRequestBodies({ convertedRequestBodies, httpPath, httpMethod, baseUrl }) {
+        const result = {};
+        const responseExamplesByContentType = this.extractNativeResponseExamplesByContentType();
+        for (const convertedBody of convertedRequestBodies) {
+          const body = convertedBody.requestBody;
+          const bodyContentType = body.contentType;
+          const bodyV2Examples = body.v2Examples;
+          if (bodyV2Examples == null) {
+            continue;
+          }
+          const userExamples = bodyV2Examples.userSpecifiedExamples;
+          if (Object.keys(userExamples).length === 0) {
+            continue;
+          }
+          const matchedResponse = bodyContentType != null ? responseExamplesByContentType.get(bodyContentType) : void 0;
+          for (const [exampleName, exampleValue] of Object.entries(userExamples)) {
+            const key2 = convertedRequestBodies.length > 1 && bodyContentType != null ? `${exampleName} (${bodyContentType})` : exampleName;
+            result[key2] = {
+              displayName: convertedRequestBodies.length > 1 ? key2 : void 0,
+              contentType: bodyContentType ?? void 0,
+              request: {
+                docs: void 0,
+                endpoint: {
+                  method: httpMethod,
+                  path: this.buildExamplePath(httpPath, {})
+                },
+                baseUrl: void 0,
+                environment: baseUrl,
+                auth: void 0,
+                pathParameters: {},
+                queryParameters: {},
+                headers: {},
+                requestBody: exampleValue
+              },
+              response: matchedResponse ?? this.extractNativeResponseExample() ?? void 0,
+              codeSamples: void 0
+            };
+          }
+        }
+        return Object.keys(result).length > 0 ? result : void 0;
+      }
+      /**
+       * Extracts native response examples grouped by content type from the
+       * operation's successful (2xx) responses. Used by
+       * synthesizeEndpointExamplesFromPerContentTypeRequestBodies to match
+       * response examples to their corresponding request content types.
+       */
+      extractNativeResponseExamplesByContentType() {
+        const responsesByContentType = /* @__PURE__ */ new Map();
+        if (this.operation.responses == null) {
+          return responsesByContentType;
+        }
+        for (const [statusCode, response] of Object.entries(this.operation.responses)) {
+          const statusCodeNum = parseInt(statusCode);
+          if (isNaN(statusCodeNum) || statusCodeNum < 200 || statusCodeNum >= 300) {
+            continue;
+          }
+          const resolvedResponse = this.context.resolveMaybeReference({
+            schemaOrReference: response,
+            breadcrumbs: [...this.breadcrumbs, "responses", statusCode]
+          });
+          if (resolvedResponse?.content == null) {
+            continue;
+          }
+          for (const [responseContentType, responseMediaType] of Object.entries(resolvedResponse.content)) {
+            if (responsesByContentType.has(responseContentType)) {
+              continue;
+            }
+            const namedExamples = this.context.getNamedExamplesFromMediaTypeObject({
+              mediaTypeObject: responseMediaType,
+              breadcrumbs: [...this.breadcrumbs, "responses", statusCode],
+              defaultExampleName: "Example"
+            });
+            for (const [, example] of namedExamples) {
+              const resolvedValue = this.context.resolveExampleWithValue(example);
+              if (resolvedValue != null) {
+                responsesByContentType.set(responseContentType, {
+                  docs: void 0,
+                  statusCode: statusCodeNum,
+                  body: api_exports.V2HttpEndpointResponseBody.json(resolvedValue)
+                });
+                break;
+              }
+            }
+          }
+        }
+        return responsesByContentType;
+      }
       convertStreamConditionExamples({ httpPath, httpMethod, baseUrl, fernExamples }) {
         const filteredJsonExamples = fernExamples.filter((example) => !(example.response != null && "stream" in example.response));
         const filteredStreamExamples = fernExamples.filter((example) => example.response != null && "stream" in example.response);
@@ -351321,6 +351469,7 @@ var init_OperationConverter = __esm({
             this.getExampleName({ example, exampleIndex }),
             {
               displayName: void 0,
+              contentType: void 0,
               request: example.request != null || example["path-parameters"] != null || example["query-parameters"] != null || example.headers != null ? {
                 docs: void 0,
                 endpoint: {
@@ -352776,6 +352925,7 @@ var init_MethodConverter = __esm({
             }
             examples[exampleName] = {
               displayName: void 0,
+              contentType: void 0,
               request: {
                 docs: void 0,
                 endpoint: {
@@ -460746,6 +460896,7 @@ https://buildwithfern.com/learn/docs/getting-started/project-structure#api-defin
             cursor: this.parsedDocsConfig.pageActions.options.cursor,
             claudeCode: this.parsedDocsConfig.pageActions.options.claudeCode,
             vscode: this.parsedDocsConfig.pageActions.options.vscode,
+            ...!this.parsedDocsConfig.pageActions.options.mcp ? { mcp: false } : {},
             custom: this.parsedDocsConfig.pageActions.options.custom.map((customAction) => ({
               title: customAction.title,
               subtitle: customAction.subtitle,
@@ -686972,7 +687123,7 @@ var AccessTokenPosthogManager = class {
         properties: {
           ...event,
           ...event.properties,
-          version: "5.58.0",
+          version: "5.60.0",
           usingAccessToken: true,
           ...getRunIdProperties()
         }
@@ -687038,7 +687189,7 @@ var UserPosthogManager = class {
       distinctId: this.userId ?? await this.getPersistedDistinctId(),
       event: "CLI",
       properties: {
-        version: "5.58.0",
+        version: "5.60.0",
         ...event,
         ...event.properties,
         usingAccessToken: false,
@@ -868133,7 +868284,7 @@ var LOCAL_STORAGE_FOLDER4 = ".fern-dev";
 var LOGS_FOLDER_NAME = "logs";
 var MAX_LOGS_DIR_SIZE_BYTES = 100 * 1024 * 1024;
 function getCliSource() {
-  const version7 = "5.58.0";
+  const version7 = "5.60.0";
   return `cli@${version7}`;
 }
 var DebugLogger = class {
@@ -894532,6 +894683,17 @@ var definitions6 = {
         ],
         description: 'Controls the "Connect to Cursor" button, which installs this docs site\'s MCP server in\nCursor via a deeplink. The button only renders on docs sites that have Ask AI enabled; set\nto `false` to hide it on those sites.\n\n@default: true'
       },
+      mcp: {
+        oneOf: [
+          {
+            type: "boolean"
+          },
+          {
+            type: "null"
+          }
+        ],
+        description: 'Controls whether the MCP server endpoint (`/_mcp/server`) is enabled for this docs site.\nWhen set to `false`, the endpoint returns 404, the MCP server URL is omitted from\n`llms.txt` and agent prompts, and the "Connect to Claude Code" / "Connect to Cursor"\nbuttons are hidden. Useful for authenticated docs sites where unauthenticated AI agents\ndiscovering the endpoint would cause confusion.\n\n@default: true'
+      },
       vscode: {
         oneOf: [
           {
@@ -900614,7 +900776,7 @@ var LegacyDocsPublisher = class {
         previewId,
         disableTemplates: void 0,
         skipUpload,
-        cliVersion: "5.58.0",
+        cliVersion: "5.60.0",
         loginCommand: "fern auth login"
       });
       if (taskContext.getResult() === TaskResult.Failure) {
@@ -964455,6 +964617,7 @@ init_lib9();
 function initializeEmptyServiceExample() {
   return {
     displayName: void 0,
+    contentType: void 0,
     request: {
       endpoint: {
         method: V2EndpointLocationHttpMethod.Post,
@@ -966883,7 +967046,7 @@ function getAutomationContextFromEnv() {
     config_branch: process.env.FERN_CONFIG_BRANCH,
     config_pr_number: process.env.FERN_CONFIG_PR_NUMBER,
     trigger: process.env.GITHUB_EVENT_NAME,
-    cli_version: "5.58.0"
+    cli_version: "5.60.0"
   };
 }
 function isAutomationMode() {
@@ -967715,7 +967878,7 @@ var CliContext = class _CliContext {
     if (false) {
       this.logger.error("CLI_VERSION is not defined");
     }
-    return "5.58.0";
+    return "5.60.0";
   }
   getCliName() {
     if (false) {

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "5.58.0",
+  "version": "5.60.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/fern-api/fern.git",