@contentful/mcp-tools 0.12.12 → 0.12.14

package/dist/index.js

@@ -392,7 +392,8 @@ var RESOURCE_DISPLAY_NAME = {
   experienceFragment: "experience fragment",
   experienceTemplate: "experience template",
   dataAssembly: "data assembly",
-  designToken: "design token"
+  designToken: "design token",
+  release: "release"
 };
 function buildConfirmationPreview(resource, id, details, confirmToken) {
   const displayName = RESOURCE_DISPLAY_NAME[resource];
@@ -6498,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(
@@ -6505,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"),
@@ -6524,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 },
@@ -6537,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
@@ -6588,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",
@@ -6596,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
     });
@@ -6891,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(
@@ -6910,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
@@ -6940,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"
   ),
@@ -6967,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
@@ -7271,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)"),
@@ -7289,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
@@ -7345,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
@@ -7654,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"
@@ -7675,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
@@ -7705,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(
@@ -7734,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",
@@ -7742,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
     });
@@ -8769,6 +8829,501 @@ function createDesignTokenTools(config) {
   };
 }
 
+// src/tools/releases/listReleases.ts
+import { z as z128 } from "zod";
+var MAX_ITEMS = 10;
+var ListReleasesToolParams = BaseToolSchema.extend({
+  limit: z128.number().optional().describe("Maximum number of releases to return (max 10)"),
+  pageNext: z128.string().optional().describe("Cursor token to fetch the next page of results"),
+  pagePrev: z128.string().optional().describe("Cursor token to fetch the previous page of results"),
+  statusIn: z128.string().optional().describe("Comma-separated list of statuses to include (active, archived)"),
+  statusNin: z128.string().optional().describe("Comma-separated list of statuses to exclude (active, archived)"),
+  titleMatch: z128.string().optional().describe("Full text phrase/term match on release title"),
+  entitiesLinkType: z128.enum(["Entry", "Asset"]).optional().describe("Filter releases by the linked entity type (Entry or Asset)"),
+  entitiesSysIdIn: z128.string().optional().describe(
+    "Comma-separated list of entity IDs the release must contain. Requires entitiesLinkType."
+  )
+});
+function listReleasesTool(config) {
+  async function tool2(args) {
+    if (args.entitiesSysIdIn && !args.entitiesLinkType) {
+      throw new Error(
+        "entitiesLinkType is required when entitiesSysIdIn is provided"
+      );
+    }
+    const contentfulClient = createToolClient(config, args);
+    const releases = await contentfulClient.release.query({
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      query: {
+        limit: Math.max(1, Math.min(args.limit ?? MAX_ITEMS, MAX_ITEMS)),
+        ...args.pageNext && { pageNext: args.pageNext },
+        ...args.pagePrev && { pagePrev: args.pagePrev },
+        ...args.statusIn && { "sys.status[in]": args.statusIn },
+        ...args.statusNin && { "sys.status[nin]": args.statusNin },
+        ...args.titleMatch && { "title[match]": args.titleMatch },
+        ...args.entitiesLinkType && {
+          "entities.sys.linkType": args.entitiesLinkType
+        },
+        ...args.entitiesSysIdIn && {
+          "entities.sys.id[in]": args.entitiesSysIdIn
+        }
+      }
+    });
+    const summarized = summarizeData(releases, {
+      maxItems: MAX_ITEMS,
+      remainingMessage: "To see more releases, ask me to retrieve the next page using the pageNext cursor."
+    });
+    return createSuccessResponse("Releases retrieved successfully", {
+      releases: summarized,
+      pages: releases.pages
+    });
+  }
+  return withErrorHandling(tool2, "Error listing releases");
+}
+
+// src/tools/releases/getRelease.ts
+import { z as z129 } from "zod";
+var GetReleaseToolParams = BaseToolSchema.extend({
+  releaseId: z129.string().describe("The ID of the release to retrieve")
+});
+function getReleaseTool(config) {
+  async function tool2(args) {
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const release = await contentfulClient.release.get(params);
+    return createSuccessResponse("Release retrieved successfully", {
+      release
+    });
+  }
+  return withErrorHandling(tool2, "Error retrieving release");
+}
+
+// src/tools/releases/createRelease.ts
+import { z as z131 } from "zod";
+
+// src/tools/releases/releaseEntities.ts
+import { z as z130 } from "zod";
+var ReleaseEntityLinkSchema = z130.object({
+  id: z130.string().describe("The ID of the Entry or Asset"),
+  linkType: z130.enum(["Entry", "Asset"]).describe("The type of entity being linked")
+});
+function createReleaseEntities(entities) {
+  return {
+    sys: { type: "Array" },
+    items: entities.map((entity) => ({
+      sys: {
+        type: "Link",
+        linkType: entity.linkType,
+        id: entity.id
+      }
+    }))
+  };
+}
+
+// src/tools/releases/createRelease.ts
+var CreateReleaseToolParams = BaseToolSchema.extend({
+  title: z131.string().describe("The title of the release"),
+  entities: z131.array(ReleaseEntityLinkSchema).describe("The Entries and/or Assets to include in the release")
+});
+function createReleaseTool(config) {
+  async function tool2(args) {
+    assertEnvironmentNotProtected(
+      args.environmentId,
+      config.protectedEnvironments
+    );
+    const contentfulClient = createToolClient(config, args);
+    const release = await contentfulClient.release.create(
+      {
+        spaceId: args.spaceId,
+        environmentId: args.environmentId
+      },
+      {
+        title: args.title,
+        entities: createReleaseEntities(args.entities)
+      }
+    );
+    return createSuccessResponse("Release created successfully", { release });
+  }
+  return withErrorHandling(tool2, "Error creating release");
+}
+
+// src/tools/releases/updateRelease.ts
+import { z as z132 } from "zod";
+var UpdateReleaseToolParams = BaseToolSchema.extend({
+  releaseId: z132.string().describe("The ID of the release to update"),
+  title: z132.string().optional().describe("The new title of the release. Omit to keep the existing title."),
+  entities: z132.array(ReleaseEntityLinkSchema).optional().describe(
+    "The full replacement list of Entries/Assets for the release. Omit to keep the existing entities."
+  )
+});
+function updateReleaseTool(config) {
+  async function tool2(args) {
+    assertEnvironmentNotProtected(
+      args.environmentId,
+      config.protectedEnvironments
+    );
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const existingRelease = await contentfulClient.release.get(params);
+    const entities = args.entities ? createReleaseEntities(args.entities) : existingRelease.entities;
+    const updatedRelease = await contentfulClient.release.update(
+      { ...params, version: existingRelease.sys.version },
+      {
+        title: args.title ?? existingRelease.title,
+        entities
+      }
+    );
+    return createSuccessResponse("Release updated successfully", {
+      release: updatedRelease
+    });
+  }
+  return withErrorHandling(tool2, "Error updating release");
+}
+
+// src/tools/releases/deleteRelease.ts
+import { z as z133 } from "zod";
+var DeleteReleaseToolParams = BaseToolSchema.extend({
+  releaseId: z133.string().describe("The ID of the release to delete"),
+  confirm: z133.boolean().optional().describe(
+    "Set to true on the second call to actually perform the deletion. Required together with confirmToken."
+  ),
+  confirmToken: z133.string().optional().describe(
+    "Token returned by the preview call; must be supplied with confirm: true."
+  )
+});
+function deleteReleaseTool(config) {
+  async function tool2(args) {
+    assertEnvironmentNotProtected(
+      args.environmentId,
+      config.protectedEnvironments
+    );
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const release = await contentfulClient.release.get(params);
+    const expectedToken = buildConfirmToken(
+      "release",
+      args.releaseId,
+      release.sys.version
+    );
+    if (args.confirm !== true || args.confirmToken !== expectedToken) {
+      const preview = buildConfirmationPreview(
+        "release",
+        args.releaseId,
+        { release },
+        expectedToken
+      );
+      return createSuccessResponse(`${CONFIRMATION_MESSAGE_PREFIX} release`, {
+        ...preview,
+        instructions: `${preview.instructions} Deleting a release also permanently deletes all ReleaseActions linked to it.`
+      });
+    }
+    await contentfulClient.release.delete(params);
+    return createSuccessResponse("Release deleted successfully", { release });
+  }
+  return withErrorHandling(tool2, "Error deleting release");
+}
+
+// src/tools/releases/publishRelease.ts
+import { z as z134 } from "zod";
+var PublishReleaseToolParams = BaseToolSchema.extend({
+  releaseId: z134.string().describe("The ID of the release to publish")
+});
+function publishReleaseTool(config) {
+  async function tool2(args) {
+    assertEnvironmentNotProtected(
+      args.environmentId,
+      config.protectedEnvironments
+    );
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const release = await contentfulClient.release.get(params);
+    const releaseAction = await contentfulClient.release.publish({
+      ...params,
+      version: release.sys.version
+    });
+    return createSuccessResponse("Release publish queued", {
+      actionId: releaseAction.sys.id,
+      status: releaseAction.sys.status,
+      releaseId: args.releaseId,
+      note: "Use get_release_action with this actionId to check whether the publish succeeded."
+    });
+  }
+  return withErrorHandling(tool2, "Error publishing release");
+}
+
+// src/tools/releases/unpublishRelease.ts
+import { z as z135 } from "zod";
+var UnpublishReleaseToolParams = BaseToolSchema.extend({
+  releaseId: z135.string().describe("The ID of the release to unpublish")
+});
+function unpublishReleaseTool(config) {
+  async function tool2(args) {
+    assertEnvironmentNotProtected(
+      args.environmentId,
+      config.protectedEnvironments
+    );
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const release = await contentfulClient.release.get(params);
+    const releaseAction = await contentfulClient.release.unpublish({
+      ...params,
+      version: release.sys.version
+    });
+    return createSuccessResponse("Release unpublish queued", {
+      actionId: releaseAction.sys.id,
+      status: releaseAction.sys.status,
+      releaseId: args.releaseId,
+      note: "Use get_release_action with this actionId to check whether the unpublish succeeded."
+    });
+  }
+  return withErrorHandling(tool2, "Error unpublishing release");
+}
+
+// src/tools/releases/validateRelease.ts
+import { z as z136 } from "zod";
+var ValidateReleaseToolParams = BaseToolSchema.extend({
+  releaseId: z136.string().describe("The ID of the release to validate"),
+  action: z136.enum(["publish", "unpublish"]).optional().describe(
+    "The downstream action to validate the release against. Omit to run a general validation."
+  )
+});
+function validateReleaseTool(config) {
+  async function tool2(args) {
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const releaseAction = await contentfulClient.release.validate(
+      params,
+      args.action ? { action: args.action } : void 0
+    );
+    return createSuccessResponse("Release validation queued", {
+      actionId: releaseAction.sys.id,
+      status: releaseAction.sys.status,
+      releaseId: args.releaseId,
+      note: "Use get_release_action with this actionId to check whether validation succeeded."
+    });
+  }
+  return withErrorHandling(tool2, "Error validating release");
+}
+
+// src/tools/releases/getReleaseAction.ts
+import { z as z137 } from "zod";
+var GetReleaseActionToolParams = BaseToolSchema.extend({
+  releaseId: z137.string().describe("The ID of the release the action belongs to"),
+  actionId: z137.string().describe("The ID of the release action to retrieve")
+});
+function getReleaseActionTool(config) {
+  async function tool2(args) {
+    const params = {
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      releaseId: args.releaseId,
+      actionId: args.actionId
+    };
+    const contentfulClient = createToolClient(config, args);
+    const releaseAction = await contentfulClient.releaseAction.get(params);
+    return createSuccessResponse("Release action retrieved successfully", {
+      releaseAction
+    });
+  }
+  return withErrorHandling(tool2, "Error retrieving release action");
+}
+
+// src/tools/releases/listReleaseActions.ts
+import { z as z138 } from "zod";
+var MAX_ITEMS2 = 10;
+var ListReleaseActionsToolParams = BaseToolSchema.extend({
+  releaseId: z138.string().optional().describe("Comma-separated list of release IDs to filter actions by"),
+  action: z138.enum(["publish", "unpublish", "validate"]).optional().describe("Filter by release action type"),
+  statusIn: z138.string().optional().describe(
+    "Comma-separated list of statuses to include (created, inProgress, succeeded, failed)"
+  ),
+  statusNin: z138.string().optional().describe(
+    "Comma-separated list of statuses to exclude (created, inProgress, succeeded, failed)"
+  ),
+  limit: z138.number().optional().describe("Maximum number of release actions to return")
+});
+function listReleaseActionsTool(config) {
+  async function tool2(args) {
+    const contentfulClient = createToolClient(config, args);
+    const releaseActions = await contentfulClient.releaseAction.getMany({
+      spaceId: args.spaceId,
+      environmentId: args.environmentId,
+      query: {
+        limit: Math.max(1, Math.min(args.limit ?? MAX_ITEMS2, MAX_ITEMS2)),
+        ...args.releaseId && { "sys.release.sys.id[in]": args.releaseId },
+        ...args.action && { action: args.action },
+        ...args.statusIn && { "sys.status[in]": args.statusIn },
+        ...args.statusNin && { "sys.status[nin]": args.statusNin }
+      }
+    });
+    const summarized = summarizeData(releaseActions, {
+      maxItems: MAX_ITEMS2,
+      remainingMessage: "To see more release actions, narrow your filters or ask for a smaller limit."
+    });
+    return createSuccessResponse("Release actions retrieved successfully", {
+      releaseActions: summarized
+    });
+  }
+  return withErrorHandling(tool2, "Error listing release actions");
+}
+
+// src/tools/releases/register.ts
+function createReleaseTools(config) {
+  const listReleases = listReleasesTool(config);
+  const getRelease = getReleaseTool(config);
+  const createRelease = createReleaseTool(config);
+  const updateRelease = updateReleaseTool(config);
+  const deleteRelease = deleteReleaseTool(config);
+  const publishRelease = publishReleaseTool(config);
+  const unpublishRelease = unpublishReleaseTool(config);
+  const validateRelease = validateReleaseTool(config);
+  const getReleaseAction = getReleaseActionTool(config);
+  const listReleaseActions = listReleaseActionsTool(config);
+  return {
+    listReleases: {
+      title: "list_releases",
+      description: "List releases in a space/environment. Returns a maximum of 10 items per request. Use pageNext/pagePrev cursors to paginate through results.",
+      inputParams: ListReleasesToolParams.shape,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      tool: listReleases
+    },
+    getRelease: {
+      title: "get_release",
+      description: "Retrieve a release",
+      inputParams: GetReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      tool: getRelease
+    },
+    createRelease: {
+      title: "create_release",
+      description: "Create a release with a title and a set of Entries/Assets to include in it.",
+      inputParams: CreateReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      },
+      tool: createRelease
+    },
+    updateRelease: {
+      title: "update_release",
+      description: "Update a release's title and/or the Entries/Assets it contains. Omitted fields keep their current value.",
+      inputParams: UpdateReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: false
+      },
+      tool: updateRelease
+    },
+    deleteRelease: {
+      title: "delete_release",
+      description: "Delete a release. This is a two-phase operation: the first call (without confirm/confirmToken) returns a preview of the release and a confirmToken. To complete the deletion, call this tool again with the same releaseId, confirm: true, and the confirmToken from the preview response. Deleting a release also permanently deletes all ReleaseActions linked to it.",
+      inputParams: DeleteReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: false,
+        openWorldHint: false
+      },
+      tool: deleteRelease
+    },
+    publishRelease: {
+      title: "publish_release",
+      description: "Publish a release. Publishing is asynchronous: this tool returns as soon as the publish is queued (status created/inProgress), not once it completes. Use get_release_action with the returned actionId to check the outcome.",
+      inputParams: PublishReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      },
+      tool: publishRelease
+    },
+    unpublishRelease: {
+      title: "unpublish_release",
+      description: "Unpublish a release. Unpublishing is asynchronous: this tool returns as soon as the unpublish is queued (status created/inProgress), not once it completes. Use get_release_action with the returned actionId to check the outcome.",
+      inputParams: UnpublishReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: false
+      },
+      tool: unpublishRelease
+    },
+    validateRelease: {
+      title: "validate_release",
+      description: "Validate a release, optionally against a specific downstream action (publish or unpublish). Validation is asynchronous: this tool returns as soon as validation is queued (status created/inProgress), not once it completes. Use get_release_action with the returned actionId to check the outcome.",
+      inputParams: ValidateReleaseToolParams.shape,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: false
+      },
+      tool: validateRelease
+    },
+    getReleaseAction: {
+      title: "get_release_action",
+      description: "Retrieve a release action by ID to check the status (created, inProgress, succeeded, failed) of a previously queued publish, unpublish, or validate operation.",
+      inputParams: GetReleaseActionToolParams.shape,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      tool: getReleaseAction
+    },
+    listReleaseActions: {
+      title: "list_release_actions",
+      description: "List release actions in a space/environment. Returns a maximum of 10 items per request. Optionally filter by release ID, action type (publish/unpublish/validate), or status.",
+      inputParams: ListReleaseActionsToolParams.shape,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        openWorldHint: false
+      },
+      tool: listReleaseActions
+    }
+  };
+}
+
 // src/ContentfulMcpTools.ts
 var ContentfulMcpTools = class {
   config;
@@ -8871,6 +9426,12 @@ var ContentfulMcpTools = class {
   getSpaceTools() {
     return createSpaceTools(this.config);
   }
+  /**
+   * Get release tools
+   */
+  getReleaseTools() {
+    return createReleaseTools(this.config);
+  }
   /**
    * Get tag tools
    */