@kontent-ai/mcp-server 0.23.3 → 0.25.0

package/build/server.js

@@ -4,12 +4,18 @@ import { registerTool as registerAddContentItemMapi } from "./tools/add-content-
 import { registerTool as registerAddContentTypeMapi } from "./tools/add-content-type-mapi.js";
 import { registerTool as registerAddContentTypeSnippetMapi } from "./tools/add-content-type-snippet-mapi.js";
 import { registerTool as registerAddLanguageMapi } from "./tools/add-language-mapi.js";
+import { registerTool as registerAddSpaceMapi } from "./tools/add-space-mapi.js";
 import { registerTool as registerAddTaxonomyGroupMapi } from "./tools/add-taxonomy-group-mapi.js";
+import { registerTool as registerAddWorkflowMapi } from "./tools/add-workflow-mapi.js";
 import { registerTool as registerChangeVariantWorkflowStepMapi } from "./tools/change-variant-workflow-step-mapi.js";
 import { registerTool as registerCreateVariantVersionMapi } from "./tools/create-variant-version-mapi.js";
 import { registerTool as registerDeleteContentItemMapi } from "./tools/delete-content-item-mapi.js";
 import { registerTool as registerDeleteContentTypeMapi } from "./tools/delete-content-type-mapi.js";
 import { registerTool as registerDeleteLanguageVariantMapi } from "./tools/delete-language-variant-mapi.js";
+import { registerTool as registerDeleteSpaceMapi } from "./tools/delete-space-mapi.js";
+import { registerTool as registerDeleteTaxonomyGroupMapi } from "./tools/delete-taxonomy-group-mapi.js";
+import { registerTool as registerDeleteTypeSnippetMapi } from "./tools/delete-type-snippet-mapi.js";
+import { registerTool as registerDeleteWorkflowMapi } from "./tools/delete-workflow-mapi.js";
 import { registerTool as registerFilterVariantsMapi } from "./tools/filter-variants-mapi.js";
 import { registerTool as registerGetAssetMapi } from "./tools/get-asset-mapi.js";
 import { registerTool as registerGetItemMapi } from "./tools/get-item-mapi.js";
@@ -19,11 +25,13 @@ import { registerTool as registerGetPublishedVariantMapi } from "./tools/get-pub
 import { registerTool as registerGetTaxonomyGroupMapi } from "./tools/get-taxonomy-group-mapi.js";
 import { registerTool as registerGetTypeMapi } from "./tools/get-type-mapi.js";
 import { registerTool as registerGetTypeSnippetMapi } from "./tools/get-type-snippet-mapi.js";
+import { registerTool as registerListAssetFoldersMapi } from "./tools/list-asset-folders-mapi.js";
 import { registerTool as registerListAssetsMapi } from "./tools/list-assets-mapi.js";
 import { registerTool as registerListCollectionsMapi } from "./tools/list-collections-mapi.js";
 import { registerTool as registerListContentTypeSnippetsMapi } from "./tools/list-content-type-snippets-mapi.js";
 import { registerTool as registerListContentTypesMapi } from "./tools/list-content-types-mapi.js";
 import { registerTool as registerListLanguagesMapi } from "./tools/list-languages-mapi.js";
+import { registerTool as registerListRolesMapi } from "./tools/list-roles-mapi.js";
 import { registerTool as registerListSpacesMapi } from "./tools/list-spaces-mapi.js";
 import { registerTool as registerListTaxonomyGroupsMapi } from "./tools/list-taxonomy-groups-mapi.js";
 import { registerTool as registerListVariantsCollectionMapi } from "./tools/list-variants-collection-mapi.js";
@@ -32,13 +40,19 @@ import { registerTool as registerListVariantsItemMapi } from "./tools/list-varia
 import { registerTool as registerListVariantsSpaceMapi } from "./tools/list-variants-space-mapi.js";
 import { registerTool as registerListVariantsTypeMapi } from "./tools/list-variants-type-mapi.js";
 import { registerTool as registerListWorkflowsMapi } from "./tools/list-workflows-mapi.js";
