@kontent-ai/mcp-server 0.23.3 → 0.25.0

package/README.md

@@ -63,7 +63,7 @@ npx @kontent-ai/mcp-server@latest shttp
 
 ### Patch Operations Guide
 
-* **get-patch-guide** – 🚨 **REQUIRED before any patch operation**. Get JSON Patch operations guide for Kontent.ai Management API
+* **get-patch-guide** – 🚨 **REQUIRED before any patch operation**. Get patch operations guide for Kontent.ai Management API by entity type
 
 ### Content Type Management
 
@@ -78,17 +78,20 @@ npx @kontent-ai/mcp-server@latest shttp
 * **get-type-snippet-mapi** – Get Kontent.ai content type snippet by internal ID from Management API
 * **list-content-type-snippets-mapi** – Get all Kontent.ai content type snippets from Management API
 * **add-content-type-snippet-mapi** – Add new Kontent.ai content type snippet via Management API
+* **patch-type-snippet-mapi** – Update an existing Kontent.ai content type snippet by internal ID using patch operations (move, addInto, remove, replace)
+* **delete-type-snippet-mapi** – Delete a Kontent.ai content type snippet by codename
 
 ### Taxonomy Management
 
 * **get-taxonomy-group-mapi** – Get Kontent.ai taxonomy group by internal ID from Management API
 * **list-taxonomy-groups-mapi** – Get all Kontent.ai taxonomy groups from Management API
 * **add-taxonomy-group-mapi** – Add new Kontent.ai taxonomy group via Management API
+* **patch-taxonomy-group-mapi** – Update Kontent.ai taxonomy group using patch operations (addInto, move, remove, replace) via Management API
+* **delete-taxonomy-group-mapi** – Delete Kontent.ai taxonomy group by internal ID
 
 ### Content Item Management
 
 * **get-item-mapi** – Get Kontent.ai item by internal ID from Management API
-* **get-item-dapi** – Get Kontent.ai item by codename from Delivery API
 * **get-latest-variant-mapi** – Get latest version of Kontent.ai language variant from Management API
 * **get-published-variant-mapi** – Get published version of Kontent.ai language variant from Management API
 * **list-variants-item-mapi** – List all Kontent.ai language variants of a content item from Management API
@@ -109,6 +112,12 @@ npx @kontent-ai/mcp-server@latest shttp
 
 * **get-asset-mapi** – Get a specific Kontent.ai asset by internal ID from Management API
 * **list-assets-mapi** – Get all Kontent.ai assets from Management API
+* **update-asset-mapi** – Update Kontent.ai asset by internal ID
+
+### Asset Folder Management
+
+* **list-asset-folders-mapi** – List all Kontent.ai asset folders
+* **patch-asset-folders-mapi** – Modify Kontent.ai asset folders using patch operations (addInto to add new folders, rename to change names, remove to delete folders)
 
 ### Language Management
 
@@ -124,10 +133,20 @@ npx @kontent-ai/mcp-server@latest shttp
 ### Space Management
 
 * **list-spaces-mapi** – Get all Kontent.ai spaces from Management API
+* **add-space-mapi** – Add Kontent.ai space to environment
+* **patch-space-mapi** – Patch Kontent.ai space using replace operations
+* **delete-space-mapi** – Delete Kontent.ai space
+
+### Role Management
+
+* **list-roles-mapi** – Get all Kontent.ai roles from Management API. Requires Enterprise or Flex plan with "Manage custom roles" permission
 
 ### Workflow Management
 
 * **list-workflows-mapi** – Get all Kontent.ai workflows from Management API. Workflows define the content lifecycle stages and transitions between them
+* **add-workflow-mapi** – Create a new Kontent.ai workflow via Management API. Define custom workflow steps, transitions, scopes (content types and collections), and role permissions
+* **update-workflow-mapi** – Update an existing Kontent.ai workflow by ID via Management API. Modify steps, transitions, scopes, and role permissions. Cannot remove steps that are in use
+* **delete-workflow-mapi** – Delete a Kontent.ai workflow by ID via Management API. The workflow must not be in use by any content items
 * **change-variant-workflow-step-mapi** – Change the workflow step of a language variant in Kontent.ai. This operation moves a language variant to a different step in the workflow, enabling content lifecycle management such as moving content from draft to review, review to published, etc.
 * **publish-variant-mapi** – Publish or schedule a language variant of a content item in Kontent.ai. This operation can either immediately publish the variant or schedule it for publication at a specific future date and time with optional timezone specification
 * **unpublish-variant-mapi** – Unpublish or schedule unpublishing of a language variant of a content item in Kontent.ai. This operation can either immediately unpublish the variant (making it unavailable through the Delivery API) or schedule it for unpublishing at a specific future date and time with optional timezone specification

