@contentful/mcp-tools 0.12.13 → 0.12.14

package/dist/index.d.ts

@@ -4238,7 +4238,7 @@ declare class ContentfulMcpTools {
                 componentId: zod.ZodOptional<zod.ZodString>;
                 name: zod.ZodString;
                 description: zod.ZodString;
-                viewports: zod.ZodArray<zod.ZodObject<{
+                viewports: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                     id: zod.ZodString;
                     query: zod.ZodString;
                     displayName: zod.ZodString;
@@ -4253,7 +4253,7 @@ declare class ContentfulMcpTools {
                     query: string;
                     displayName: string;
                     previewSize: string;
-                }>, "many">;
+                }>, "many">>;
                 contentProperties: zod.ZodArray<zod.ZodIntersection<zod.ZodType<contentful_management.DataTypeDefinition, zod.ZodTypeDef, contentful_management.DataTypeDefinition>, zod.ZodObject<{
                     id: zod.ZodString;
                     name: zod.ZodString;
@@ -4636,12 +4636,6 @@ declare class ContentfulMcpTools {
                     id: string;
                     defaultValue?: unknown;
                 })[];
-                viewports: {
-                    id: string;
-                    query: string;
-                    displayName: string;
-                    previewSize: string;
-                }[];
                 metadata?: {
                     tags?: {
                         sys: {
@@ -4675,6 +4669,12 @@ declare class ContentfulMcpTools {
                         allowedTypes: string[];
                     }[] | undefined;
                 }[] | undefined;
+                viewports?: {
+                    id: string;
+                    query: string;
+                    displayName: string;
+                    previewSize: string;
+                }[] | undefined;
                 componentTree?: contentful_management.TreeNodeV2[] | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
@@ -5261,7 +5261,7 @@ declare class ContentfulMcpTools {
             } & {
                 name: zod.ZodString;
                 description: zod.ZodString;
-                viewports: zod.ZodArray<zod.ZodObject<{
+                viewports: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                     id: zod.ZodString;
                     query: zod.ZodString;
                     displayName: zod.ZodString;
@@ -5276,7 +5276,7 @@ declare class ContentfulMcpTools {
                     query: string;
                     displayName: string;
                     previewSize: string;
-                }>, "many">;
+                }>, "many">>;
                 contentProperties: zod.ZodArray<zod.ZodIntersection<zod.ZodType<contentful_management.DataTypeDefinition, zod.ZodTypeDef, contentful_management.DataTypeDefinition>, zod.ZodObject<{
                     id: zod.ZodString;
                     name: zod.ZodString;
@@ -5659,12 +5659,6 @@ declare class ContentfulMcpTools {
                     id: string;
                     defaultValue?: unknown;
                 })[];
-                viewports: {
-                    id: string;
-                    query: string;
-                    displayName: string;
-                    previewSize: string;
-                }[];
                 metadata?: {
                     tags?: {
                         sys: {
@@ -5697,6 +5691,12 @@ declare class ContentfulMcpTools {
                         allowedTypes: string[];
                     }[] | undefined;
                 }[] | undefined;
+                viewports?: {
+                    id: string;
+                    query: string;
+                    displayName: string;
+                    previewSize: string;
+                }[] | undefined;
                 componentTree?: contentful_management.TreeNodeV2[] | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
@@ -6310,7 +6310,7 @@ declare class ContentfulMcpTools {
                         urn: string;
                     };
                 }>;
-                viewports: zod.ZodArray<zod.ZodObject<{
+                viewports: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                     id: zod.ZodString;
                     query: zod.ZodString;
                     displayName: zod.ZodString;
@@ -6325,8 +6325,8 @@ declare class ContentfulMcpTools {
                     query: string;
                     displayName: string;
                     previewSize: string;
-                }>, "many">;
-                designProperties: zod.ZodRecord<zod.ZodString, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
+                }>, "many">>;
+                designProperties: zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodUnion<[zod.ZodObject<{
                     type: zod.ZodLiteral<"ManualDesignValue">;
                     value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
                 }, "strip", zod.ZodTypeAny, {
@@ -6344,7 +6344,25 @@ declare class ContentfulMcpTools {
                 }, {
                     value: string;
                     type: "DesignToken";
-                }>]>>>;
+                }>]>, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
+                    type: zod.ZodLiteral<"ManualDesignValue">;
+                    value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }>, zod.ZodObject<{
+                    type: zod.ZodLiteral<"DesignToken">;
+                    value: zod.ZodString;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string;
+                    type: "DesignToken";
+                }, {
+                    value: string;
+                    type: "DesignToken";
+                }>]>>]>>;
                 contentBindings: zod.ZodOptional<zod.ZodObject<{
                     sys: zod.ZodObject<{
                         type: zod.ZodLiteral<"ResourceLink">;
@@ -6523,19 +6541,19 @@ declare class ContentfulMcpTools {
                         urn: string;
                     };
                 };
-                designProperties: Record<string, Record<string, {
+                designProperties: Record<string, {
+                    value: string;
+                    type: "DesignToken";
+                } | {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                } | Record<string, {
                     value: string;
                     type: "DesignToken";
                 } | {
                     value: string | number | boolean;
                     type: "ManualDesignValue";
                 }>>;
-                viewports: {
-                    id: string;
-                    query: string;
-                    displayName: string;
-                    previewSize: string;
-                }[];
                 metadata?: {
                     name?: string | undefined;
                     tags?: {
@@ -6568,6 +6586,12 @@ declare class ContentfulMcpTools {
                         };
                     }>;
                 } | undefined;
+                viewports?: {
+                    id: string;
+                    query: string;
+                    displayName: string;
+                    previewSize: string;
+                }[] | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
         upsertExperience: {
@@ -6597,7 +6621,25 @@ declare class ContentfulMcpTools {
                     displayName: string;
                     previewSize: string;
                 }>, "many">>;
-                designProperties: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
+                designProperties: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodUnion<[zod.ZodObject<{
+                    type: zod.ZodLiteral<"ManualDesignValue">;
+                    value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }>, zod.ZodObject<{
+                    type: zod.ZodLiteral<"DesignToken">;
+                    value: zod.ZodString;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string;
+                    type: "DesignToken";
+                }, {
+                    value: string;
+                    type: "DesignToken";
+                }>]>, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
                     type: zod.ZodLiteral<"ManualDesignValue">;
                     value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
                 }, "strip", zod.ZodTypeAny, {
@@ -6615,7 +6657,7 @@ declare class ContentfulMcpTools {
                 }, {
                     value: string;
                     type: "DesignToken";
-                }>]>>>>;
+                }>]>>]>>>;
                 contentBindings: zod.ZodOptional<zod.ZodObject<{
                     sys: zod.ZodObject<{
                         type: zod.ZodLiteral<"ResourceLink">;
@@ -6806,7 +6848,13 @@ declare class ContentfulMcpTools {
                     }[] | undefined;
                 } | undefined;
                 description?: string | undefined;
-                designProperties?: Record<string, Record<string, {
+                designProperties?: Record<string, {
+                    value: string;
+                    type: "DesignToken";
+                } | {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                } | Record<string, {
                     value: string;
                     type: "DesignToken";
                 } | {
@@ -9297,7 +9345,7 @@ declare class ContentfulMcpTools {
                         urn: string;
                     };
                 }>;
-                viewports: zod.ZodArray<zod.ZodObject<{
+                viewports: zod.ZodOptional<zod.ZodArray<zod.ZodObject<{
                     id: zod.ZodString;
                     query: zod.ZodString;
                     displayName: zod.ZodString;
@@ -9312,8 +9360,8 @@ declare class ContentfulMcpTools {
                     query: string;
                     displayName: string;
                     previewSize: string;
-                }>, "many">;
-                designProperties: zod.ZodRecord<zod.ZodString, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
+                }>, "many">>;
+                designProperties: zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodUnion<[zod.ZodObject<{
                     type: zod.ZodLiteral<"ManualDesignValue">;
                     value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
                 }, "strip", zod.ZodTypeAny, {
@@ -9331,7 +9379,25 @@ declare class ContentfulMcpTools {
                 }, {
                     value: string;
                     type: "DesignToken";
-                }>]>>>;
+                }>]>, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
+                    type: zod.ZodLiteral<"ManualDesignValue">;
+                    value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }>, zod.ZodObject<{
+                    type: zod.ZodLiteral<"DesignToken">;
+                    value: zod.ZodString;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string;
+                    type: "DesignToken";
+                }, {
+                    value: string;
+                    type: "DesignToken";
+                }>]>>]>>;
                 contentBindings: zod.ZodOptional<zod.ZodObject<{
                     sys: zod.ZodObject<{
                         type: zod.ZodLiteral<"ResourceLink">;
@@ -9510,19 +9576,19 @@ declare class ContentfulMcpTools {
                         urn: string;
                     };
                 };
-                designProperties: Record<string, Record<string, {
+                designProperties: Record<string, {
+                    value: string;
+                    type: "DesignToken";
+                } | {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                } | Record<string, {
                     value: string;
                     type: "DesignToken";
                 } | {
                     value: string | number | boolean;
                     type: "ManualDesignValue";
                 }>>;
-                viewports: {
-                    id: string;
-                    query: string;
-                    displayName: string;
-                    previewSize: string;
-                }[];
                 metadata?: {
                     name?: string | undefined;
                     tags?: {
@@ -9555,6 +9621,12 @@ declare class ContentfulMcpTools {
                         };
                     }>;
                 } | undefined;
+                viewports?: {
+                    id: string;
+                    query: string;
+                    displayName: string;
+                    previewSize: string;
+                }[] | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
         updateExperienceFragment: {
@@ -9584,7 +9656,25 @@ declare class ContentfulMcpTools {
                     displayName: string;
                     previewSize: string;
                 }>, "many">>;
-                designProperties: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
+                designProperties: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodUnion<[zod.ZodObject<{
+                    type: zod.ZodLiteral<"ManualDesignValue">;
+                    value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }, {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                }>, zod.ZodObject<{
+                    type: zod.ZodLiteral<"DesignToken">;
+                    value: zod.ZodString;
+                }, "strip", zod.ZodTypeAny, {
+                    value: string;
+                    type: "DesignToken";
+                }, {
+                    value: string;
+                    type: "DesignToken";
+                }>]>, zod.ZodRecord<zod.ZodString, zod.ZodUnion<[zod.ZodObject<{
                     type: zod.ZodLiteral<"ManualDesignValue">;
                     value: zod.ZodUnion<[zod.ZodString, zod.ZodNumber, zod.ZodBoolean]>;
                 }, "strip", zod.ZodTypeAny, {
@@ -9602,7 +9692,7 @@ declare class ContentfulMcpTools {
                 }, {
                     value: string;
                     type: "DesignToken";
-                }>]>>>>;
+                }>]>>]>>>;
                 contentBindings: zod.ZodOptional<zod.ZodObject<{
                     sys: zod.ZodObject<{
                         type: zod.ZodLiteral<"ResourceLink">;
@@ -9793,7 +9883,13 @@ declare class ContentfulMcpTools {
                     }[] | undefined;
                 } | undefined;
                 description?: string | undefined;
-                designProperties?: Record<string, Record<string, {
+                designProperties?: Record<string, {
+                    value: string;
+                    type: "DesignToken";
+                } | {
+                    value: string | number | boolean;
+                    type: "ManualDesignValue";
+                } | Record<string, {
                     value: string;
                     type: "DesignToken";
                 } | {

package/dist/index.js

@@ -6499,6 +6499,14 @@ var ExperienceSlotNodeSchema = z87.lazy(
   () => z87.union([ExperienceFragmentNodeSchema, InlineExperienceFragmentNodeSchema])
 );
 
+// src/types/cmaViewportCompatibility.ts
+function asViewportOptionalCmaPayload(payload) {
+  return payload;
+}
+function asViewportOptionalCmaPayloadWithFlattenedDesignProperties(payload) {
+  return payload;
+}
+
 // src/tools/exo/components/createComponent.ts
 var CreateComponentToolParams = BaseToolSchema.extend({
   componentId: z88.string().optional().describe(
@@ -6506,7 +6514,9 @@ var CreateComponentToolParams = BaseToolSchema.extend({
   ),
   name: z88.string().describe("The name of the component"),
   description: z88.string().describe("Description of the component"),
-  viewports: z88.array(ViewportSchema).describe("Viewport definitions for the component (may be empty)"),
+  viewports: z88.array(ViewportSchema).optional().describe(
+    "Optional viewport definitions for the component. Omit for viewport-free components."
+  ),
   contentProperties: z88.array(ContentPropertySchema).describe("Content property definitions (may be empty)"),
   designProperties: z88.array(DesignPropertySchema).describe("Design property definitions (may be empty)"),
   componentTree: z88.array(TreeNodeSchema).optional().describe("Optional component tree node definitions"),
@@ -6525,7 +6535,7 @@ function createComponentTool(config) {
     const componentData = {
       name: args.name,
       description: args.description,
-      viewports: args.viewports,
+      ...args.viewports !== void 0 && { viewports: args.viewports },
       contentProperties: args.contentProperties,
       designProperties: args.designProperties,
       ...args.componentTree && { componentTree: args.componentTree },
@@ -6538,13 +6548,13 @@ function createComponentTool(config) {
         environmentId: args.environmentId,
         componentId: args.componentId
       },
-      {
+      asViewportOptionalCmaPayload({
         sys: { id: args.componentId, type: "Component" },
         ...componentData
-      }
+      })
     ) : await contentfulClient.component.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
-      componentData
+      asViewportOptionalCmaPayload(componentData)
     );
     return createSuccessResponse("Component created successfully", {
       component
@@ -6589,7 +6599,8 @@ function upsertComponentTool(config) {
         `Version conflict: the component has changed since you read it (your version: ${args.version}, current version: ${current.sys.version}). Re-fetch the component with get_component and retry the update with the latest sys.version.`
       );
     }
-    const component = await contentfulClient.component.upsert(params, {
+    const viewports = args.viewports ?? current.viewports;
+    const componentData = {
       sys: {
         id: current.sys.id,
         type: "Component",
@@ -6597,14 +6608,18 @@ function upsertComponentTool(config) {
       },
       name: args.name ?? current.name,
       description: args.description ?? current.description,
-      viewports: args.viewports ?? current.viewports,
+      ...viewports !== void 0 && { viewports },
       contentProperties: args.contentProperties ?? current.contentProperties,
       designProperties: args.designProperties ?? current.designProperties,
       ...args.componentTree ?? current.componentTree ? { componentTree: args.componentTree ?? current.componentTree } : {},
       ...args.slots ?? current.slots ? { slots: args.slots ?? current.slots } : {},
       ...args.metadata ?? current.metadata ? { metadata: args.metadata ?? current.metadata } : {},
       ...current.dataAssemblies ? { dataAssemblies: current.dataAssemblies } : {}
-    });
+    };
+    const component = await contentfulClient.component.upsert(
+      params,
+      asViewportOptionalCmaPayload(componentData)
+    );
     return createSuccessResponse("Component updated successfully", {
       component
     });
@@ -6892,8 +6907,16 @@ var CreateExperienceFragmentToolParams = BaseToolSchema.extend({
   component: ComponentResourceLinkSchema.describe(
     "Resource link to the component this experience fragment is based on"
   ),
-  viewports: z95.array(ViewportSchema).describe("Viewport definitions (may be empty)"),
-  designProperties: z95.record(z95.string(), DimensionedDesignPropertyValueSchema).describe(
+  viewports: z95.array(ViewportSchema).optional().describe(
+    "Optional viewport definitions for the experience fragment. Omit for viewport-free experience fragments."
+  ),
+  designProperties: z95.record(
+    z95.string(),
+    z95.union([
+      DesignPropertyValueSchema,
+      DimensionedDesignPropertyValueSchema
+    ])
+  ).describe(
     "Design property values keyed by property ID (may be empty object)"
   ),
   contentBindings: ExperienceContentBindingsSchema.optional().describe(
@@ -6911,18 +6934,21 @@ function createExperienceFragmentTool(config) {
       config.protectedEnvironments
     );
     const contentfulClient = createExoToolClient(config, args);
+    const experienceFragmentData = {
+      name: args.name,
+      description: args.description,
+      component: args.component,
+      ...args.viewports !== void 0 && { viewports: args.viewports },
+      designProperties: args.designProperties,
+      ...args.contentBindings && { contentBindings: args.contentBindings },
+      ...args.slots && { slots: args.slots },
+      ...args.metadata && { metadata: args.metadata }
+    };
     const experienceFragment = await contentfulClient.experienceFragment.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
-      {
-        name: args.name,
-        description: args.description,
-        component: args.component,
-        viewports: args.viewports,
-        designProperties: args.designProperties,
-        ...args.contentBindings && { contentBindings: args.contentBindings },
-        ...args.slots && { slots: args.slots },
-        ...args.metadata && { metadata: args.metadata }
-      }
+      asViewportOptionalCmaPayloadWithFlattenedDesignProperties(
+        experienceFragmentData
+      )
     );
     return createSuccessResponse("Experience fragment created successfully", {
       experienceFragment
@@ -6941,7 +6967,13 @@ var UpdateExperienceFragmentToolParams = BaseToolSchema.extend({
   name: z96.string().optional().describe("The name of the experience fragment"),
   description: z96.string().optional().describe("Description of the experience fragment"),
   viewports: z96.array(ViewportSchema).optional().describe("Viewport definitions; replaces existing viewports if provided"),
-  designProperties: z96.record(z96.string(), DimensionedDesignPropertyValueSchema).optional().describe("Design property values; replaces existing if provided"),
+  designProperties: z96.record(
+    z96.string(),
+    z96.union([
+      DesignPropertyValueSchema,
+      DimensionedDesignPropertyValueSchema
+    ])
+  ).optional().describe("Design property values; replaces existing if provided"),
   contentBindings: ExperienceContentBindingsSchema.optional().describe(
     "Content bindings; replaces existing if provided"
   ),
@@ -6968,22 +7000,26 @@ function updateExperienceFragmentTool(config) {
         `Version conflict: the experience fragment has changed since you read it (your version: ${args.version}, current version: ${current.sys.version}). Re-fetch the experience fragment with get_experience_fragment and retry the update with the latest sys.version.`
       );
     }
+    const viewports = args.viewports ?? current.viewports;
+    const experienceFragmentData = {
+      sys: {
+        id: current.sys.id,
+        type: "ExperienceFragment",
+        version: current.sys.version
+      },
+      name: args.name ?? current.name,
+      description: args.description ?? current.description,
+      ...viewports !== void 0 && { viewports },
+      designProperties: args.designProperties ?? current.designProperties,
+      ...args.contentBindings ?? current.contentBindings ? { contentBindings: args.contentBindings ?? current.contentBindings } : {},
+      ...args.slots ?? current.slots ? { slots: args.slots ?? current.slots } : {},
+      ...args.metadata ?? current.metadata ? { metadata: args.metadata ?? current.metadata } : {}
+    };
     const experienceFragment = await contentfulClient.experienceFragment.upsert(
       params,
-      {
-        sys: {
-          id: current.sys.id,
-          type: "ExperienceFragment",
-          version: current.sys.version
-        },
-        name: args.name ?? current.name,
-        description: args.description ?? current.description,
-        viewports: args.viewports ?? current.viewports,
-        designProperties: args.designProperties ?? current.designProperties,
-        ...args.contentBindings ?? current.contentBindings ? { contentBindings: args.contentBindings ?? current.contentBindings } : {},
-        ...args.slots ?? current.slots ? { slots: args.slots ?? current.slots } : {},
-        ...args.metadata ?? current.metadata ? { metadata: args.metadata ?? current.metadata } : {}
-      }
+      asViewportOptionalCmaPayloadWithFlattenedDesignProperties(
+        experienceFragmentData
+      )
     );
     return createSuccessResponse("Experience fragment updated successfully", {
       experienceFragment
@@ -7272,8 +7308,8 @@ import { z as z102 } from "zod";
 var CreateExperienceTemplateToolParams = BaseToolSchema.extend({
   name: z102.string().describe("The name of the experience template"),
   description: z102.string().describe("Description of the experience template"),
-  viewports: z102.array(ViewportSchema).describe(
-    "Viewport definitions for the experience template (may be empty)"
+  viewports: z102.array(ViewportSchema).optional().describe(
+    "Optional viewport definitions for the experience template. Omit for viewport-free experience templates."
   ),
   contentProperties: z102.array(ContentPropertySchema).describe("Content property definitions (may be empty)"),
   designProperties: z102.array(DesignPropertySchema).describe("Design property definitions (may be empty)"),
@@ -7290,18 +7326,19 @@ function createExperienceTemplateTool(config) {
       config.protectedEnvironments
     );
     const contentfulClient = createExoToolClient(config, args);
+    const experienceTemplateData = {
+      name: args.name,
+      description: args.description,
+      ...args.viewports !== void 0 && { viewports: args.viewports },
+      contentProperties: args.contentProperties,
+      designProperties: args.designProperties,
+      ...args.componentTree && { componentTree: args.componentTree },
+      ...args.slots && { slots: args.slots },
+      ...args.metadata && { metadata: args.metadata }
+    };
     const experienceTemplate = await contentfulClient.experienceTemplate.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
-      {
-        name: args.name,
-        description: args.description,
-        viewports: args.viewports,
-        contentProperties: args.contentProperties,
-        designProperties: args.designProperties,
-        ...args.componentTree && { componentTree: args.componentTree },
-        ...args.slots && { slots: args.slots },
-        ...args.metadata && { metadata: args.metadata }
-      }
+      asViewportOptionalCmaPayload(experienceTemplateData)
     );
     return createSuccessResponse("Experience template created successfully", {
       experienceTemplate
@@ -7346,24 +7383,26 @@ function upsertExperienceTemplateTool(config) {
         `Version conflict: the experience template has changed since you read it (your version: ${args.version}, current version: ${current.sys.version}). Re-fetch the experience template with get_experience_template and retry the update with the latest sys.version.`
       );
     }
+    const viewports = args.viewports ?? current.viewports;
+    const experienceTemplateData = {
+      sys: {
+        id: current.sys.id,
+        type: "ExperienceTemplate",
+        version: current.sys.version
+      },
+      name: args.name ?? current.name,
+      description: args.description ?? current.description,
+      ...viewports !== void 0 && { viewports },
+      contentProperties: args.contentProperties ?? current.contentProperties,
+      designProperties: args.designProperties ?? current.designProperties,
+      ...args.componentTree ?? current.componentTree ? { componentTree: args.componentTree ?? current.componentTree } : {},
+      ...args.slots ?? current.slots ? { slots: args.slots ?? current.slots } : {},
+      ...args.metadata ?? current.metadata ? { metadata: args.metadata ?? current.metadata } : {},
+      ...current.dataAssemblies ? { dataAssemblies: current.dataAssemblies } : {}
+    };
     const experienceTemplate = await contentfulClient.experienceTemplate.upsert(
       params,
-      {
-        sys: {
-          id: current.sys.id,
-          type: "ExperienceTemplate",
-          version: current.sys.version
-        },
-        name: args.name ?? current.name,
-        description: args.description ?? current.description,
-        viewports: args.viewports ?? current.viewports,
-        contentProperties: args.contentProperties ?? current.contentProperties,
-        designProperties: args.designProperties ?? current.designProperties,
-        ...args.componentTree ?? current.componentTree ? { componentTree: args.componentTree ?? current.componentTree } : {},
-        ...args.slots ?? current.slots ? { slots: args.slots ?? current.slots } : {},
-        ...args.metadata ?? current.metadata ? { metadata: args.metadata ?? current.metadata } : {},
-        ...current.dataAssemblies ? { dataAssemblies: current.dataAssemblies } : {}
-      }
+      asViewportOptionalCmaPayload(experienceTemplateData)
     );
     return createSuccessResponse("Experience template updated successfully", {
       experienceTemplate
@@ -7655,9 +7694,17 @@ var CreateExperienceToolParams = BaseToolSchema.extend({
   experienceTemplate: ExperienceTemplateResourceLinkSchema.describe(
     "Resource link to the ExperienceTemplate this experience is backed by"
   ),
-  viewports: z109.array(ViewportSchema).describe("Viewport definitions for the experience (may be empty)"),
-  designProperties: z109.record(z109.string(), DimensionedDesignPropertyValueSchema).describe(
-    "Design property values keyed by property ID. Each value is a dimensioned map (viewport ID \u2192 design value). May be an empty object."
+  viewports: z109.array(ViewportSchema).optional().describe(
+    "Optional viewport definitions for the experience. Omit for viewport-free experiences."
+  ),
+  designProperties: z109.record(
+    z109.string(),
+    z109.union([
+      DesignPropertyValueSchema,
+      DimensionedDesignPropertyValueSchema
+    ])
+  ).describe(
+    "Design property values keyed by property ID. When viewports are provided, each value is a dimensioned map (viewport ID \u2192 design value); without viewports, use a direct design value. May be an empty object."
   ),
   contentBindings: ExperienceContentBindingsSchema.optional().describe(
     "Optional content bindings linking this experience to a data assembly"
@@ -7676,18 +7723,19 @@ function createExperienceTool(config) {
       config.protectedEnvironments
     );
     const contentfulClient = createExoToolClient(config, args);
+    const experienceData = {
+      name: args.name,
+      description: args.description,
+      experienceTemplate: args.experienceTemplate,
+      ...args.viewports !== void 0 && { viewports: args.viewports },
+      designProperties: args.designProperties,
+      ...args.contentBindings && { contentBindings: args.contentBindings },
+      ...args.slots && { slots: args.slots },
+      ...args.metadata && { metadata: args.metadata }
+    };
     const experience = await contentfulClient.experience.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
-      {
-        name: args.name,
-        description: args.description,
-        experienceTemplate: args.experienceTemplate,
-        viewports: args.viewports,
-        designProperties: args.designProperties,
-        ...args.contentBindings && { contentBindings: args.contentBindings },
-        ...args.slots && { slots: args.slots },
-        ...args.metadata && { metadata: args.metadata }
-      }
+      asViewportOptionalCmaPayloadWithFlattenedDesignProperties(experienceData)
     );
     return createSuccessResponse("Experience created successfully", {
       experience
@@ -7706,7 +7754,13 @@ var UpsertExperienceToolParams = BaseToolSchema.extend({
   name: z110.string().optional().describe("The name of the experience"),
   description: z110.string().optional().describe("Description of the experience"),
   viewports: z110.array(ViewportSchema).optional().describe("Viewport definitions; replaces existing viewports if provided"),
-  designProperties: z110.record(z110.string(), DimensionedDesignPropertyValueSchema).optional().describe(
+  designProperties: z110.record(
+    z110.string(),
+    z110.union([
+      DesignPropertyValueSchema,
+      DimensionedDesignPropertyValueSchema
+    ])
+  ).optional().describe(
     "Design property values keyed by property ID; replaces existing if provided"
   ),
   contentBindings: ExperienceContentBindingsSchema.optional().describe(
@@ -7735,7 +7789,8 @@ function upsertExperienceTool(config) {
         `Version conflict: the experience has changed since you read it (your version: ${args.version}, current version: ${current.sys.version}). Re-fetch the experience with get_experience and retry the update with the latest sys.version.`
       );
     }
-    const experience = await contentfulClient.experience.upsert(params, {
+    const viewports = args.viewports ?? current.viewports;
+    const experienceData = {
       sys: {
         id: current.sys.id,
         type: "Experience",
@@ -7743,12 +7798,16 @@ function upsertExperienceTool(config) {
       },
       name: args.name ?? current.name,
       description: args.description ?? current.description,
-      viewports: args.viewports ?? current.viewports,
+      ...viewports !== void 0 && { viewports },
       designProperties: args.designProperties ?? current.designProperties,
       ...args.contentBindings ?? current.contentBindings ? { contentBindings: args.contentBindings ?? current.contentBindings } : {},
       ...args.slots ?? current.slots ? { slots: args.slots ?? current.slots } : {},
       ...args.metadata ?? current.metadata ? { metadata: args.metadata ?? current.metadata } : {}
-    });
+    };
+    const experience = await contentfulClient.experience.upsert(
+      params,
+      asViewportOptionalCmaPayloadWithFlattenedDesignProperties(experienceData)
+    );
     return createSuccessResponse("Experience updated successfully", {
       experience
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-tools",
-  "version": "0.12.13",
+  "version": "0.12.14",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",