+import { registerTool as registerPatchAssetFoldersMapi } from "./tools/patch-asset-folders-mapi.js";
 import { registerTool as registerPatchCollectionsMapi } from "./tools/patch-collections-mapi.js";
 import { registerTool as registerPatchContentTypeMapi } from "./tools/patch-content-type-mapi.js";
 import { registerTool as registerPatchLanguageMapi } from "./tools/patch-language-mapi.js";
+import { registerTool as registerPatchSpaceMapi } from "./tools/patch-space-mapi.js";
+import { registerTool as registerPatchTaxonomyGroupMapi } from "./tools/patch-taxonomy-group-mapi.js";
+import { registerTool as registerPatchTypeSnippetMapi } from "./tools/patch-type-snippet-mapi.js";
 import { registerTool as registerPublishVariantMapi } from "./tools/publish-variant-mapi.js";
 import { registerTool as registerSearchVariantsMapi } from "./tools/search-variants-mapi.js";
 import { registerTool as registerUnpublishVariantMapi } from "./tools/unpublish-variant-mapi.js";
+import { registerTool as registerUpdateAssetMapi } from "./tools/update-asset-mapi.js";
 import { registerTool as registerUpdateContentItemMapi } from "./tools/update-content-item-mapi.js";
+import { registerTool as registerUpdateWorkflowMapi } from "./tools/update-workflow-mapi.js";
 import { registerTool as registerUpsertLanguageVariantMapi } from "./tools/upsert-language-variant-mapi.js";
 // Create server instance
 export const createServer = () => {
@@ -65,16 +79,27 @@ export const createServer = () => {
     registerListCollectionsMapi(server);
     registerPatchCollectionsMapi(server);
     registerListSpacesMapi(server);
+    registerAddSpaceMapi(server);
+    registerPatchSpaceMapi(server);
+    registerDeleteSpaceMapi(server);
+    registerListRolesMapi(server);
     registerGetAssetMapi(server);
     registerListAssetsMapi(server);
+    registerUpdateAssetMapi(server);
+    registerListAssetFoldersMapi(server);
+    registerPatchAssetFoldersMapi(server);
     registerAddContentTypeMapi(server);
     registerPatchContentTypeMapi(server);
     registerAddContentTypeSnippetMapi(server);
     registerGetTypeSnippetMapi(server);
     registerListContentTypeSnippetsMapi(server);
+    registerPatchTypeSnippetMapi(server);
+    registerDeleteTypeSnippetMapi(server);
     registerAddTaxonomyGroupMapi(server);
     registerListTaxonomyGroupsMapi(server);
     registerGetTaxonomyGroupMapi(server);
+    registerPatchTaxonomyGroupMapi(server);
+    registerDeleteTaxonomyGroupMapi(server);
     registerAddContentItemMapi(server);
     registerUpdateContentItemMapi(server);
     registerDeleteContentItemMapi(server);
@@ -82,6 +107,9 @@ export const createServer = () => {
     registerCreateVariantVersionMapi(server);
     registerDeleteLanguageVariantMapi(server);
     registerListWorkflowsMapi(server);
+    registerAddWorkflowMapi(server);
+    registerUpdateWorkflowMapi(server);
+    registerDeleteWorkflowMapi(server);
     registerChangeVariantWorkflowStepMapi(server);
     registerFilterVariantsMapi(server);
     registerSearchVariantsMapi(server);

package/build/telemetry/applicationInsights.js

@@ -156,6 +156,6 @@ export function initializeApplicationInsights() {
         appInsights.defaultClient.addTelemetryProcessor(createTelemetryProcessor());
     }
     catch (error) {
-        console.log("Failed to initialize Application Insights:", error);
+        console.error("Failed to initialize Application Insights:", error);
     }
 }

package/build/tools/add-content-type-mapi.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { createMapiClient } from "../clients/kontentClients.js";
-import { contentGroupSchema, elementSchema, } from "../schemas/contentTypeSchemas.js";
+import { contentGroupSchema, elementSchema, } from "../schemas/contentTypeAndSnippetSchemas.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {

package/build/tools/add-content-type-snippet-mapi.js

@@ -1,6 +1,6 @@
 import { z } from "zod";
 import { createMapiClient } from "../clients/kontentClients.js";
-import { snippetElementSchema } from "../schemas/contentTypeSchemas.js";
+import { snippetElementSchema } from "../schemas/contentTypeAndSnippetSchemas.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {

package/build/tools/add-space-mapi.js

@@ -0,0 +1,23 @@
+import { createMapiClient } from "../clients/kontentClients.js";
+import { addSpaceSchema } from "../schemas/spaceSchemas.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("add-space-mapi", "Add Kontent.ai space", addSpaceSchema.shape, async ({ name, codename, collections }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            const response = await client
+                .addSpace()
+                .withData({
+                name,
+                codename,
+                collections,
+            })
+                .toPromise();
+            return createMcpToolSuccessResponse(response.rawData);
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Space Creation");
+        }
+    });
+};