package/build/bin.js

@@ -152,7 +152,7 @@ Available endpoints:
 async function startStdio() {
     const { server } = createServer();
     const transport = new StdioServerTransport();
-    console.log(`Kontent.ai MCP Server v${version} (stdio) starting`);
+    console.error(`Kontent.ai MCP Server v${version} (stdio) starting`);
     await server.connect(transport);
 }
 async function main() {

package/build/schemas/assetFolderSchemas.js

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
+const assetFolderValueSchema = z.object({
+    name: z.string(),
+    codename: z.string().optional(),
+    external_id: z.string().optional(),
+    folders: z.lazy(() => z.array(assetFolderValueSchema)).optional(),
+});
+const addIntoBaseSchema = {
+    op: z.literal("addInto"),
+    reference: referenceObjectSchema
+        .optional()
+        .describe("Parent folder reference. Omit to add at root level."),
+    value: assetFolderValueSchema,
+};
+const addIntoBeforeOperationSchema = z.object({
+    ...addIntoBaseSchema,
+    before: referenceObjectSchema,
+});
+const addIntoAfterOperationSchema = z.object({
+    ...addIntoBaseSchema,
+    after: referenceObjectSchema,
+});
+const addIntoDefaultOperationSchema = z.object(addIntoBaseSchema);
+const renameOperationSchema = z.object({
+    op: z.literal("rename"),
+    reference: referenceObjectSchema,
+    value: z.string(),
+});
+const removeOperationSchema = z.object({
+    op: z.literal("remove"),
+    reference: referenceObjectSchema,
+});
+const assetFolderPatchOperationSchema = z.union([
+    addIntoBeforeOperationSchema,
+    addIntoAfterOperationSchema,
+    addIntoDefaultOperationSchema,
+    renameOperationSchema,
+    removeOperationSchema,
+]);
+export const assetFolderPatchOperationsSchema = z
+    .array(assetFolderPatchOperationSchema)
+    .min(1)
+    .describe("Patch operations array. Use addInto to add new folders (with optional reference for parent, before/after for positioning), rename to change folder names, remove to delete folders.");

package/build/schemas/assetSchemas.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
+const assetDescriptionSchema = z.object({
+    language: referenceObjectSchema,
+    description: z.string(),
+});
+const assetTaxonomyElementSchema = z.object({
+    element: referenceObjectSchema,
+    value: z.array(referenceObjectSchema),
+});
+const assetCollectionReferenceSchema = z.object({
+    reference: referenceObjectSchema,
+});
+export const updateAssetDataSchema = z
+    .object({
+    title: z.string().optional(),
+    codename: z.string().optional(),
+    collection: assetCollectionReferenceSchema.optional(),
+    folder: referenceObjectSchema.optional(),
+    descriptions: z.array(assetDescriptionSchema).optional(),
+    elements: z.array(assetTaxonomyElementSchema).optional(),
+})
+    .describe("Only include properties you want to update; omitted fields retain existing values.");

package/build/schemas/{contentTypeSchemas.js → contentTypeAndSnippetSchemas.js}

@@ -1,9 +1,5 @@
 import { z } from "zod";
-// Reference by id or codename (id preferred)
-export const referenceObjectSchema = z.object({
-    id: z.string().optional(),
-    codename: z.string().optional(),
-});
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
 // Common property schemas
 const baseElementSchema = {
     codename: z.string().optional(),
@@ -16,7 +12,10 @@ const contentGroupElementSchema = {
 const namedElementSchema = {
     ...baseElementSchema,
     name: z.string(),
-    guidelines: z.string().optional(),
+    guidelines: z
+        .string()
+        .optional()
+        .describe("Plain text guidelines shown to editors"),
     is_required: z.boolean().optional(),
     is_non_localizable: z.boolean().optional(),
 };
@@ -93,7 +92,7 @@ const assetElementSchema = {
 const customElementSchema = {
     type: z.literal("custom"),
     ...namedElementSchema,
-    source_url: z.string(),
+    source_url: z.url(),
     json_parameters: z.string().optional(),
     allowed_elements: z.array(referenceObjectSchema).optional(),
 };
@@ -105,7 +104,9 @@ const dateTimeElementSchema = {
 const guidelinesElementSchema = {
     type: z.literal("guidelines"),
     ...baseElementSchema,
-    guidelines: z.string(),
+    guidelines: z
+        .string()
+        .describe("HTML content for guidelines element. Must be valid HTML."),
 };
 const modularContentElementSchema = {
     type: z.literal("modular_content"),
@@ -292,14 +293,12 @@ export const contentGroupSchema = z.object({
     external_id: z.string().optional(),
     codename: z.string().optional(),
 });
-// Define a union type for snippet elements (excluding url_slug and snippet elements)
 export const snippetElementSchema = z.discriminatedUnion("type", [
     z.object(assetElementSchema),
     z.object(customElementSchema),
     z.object(dateTimeElementSchema),
     z.object(guidelinesElementSchema),
     z.object(modularContentElementSchema),
-    z.object(subpagesElementSchema),
     z.object(multipleChoiceElementSchema),
     z.object(numberElementSchema),
     z.object(richTextElementSchema),

package/build/schemas/patchSchemas/baseTypeAndSnippetPatchSchemas.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+import { allowedBlockSchema, allowedFormattingSchema, allowedTableBlockSchema, allowedTableFormattingSchema, allowedTableTextBlockSchema, allowedTextBlockSchema, arrayDefaultSchema, countLimitSchema, numberDefaultSchema, optionSchema, regexValidationSchema, stringDefaultSchema, textLengthLimitSchema, } from "../contentTypeAndSnippetSchemas.js";
+import { referenceObjectSchema } from "../referenceObjectSchema.js";
+export const moveOperationSchema = z.object({
+    op: z.literal("move"),
+    path: z.string().describe("Path to object (format: id:{uuid})"),
+    before: referenceObjectSchema.optional(),
+    after: referenceObjectSchema.optional(),
+});
+export const removeOperationSchema = z.object({
+    op: z.literal("remove"),
+    path: z.string().describe("Path to item to remove (format: id:{uuid})"),
+});
+export const sharedAddIntoValueSchemas = [
+    optionSchema,
+    referenceObjectSchema,
+    allowedBlockSchema,
+    allowedFormattingSchema,
+    allowedTextBlockSchema,
+    allowedTableBlockSchema,
+    allowedTableFormattingSchema,
+    allowedTableTextBlockSchema,
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.any(),
+];
+export const sharedReplaceValueSchemas = [
+    regexValidationSchema,
+    textLengthLimitSchema,
+    countLimitSchema,
+    arrayDefaultSchema,
+    stringDefaultSchema,
+    numberDefaultSchema,
+    z.string(),
+    z.number(),
+    z.boolean(),
+    z.null(),
+    z.any(),
+];

package/build/schemas/patchSchemas/contentTypePatchSchemas.js

@@ -1,66 +1,24 @@
-// Patch operation schemas for content type modifications
-// Based on: https://kontent.ai/learn/docs/apis/openapi/management-api-v2/#operation/modify-a-content-type
 import { z } from "zod";
-import { allowedBlockSchema, allowedFormattingSchema, allowedTableBlockSchema, allowedTableFormattingSchema, allowedTableTextBlockSchema, allowedTextBlockSchema, arrayDefaultSchema, contentGroupSchema, countLimitSchema, dependsOnSchema, elementSchema, numberDefaultSchema, optionSchema, referenceObjectSchema, regexValidationSchema, stringDefaultSchema, textLengthLimitSchema, } from "../contentTypeSchemas.js";
-// Move operation - Move elements within content type
-const moveOperationSchema = z.object({
-    op: z.literal("move"),
-    path: z.string().describe("Path to object (format: id:{uuid})"),
-    before: referenceObjectSchema.optional(),
-    after: referenceObjectSchema.optional(),
-});
-// AddInto operation - Add new elements to content type
+import { contentGroupSchema, dependsOnSchema, elementSchema, } from "../contentTypeAndSnippetSchemas.js";
+import { moveOperationSchema, removeOperationSchema, sharedAddIntoValueSchemas, sharedReplaceValueSchemas, } from "./baseTypeAndSnippetPatchSchemas.js";
 const addIntoOperationSchema = z.object({
     op: z.literal("addInto"),
     path: z.string().describe("Path where to add item (format: id:{uuid})"),
     value: z.union([
         elementSchema,
-        optionSchema,
         contentGroupSchema,
-        referenceObjectSchema,
-        allowedBlockSchema,
-        allowedFormattingSchema,
-        allowedTextBlockSchema,
-        allowedTableBlockSchema,
-        allowedTableFormattingSchema,
-        allowedTableTextBlockSchema,
-        z.string(),
-        z.number(),
-        z.boolean(),
-        z.null(),
-        z.any(),
+        ...sharedAddIntoValueSchemas,
     ]),
 });
-// Remove operation - Remove elements from content type
-const removeOperationSchema = z.object({
-    op: z.literal("remove"),
-    path: z.string().describe("Path to item to remove (format: id:{uuid})"),
-});
-// Replace operation - Replace/update existing elements in content type
 const replaceOperationSchema = z.object({
     op: z.literal("replace"),
     path: z.string().describe("Path to property to replace (format: id:{uuid})"),
-    value: z.union([
-        dependsOnSchema,
-        regexValidationSchema,
-        textLengthLimitSchema,
-        countLimitSchema,
-        arrayDefaultSchema,
-        stringDefaultSchema,
-        numberDefaultSchema,
-        z.string(),
-        z.number(),
-        z.boolean(),
-        z.null(),
-        z.any(),
-    ]),
+    value: z.union([dependsOnSchema, ...sharedReplaceValueSchemas]),
 });
-// Union type for all patch operations
 export const patchOperationSchema = z.discriminatedUnion("op", [
     moveOperationSchema,
     addIntoOperationSchema,
     removeOperationSchema,
     replaceOperationSchema,
 ]);
-// Schema for array of patch operations
 export const patchOperationsSchema = z.array(patchOperationSchema).min(1);

package/build/schemas/patchSchemas/snippetPatchSchemas.js

@@ -0,0 +1,22 @@
+import { z } from "zod";
+import { snippetElementSchema } from "../contentTypeAndSnippetSchemas.js";
+import { moveOperationSchema, removeOperationSchema, sharedAddIntoValueSchemas, sharedReplaceValueSchemas, } from "./baseTypeAndSnippetPatchSchemas.js";
+const addIntoOperationSchema = z.object({
+    op: z.literal("addInto"),
+    path: z.string().describe("Path where to add item (format: id:{uuid})"),
+    value: z.union([snippetElementSchema, ...sharedAddIntoValueSchemas]),
+});
+const replaceOperationSchema = z.object({
+    op: z.literal("replace"),
+    path: z.string().describe("Path to property to replace (format: id:{uuid})"),
+    value: z.union(sharedReplaceValueSchemas),
+});
+export const snippetPatchOperationSchema = z.discriminatedUnion("op", [
+    moveOperationSchema,
+    addIntoOperationSchema,
+    removeOperationSchema,
+    replaceOperationSchema,
+]);
+export const snippetPatchOperationsSchema = z
+    .array(snippetPatchOperationSchema)
+    .min(1);

package/build/schemas/patchSchemas/taxonomyPatchSchemas.js

@@ -0,0 +1,67 @@
+import { z } from "zod";
+import { referenceObjectSchema } from "../referenceObjectSchema.js";
+const taxonomyTermValueSchema = z.object({
+    name: z.string(),
+    codename: z.string().optional(),
+    external_id: z.string().optional(),
+    terms: z.lazy(() => z.array(taxonomyTermValueSchema)).optional(),
+});
+const addIntoBaseSchema = {
+    op: z.literal("addInto"),
+    reference: referenceObjectSchema
+        .optional()
+        .describe("Parent term reference. Omit to add at root level of taxonomy group."),
+    value: taxonomyTermValueSchema,
+};
+const addIntoBeforeOperationSchema = z.object({
+    ...addIntoBaseSchema,
+    before: referenceObjectSchema,
+});
+const addIntoAfterOperationSchema = z.object({
+    ...addIntoBaseSchema,
+    after: referenceObjectSchema,
+});
+const addIntoDefaultOperationSchema = z.object(addIntoBaseSchema);
+const moveBaseSchema = {
+    op: z.literal("move"),
+    reference: referenceObjectSchema,
+};
+const moveBeforeOperationSchema = z.object({
+    ...moveBaseSchema,
+    before: referenceObjectSchema,
+});
+const moveAfterOperationSchema = z.object({
+    ...moveBaseSchema,
+    after: referenceObjectSchema,
+});
+const moveUnderOperationSchema = z.object({
+    ...moveBaseSchema,
+    under: referenceObjectSchema.describe("Move as child of this term (tree nesting)"),
+});
+const removeOperationSchema = z.object({
+    op: z.literal("remove"),
+    reference: referenceObjectSchema,
+});
+const replaceOperationSchema = z.object({
+    op: z.literal("replace"),
+    reference: referenceObjectSchema
+        .optional()
+        .describe("Term reference. Omit when modifying group-level properties (name, codename). Required when modifying specific term."),
+    property_name: z.enum(["name", "codename", "terms"]),
+    value: z
+        .union([z.string(), z.array(taxonomyTermValueSchema)])
+        .describe("New value. String for name/codename, array for terms."),
+});
+export const taxonomyPatchOperationSchema = z.union([
+    addIntoBeforeOperationSchema,
+    addIntoAfterOperationSchema,
+    addIntoDefaultOperationSchema,
+    moveBeforeOperationSchema,
+    moveAfterOperationSchema,
+    moveUnderOperationSchema,
+    removeOperationSchema,
+    replaceOperationSchema,
+]);
+export const taxonomyPatchOperationsSchema = z
+    .array(taxonomyPatchOperationSchema)
+    .min(1);

package/build/schemas/searchOperationSchemas.js

@@ -3,9 +3,9 @@ export const searchOperationSchema = z.object({
     searchPhrase: z
         .string()
         .describe("Search phrase for AI-powered semantic search. Uses vector database to find content by meaning and similarity, not just exact keyword matching"),
-    filter: z
-        .object({
-        variantId: z.guid().describe("UUID of the language variant to filter by"),
-    })
-        .describe("Mandatory content item variant filter to restrict search scope. Must specify a valid variant UUID"),
+    filter: z.object({
+        variantId: z
+            .guid()
+            .describe("Language ID from list-languages-mapi. Use default language (is_default=true) if not specified by user."),
+    }),
 });

package/build/schemas/spaceSchemas.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
+const nameReplaceOperationSchema = z.object({
+    op: z.literal("replace"),
+    property_name: z.literal("name"),
+    value: z.string(),
+});
+const codenameReplaceOperationSchema = z.object({
+    op: z.literal("replace"),
+    property_name: z.literal("codename"),
+    value: z.string(),
+});
+const collectionsReplaceOperationSchema = z.object({
+    op: z.literal("replace"),
+    property_name: z.literal("collections"),
+    value: z.array(referenceObjectSchema),
+});
+export const spacePatchOperationSchema = z.discriminatedUnion("property_name", [
+    nameReplaceOperationSchema,
+    codenameReplaceOperationSchema,
+    collectionsReplaceOperationSchema,
+]);
+export const spacePatchOperationsSchema = z
+    .array(spacePatchOperationSchema)
+    .min(1);
+export const addSpaceSchema = z.object({
+    name: z.string(),
+    codename: z.string().optional(),
+    collections: z.array(referenceObjectSchema).optional(),
+});

package/build/schemas/workflowSchemas.js

@@ -1,98 +1,96 @@
 import { z } from "zod";
-// Schema for a workflow step
-const workflowStepSchema = z.object({
-    id: z
-        .guid()
-        .describe("The unique identifier of the workflow step in UUID format"),
-    name: z.string().describe("The human-readable name of the workflow step"),
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
+// Step color options (matching SDK WorkflowColor type)
+const workflowStepColorSchema = z
+    .enum([
+    "gray",
+    "red",
+    "rose",
+    "light-purple",
+    "dark-purple",
+    "dark-blue",
+    "light-blue",
+    "sky-blue",
+    "mint-green",
+    "persian-green",
+    "dark-green",
+    "light-green",
+    "yellow",
+    "pink",
+    "orange",
+    "brown",
+])
+    .describe("Color of the workflow step displayed in the UI");
+// Transition reference schema (step codename reference)
+const transitionToStepSchema = z.object({
+    codename: z.string().optional().describe("Target step codename"),
+    id: z.guid().optional().describe("Target step ID (for update operations)"),
+});
+const transitionToSchema = z.object({
+    step: transitionToStepSchema.describe("Reference to the target step"),
+});
+// Workflow step input schema (for creating/updating workflows)
+const workflowStepInputSchema = z.object({
+    name: z.string().describe("Human-readable name of the workflow step"),
     codename: z
         .string()
-        .describe("The codename of the workflow step used for API operations"),
+        .describe("Codename of the workflow step. Must be unique across all workflows - usually prepended with the workflow codename."),
+    id: z
+        .guid()
+        .optional()
+        .readonly()
+        .describe("Read-only workflow step ID (useful to reference a step when updating its codename)"),
+    color: workflowStepColorSchema,
     transitions_to: z
-        .array(z.guid())
-        .describe("Array of workflow step IDs that this step can transition to")
-        .optional(),
+        .array(transitionToSchema)
+        .min(1)
+        .describe("Array of step references this step can transition to."),
     role_ids: z
         .array(z.guid())
-        .describe("Array of role IDs that have permissions for this workflow step")
-        .optional(),
+        .min(1)
+        .describe("Array of role IDs that have permissions for this step."),
 });
-// Schema for the published step
-const publishedStepSchema = z.object({
-    id: z
-        .guid()
-        .describe("The unique identifier of the published step in UUID format"),
-    name: z
-        .string()
-        .describe("The name of the published step - typically 'Published'"),
-    codename: z
-        .string()
-        .describe("The codename of the published step - typically 'published'"),
+// Published step input schema
+const publishedStepInputSchema = z.object({
     unpublish_role_ids: z
         .array(z.guid())
-        .describe("Array of role IDs that can unpublish content from this step")
-        .optional(),
+        .min(1)
+        .describe("Array of role IDs that can unpublish content."),
     create_new_version_role_ids: z
         .array(z.guid())
-        .describe("Array of role IDs that can create new versions of content in this step")
-        .optional(),
+        .min(1)
+        .describe("Array of role IDs that can create new versions."),
 });
-// Schema for the scheduled step
-const scheduledStepSchema = z.object({
-    id: z
-        .guid()
-        .describe("The unique identifier of the scheduled step in UUID format"),
-    name: z
-        .string()
-        .describe("The name of the scheduled step - typically 'Scheduled'"),
-    codename: z
-        .string()
-        .describe("The codename of the scheduled step - typically 'scheduled'"),
-});
-// Schema for the archived step
-const archivedStepSchema = z.object({
-    id: z
-        .guid()
-        .describe("The unique identifier of the archived step in UUID format"),
-    name: z
-        .string()
-        .describe("The name of the archived step - typically 'Archived'"),
-    codename: z
-        .string()
-        .describe("The codename of the archived step - typically 'archived'"),
+// Archived step input schema
+const archivedStepInputSchema = z.object({
     role_ids: z
         .array(z.guid())
-        .describe("Array of role IDs that can unarchive content from this step")
-        .optional(),
+        .min(1)
+        .describe("Array of role IDs that can restore archived content."),
 });
-// Schema for workflow scope
-const workflowScopeSchema = z.object({
+// Workflow scope input schema
+const workflowScopeInputSchema = z.object({
     content_types: z
-        .array(z.object({
-        id: z
-            .guid()
-            .describe("The unique identifier of the content type in UUID format"),
-    }))
-        .describe("Array of content types that this workflow applies to"),
+        .array(referenceObjectSchema)
+        .describe("Content types this workflow applies to"),
+    collections: z
+        .array(referenceObjectSchema)
+        .optional()
+        .describe("Collections this workflow applies to"),
 });
-// Main workflow schema
-export const workflowSchema = z.object({
-    id: z.guid().describe("The unique identifier of the workflow in UUID format"),
-    name: z.string().describe("The human-readable name of the workflow"),
+// Main add/update workflow schema
+export const workflowInputSchema = z.object({
+    name: z.string().describe("Human-readable name of the workflow"),
     codename: z
         .string()
-        .describe("The codename of the workflow used for API operations"),
+        .optional()
+        .describe("Codename for API operations (auto-generated if omitted)"),
     scopes: z
-        .array(workflowScopeSchema)
-        .describe("Array of scopes defining which content types use this workflow"),
+        .array(workflowScopeInputSchema)
+        .describe("Array of scopes defining which combinations of content types and collections this workflow applies to. If both content types and collections are empty, the workflow can be used for any type of content in collection that isn't limited to any other workflow."),
     steps: z
-        .array(workflowStepSchema)
-        .describe("Array of custom workflow steps between draft and published states"),
-    published_step: publishedStepSchema.describe("The published step configuration of the workflow"),
-    scheduled_step: scheduledStepSchema.describe("The scheduled step configuration of the workflow"),
-    archived_step: archivedStepSchema.describe("The archived step configuration of the workflow"),
+        .array(workflowStepInputSchema)
+        .describe("Array of custom workflow steps"),
+    published_step: publishedStepInputSchema.describe("Configuration for the published step"),
+    archived_step: archivedStepInputSchema.describe("Configuration for the archived step"),
 });
-// Schema for the list workflows response
-export const listWorkflowsResponseSchema = z
-    .array(workflowSchema)
-    .describe("Array of workflows in the project");