package/build/tools/add-workflow-mapi.js

@@ -0,0 +1,24 @@
+import { createMapiClient } from "../clients/kontentClients.js";
+import { workflowInputSchema } from "../schemas/workflowSchemas.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("add-workflow-mapi", "Add new Kontent.ai workflow", workflowInputSchema.shape, async ({ name, codename, scopes, steps, published_step, archived_step }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        const data = {
+            name,
+            codename,
+            scopes,
+            steps,
+            published_step,
+            archived_step,
+        };
+        try {
+            const response = await client.addWorkflow().withData(data).toPromise();
+            return createMcpToolSuccessResponse(response.rawData);
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Workflow Creation");
+        }
+    });
+};

package/build/tools/change-variant-workflow-step-mapi.js

@@ -4,12 +4,10 @@ import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
     server.tool("change-variant-workflow-step-mapi", "Change Kontent.ai variant workflow step", {
-        itemId: z.guid().describe("Content item UUID"),
-        languageId: z
-            .guid()
-            .describe("Language variant UUID (default: 00000000-0000-0000-0000-000000000000)"),
-        workflowId: z.guid().describe("Workflow UUID"),
-        workflowStepId: z.guid().describe("Target workflow step UUID"),
+        itemId: z.guid().describe("Content item ID"),
+        languageId: z.guid().describe("Language variant ID"),
+        workflowId: z.guid().describe("Workflow ID"),
+        workflowStepId: z.guid().describe("Target workflow step ID"),
     }, async ({ itemId, languageId, workflowId, workflowStepId }, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         try {

package/build/tools/context/patch-guide-path-based.js

@@ -0,0 +1,53 @@
+export const pathBasedPatchGuide = `
+# Patch Guide: Content Types & Snippets
+
+## Addressing
+Use JSON Pointer 'path' property with id:{uuid} format.
+
+## Path Formats
+- Element: /elements/id:{uuid}
+- Element property: /elements/id:{uuid}/name
+- Option: /elements/id:{uuid}/options/id:{uuid}
+- Content group: /content_groups/id:{uuid}
+- Array item: /elements/id:{uuid}/allowed_content_types/id:{uuid}
+
+## Operations
+
+**move** - Reorder elements/options/groups
+\`\`\`json
+{ "op": "move", "path": "/elements/id:{uuid}", "before": { "id": "{uuid}" } }
+{ "op": "move", "path": "/elements/id:{uuid}", "after": { "id": "{uuid}" } }
+\`\`\`
+
+**addInto** - Add to arrays (elements, options, allowed_blocks, etc.)
+\`\`\`json
+{ "op": "addInto", "path": "/elements", "value": { "name": "Title", "type": "text", ... } }
+{ "op": "addInto", "path": "/elements/id:{uuid}/allowed_content_types", "value": { "id": "{uuid}" } }
+\`\`\`
+
+**remove** - Delete items
+\`\`\`json
+{ "op": "remove", "path": "/elements/id:{uuid}" }
+{ "op": "remove", "path": "/elements/id:{uuid}/allowed_content_types/id:{uuid}" }
+\`\`\`
+
+**replace** - Update primitives/objects
+\`\`\`json
+{ "op": "replace", "path": "/elements/id:{uuid}/name", "value": "New Name" }
+{ "op": "replace", "path": "/elements/id:{uuid}/maximum_text_length", "value": { "value": 100, "applies_to": "characters" } }
+\`\`\`
+
+## Rules
+- Use addInto/remove for arrays, replace for primitives/objects
+- external_id and type cannot be modified after creation
+- Empty arrays enable all options (allowed_blocks, allowed_formatting, etc.)
+- 'unstyled' must be first when adding allowed_formatting
+
+## Content Type Specifics
+- Only one url_slug element allowed per content type
+- To remove content groups: set ALL elements' content_group to null AND remove ALL groups in one request
+- URL slug with snippet: add snippet element first, then url_slug with depends_on reference
+
+## Snippet Specifics
+- Cannot contain: content_groups, snippet, or url_slug elements
+`;

package/build/tools/context/patch-guide-property-based.js

@@ -0,0 +1,42 @@
+export const propertyBasedPatchGuide = `
+# Patch Guide: Spaces & Languages
+
+## Addressing
+Use 'property_name' to specify which property to update. Only 'replace' operation is supported.
+
+## Space Operations
+
+**replace** - Update space properties
+\`\`\`json
+{ "op": "replace", "property_name": "name", "value": "New Space Name" }
+{ "op": "replace", "property_name": "codename", "value": "new_codename" }
+{ "op": "replace", "property_name": "collections", "value": [{ "id": "{uuid}" }, { "codename": "collection" }] }
+\`\`\`
+
+Available properties: name, codename, collections
+
+## Language Operations
+
+**replace** - Update language properties
+\`\`\`json
+{ "op": "replace", "property_name": "name", "value": "New Language Name" }
+{ "op": "replace", "property_name": "codename", "value": "new_codename" }
+{ "op": "replace", "property_name": "is_active", "value": true }
+{ "op": "replace", "property_name": "fallback_language", "value": { "codename": "en-US" } }
+\`\`\`
+
+Available properties: name, codename, is_active, fallback_language
+
+## Critical Rule for Languages
+If a language is deactivated, you must activate it first before making other changes:
+\`\`\`json
+[
+  { "op": "replace", "property_name": "is_active", "value": true },
+  { "op": "replace", "property_name": "name", "value": "New Name" }
+]
+\`\`\`
+
+## General Rules
+- external_id cannot be modified after creation
+- Operations are applied in order
+`;

package/build/tools/context/patch-guide-reference-based.js

@@ -0,0 +1,86 @@
+export const referenceBasedPatchGuide = `
+# Patch Guide: Taxonomy, Collections & Asset Folders
+
+## Addressing
+Use 'reference' objects: { id: "{uuid}" } or { codename: "codename" }
+
+## Taxonomy Group Operations
+
+**addInto** - Add terms
+\`\`\`json
+{ "op": "addInto", "value": { "name": "Term" } }
+{ "op": "addInto", "reference": { "id": "{parent-uuid}" }, "value": { "name": "Child Term" } }
+{ "op": "addInto", "value": { "name": "Term" }, "before": { "id": "{uuid}" } }
+{ "op": "addInto", "value": { "name": "Term" }, "after": { "id": "{uuid}" } }
+\`\`\`
+
+**move** - Reorder or nest terms (before/after/under are mutually exclusive)
+\`\`\`json
+{ "op": "move", "reference": { "id": "{uuid}" }, "before": { "id": "{uuid}" } }
+{ "op": "move", "reference": { "id": "{uuid}" }, "after": { "id": "{uuid}" } }
+{ "op": "move", "reference": { "id": "{uuid}" }, "under": { "id": "{parent-uuid}" } }
+\`\`\`
+
+**remove** - Delete terms
+\`\`\`json
+{ "op": "remove", "reference": { "id": "{uuid}" } }
+\`\`\`
+
+**replace** - Update properties
+\`\`\`json
+{ "op": "replace", "property_name": "name", "value": "New Group Name" }
+{ "op": "replace", "reference": { "id": "{uuid}" }, "property_name": "name", "value": "New Term Name" }
+{ "op": "replace", "reference": { "id": "{uuid}" }, "property_name": "terms", "value": [] }
+\`\`\`
+
+## Collection Operations
+
+**addInto** - Add collections
+\`\`\`json
+{ "op": "addInto", "value": { "name": "Collection", "codename": "collection" } }
+{ "op": "addInto", "value": { "name": "Collection" }, "before": { "id": "{uuid}" } }
+{ "op": "addInto", "value": { "name": "Collection" }, "after": { "id": "{uuid}" } }
+\`\`\`
+
+**move** - Reorder collections
+\`\`\`json
+{ "op": "move", "reference": { "id": "{uuid}" }, "before": { "id": "{uuid}" } }
+{ "op": "move", "reference": { "id": "{uuid}" }, "after": { "id": "{uuid}" } }
+\`\`\`
+
+**remove** - Delete empty collections only
+\`\`\`json
+{ "op": "remove", "reference": { "id": "{uuid}" } }
+\`\`\`
+
+**replace** - Rename collections
+\`\`\`json
+{ "op": "replace", "reference": { "id": "{uuid}" }, "property_name": "name", "value": "New Name" }
+\`\`\`
+
+## Asset Folder Operations
+
+**addInto** - Add folders
+\`\`\`json
+{ "op": "addInto", "value": { "name": "Folder" } }
+{ "op": "addInto", "reference": { "id": "{parent-uuid}" }, "value": { "name": "Subfolder" } }
+{ "op": "addInto", "value": { "name": "Folder" }, "before": { "id": "{uuid}" } }
+\`\`\`
+
+**rename** - Rename folders (not 'replace')
+\`\`\`json
+{ "op": "rename", "reference": { "id": "{uuid}" }, "value": "New Folder Name" }
+\`\`\`
+
+**remove** - Delete folders
+\`\`\`json
+{ "op": "remove", "reference": { "id": "{uuid}" } }
+\`\`\`
+
+Note: Asset folders do not support 'move' operation.
+
+## General Rules
+- Always fetch the entity first to get current IDs
+- external_id cannot be modified after creation
+- Operations are applied in order
+`;

package/build/tools/delete-space-mapi.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("delete-space-mapi", "Delete Kontent.ai space by ID", {
+        id: z.guid(),
+    }, async ({ id }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            await client.deleteSpace().bySpaceId(id).toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Space '${id}' deleted successfully`,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Space Deletion");
+        }
+    });
+};

package/build/tools/delete-taxonomy-group-mapi.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("delete-taxonomy-group-mapi", "Delete Kontent.ai taxonomy group by ID", {
+        id: z.guid(),
+    }, async ({ id }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            await client.deleteTaxonomy().byTaxonomyId(id).toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Taxonomy group '${id}' deleted successfully`,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Taxonomy Group Deletion");
+        }
+    });
+};

package/build/tools/delete-type-snippet-mapi.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("delete-type-snippet-mapi", "Delete Kontent.ai content type snippet by codename", {
+        codename: z.string(),
+    }, async ({ codename }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            await client
+                .deleteContentTypeSnippet()
+                .byTypeCodename(codename)
+                .toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Content type snippet '${codename}' deleted successfully`,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Content Type Snippet Deletion");
+        }
+    });
+};

package/build/tools/delete-workflow-mapi.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("delete-workflow-mapi", {
+        id: z.guid().describe("Workflow ID"),
+    }, async ({ id }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            await client.deleteWorkflow().byWorkflowId(id).toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Workflow '${id}' deleted successfully`,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Workflow Deletion");
+        }
+    });
+};

package/build/tools/get-patch-guide.js

@@ -1,9 +1,37 @@
+import { z } from "zod";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
-import { patchOperationsGuide } from "./context/patch-operations-guide.js";
+import { pathBasedPatchGuide } from "./context/patch-guide-path-based.js";
+import { propertyBasedPatchGuide } from "./context/patch-guide-property-based.js";
+import { referenceBasedPatchGuide } from "./context/patch-guide-reference-based.js";
+const entityTypeSchema = z.enum([
+    "content-type",
+    "snippet",
+    "taxonomy",
+    "collection",
+    "asset-folder",
+    "space",
+    "language",
+]);
+const getGuideForEntity = (entityType) => {
+    switch (entityType) {
+        case "content-type":
+        case "snippet":
+            return pathBasedPatchGuide;
+        case "taxonomy":
+        case "collection":
+        case "asset-folder":
+            return referenceBasedPatchGuide;
+        case "space":
+        case "language":
+            return propertyBasedPatchGuide;
+    }
+};
 export const registerTool = (server) => {
-    server.tool("get-patch-guide", "REQUIRED before any patch operation. Get JSON Patch operations guide for Kontent.ai Management API.", {}, async () => {
+    server.tool("get-patch-guide", "REQUIRED before any patch operation. Get patch operations guide for Kontent.ai Management API.", {
+        entityType: entityTypeSchema.describe("Entity type to get patch guide for: content-type, snippet, taxonomy, collection, asset-folder, space, language"),
+    }, async ({ entityType }) => {
         try {
-            return createMcpToolSuccessResponse(patchOperationsGuide);
+            return createMcpToolSuccessResponse(getGuideForEntity(entityType));
         }
         catch (error) {
             throw new Error(`Failed to read patch guide: ${error instanceof Error ? error.message : "Unknown error"}`);

package/build/tools/get-taxonomy-group-mapi.js

@@ -3,8 +3,8 @@ import { createMapiClient } from "../clients/kontentClients.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
-    server.tool("get-taxonomy-group-mapi", "Get Kontent.ai taxonomy group. Taxonomies provide hierarchical categorization for organizing and tagging content.", {
-        id: z.string().describe("Taxonomy group ID"),
+    server.tool("get-taxonomy-group-mapi", "Get Kontent.ai taxonomy group. Taxonomy groups are hierarchical with tree-structured terms that can be nested to any depth for flexible content categorization.", {
+        id: z.guid(),
     }, async ({ id }, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         try {

package/build/tools/list-asset-folders-mapi.js

@@ -0,0 +1,15 @@
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("list-asset-folders-mapi", "List all Kontent.ai asset folders", {}, async (_params, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            const response = await client.listAssetFolders().toPromise();
+            return createMcpToolSuccessResponse(response.rawData);
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Asset Folders Listing");
+        }
+    });
+};

package/build/tools/list-roles-mapi.js

@@ -0,0 +1,15 @@
+import { createMapiClient } from "../clients/kontentClients.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("list-roles-mapi", "Get all Kontent.ai roles", {}, async (_, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            const response = await client.listRoles().toPromise();
+            return createMcpToolSuccessResponse(response.rawData.roles);
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Roles Listing");
+        }
+    });
+};

package/build/tools/list-spaces-mapi.js

@@ -2,7 +2,7 @@ import { createMapiClient } from "../clients/kontentClients.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
-    server.tool("list-spaces-mapi", "Get all Kontent.ai spaces from Management API", {}, async (_, { authInfo: { token, clientId } = {} }) => {
+    server.tool("list-spaces-mapi", "List all Kontent.ai spaces. Spaces provide channel-specific context for managing multiple websites/channels. Each space has its own domain and preview URLs; collections connect to spaces to organize content per channel.", {}, async (_, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         try {
             const response = await client.listSpaces().toPromise();

package/build/tools/list-taxonomy-groups-mapi.js

@@ -3,7 +3,7 @@ import { listTaxonomyGroupsSchema } from "../schemas/listSchemas.js";
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
-    server.tool("list-taxonomy-groups-mapi", "Get all Kontent.ai taxonomy groups (paginated). Taxonomies provide hierarchical categorization for organizing and tagging content.", listTaxonomyGroupsSchema.shape, async ({ continuation_token }, { authInfo: { token, clientId } = {} }) => {
+    server.tool("list-taxonomy-groups-mapi", "List all Kontent.ai taxonomy groups (paginated). Taxonomy groups are hierarchical with tree-structured terms that can be nested to any depth for flexible content categorization.", listTaxonomyGroupsSchema.shape, async ({ continuation_token }, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         try {
             const query = client.listTaxonomies();

package/build/tools/patch-asset-folders-mapi.js

@@ -0,0 +1,25 @@
+import { createMapiClient } from "../clients/kontentClients.js";
+import { assetFolderPatchOperationsSchema } from "../schemas/assetFolderSchemas.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+export const registerTool = (server) => {
+    server.tool("patch-asset-folders-mapi", "Modify Kontent.ai asset folders using patch operations (addInto, rename, remove). Call get-patch-guide first for operations reference.", {
+        operations: assetFolderPatchOperationsSchema,
+    }, async ({ operations }, { authInfo: { token, clientId } = {} }) => {
+        const client = createMapiClient(clientId, token);
+        try {
+            const response = await client
+                .modifyAssetFolders()
+                .withData(operations)
+                .toPromise();
+            return createMcpToolSuccessResponse({
+                message: `Asset folders modified with ${operations.length} operation(s)`,
+                folders: response.rawData,
+                appliedOperations: operations,
+            });
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Asset Folders Modification");
+        }
+    });
+};

package/build/tools/patch-content-type-mapi.js

@@ -4,20 +4,24 @@ import { patchOperationsSchema } from "../schemas/patchSchemas/contentTypePatchS
 import { handleMcpToolError } from "../utils/errorHandler.js";
 import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 export const registerTool = (server) => {
-    server.tool("patch-content-type-mapi", "Update Kontent.ai content type using JSON Patch. Call get-patch-guide first for operations reference.", {
-        codename: z.string().describe("Content type codename"),
-        operations: patchOperationsSchema.describe("Patch operations array. CRITICAL: Always call get-type-mapi first. Use addInto/remove for arrays, replace for primitives/objects. See context for details."),
-    }, async ({ codename, operations }, { authInfo: { token, clientId } = {} }) => {
+    server.tool("patch-content-type-mapi", "Update Kontent.ai content type using patch operations. Call get-patch-guide first for operations reference.", {
+        id: z.guid(),
+        operations: patchOperationsSchema.describe(`Patch operations array. CRITICAL: Always call get-type-mapi first.
+- Use addInto/remove for arrays, replace for primitives/objects
+- Only one url_slug element allowed per content type
+- To remove content groups: set ALL elements' content_group to null AND remove ALL groups in one request
+- URL slug with snippet: add snippet element first, then url_slug with depends_on reference`),
+    }, async ({ id, operations }, { authInfo: { token, clientId } = {} }) => {
         const client = createMapiClient(clientId, token);
         try {
             // Apply patch operations using the modifyContentType method
             const response = await client
                 .modifyContentType()
-                .byTypeCodename(codename)
+                .byTypeId(id)
                 .withData(operations)
                 .toPromise();
             return createMcpToolSuccessResponse({
-                message: `Content type '${codename}' updated successfully with ${operations.length} operation(s)`,
+                message: `Content type updated successfully with ${operations.length} operation(s)`,
                 contentType: response.rawData,
                 appliedOperations: operations,
             });