@kontent-ai/mcp-server 0.31.0 → 0.33.0

package/build/tools/search-variants-mapi.js

@@ -1,108 +0,0 @@
-import pRetry, { AbortError } from "p-retry";
-import { createMapiClient } from "../clients/kontentClients.js";
-import { searchOperationSchema } from "../schemas/searchOperationSchemas.js";
-import { handleMcpToolError } from "../utils/errorHandler.js";
-import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
-import { throwError } from "../utils/throwError.js";
-class OperationResultIncompleteError extends Error {
-    constructor() {
-        super("AI operation result is incomplete");
-        this.name = "OperationResultIncompleteError";
-    }
-}
-const isSearchResponseWrapper = (value) => typeof value === "object" && value !== null && "searchResults" in value;
-const extractSearchResults = (response) => {
-    const value = response.result?.value;
-    if (!value) {
-        return {};
-    }
-    const parsed = JSON.parse(value);
-    if (isSearchResponseWrapper(parsed)) {
-        return JSON.parse(parsed.searchResults);
-    }
-    return parsed;
-};
-export const registerTool = (server) => {
-    server.tool("search-variants-mapi", "AI semantic search for Kontent.ai content by topic/theme (max 50 results). Use filter-variants-mapi for exact keywords. May be unavailable.", searchOperationSchema.shape, async ({ searchPhrase, filter }, { authInfo: { token, clientId } = {} }) => {
-        try {
-            const environmentId = clientId ?? process.env.KONTENT_ENVIRONMENT_ID;
-            if (!environmentId) {
-                throwError("Missing required environment ID");
-            }
-            const client = createMapiClient(environmentId, token);
-            // Step 1: Initiate the AI search operation
-            const searchPayload = {
-                actionName: "Search",
-                type: "multiple-inputs-request-v1",
-                inputs: {
-                    searchPhrase: {
-                        type: "string",
-                        value: searchPhrase,
-                    },
-                    filter: {
-                        type: "content-item-variant-filter",
-                        value: filter,
-                    },
-                },
-                trackingData: {
-                    type: "empty-operation-tracking-data-v1",
-                },
-            };
-            let searchResponse;
-            try {
-                searchResponse = await client
-                    .post()
-                    .withAction(`projects/${environmentId}/early-access/ai-operation`)
-                    .withData(searchPayload)
-                    .toPromise();
-            }
-            catch (error) {
-                if (error?.response?.status === 403 &&
-                    error?.response?.data?.message?.includes("AI Feature Not Available")) {
-                    return createMcpToolSuccessResponse({
-                        status: "unavailable",
-                        result: `AI search feature is not available for environment ${clientId}`,
-                    });
-                }
-                throw error;
-            }
-            const operationData = searchResponse.data;
-            const operationId = operationData.operationId;
-            // Step 2: Poll for results with exponential backoff
-            const resultData = await pRetry(async () => {
-                try {
-                    const pollResponse = await client
-                        .get()
-                        .withAction(`projects/${environmentId}/early-access/ai-operation-result/${operationId}`)
-                        .toPromise();
-                    const [response] = pollResponse.data;
-                    if (response.type === "cumulated-result-v1" &&
-                        !response.result?.isFinished) {
-                        throw new OperationResultIncompleteError();
-                    }
-                    return response;
-                }
-                catch (error) {
-                    if (error?.response?.status === 404 ||
-                        error instanceof OperationResultIncompleteError) {
-                        throw error;
-                    }
-                    throw new AbortError(error);
-                }
-            }, {
-                // Worst-case retry time: ~1 minute
-                retries: 10,
-                minTimeout: 1000,
-                maxTimeout: 10000,
-                factor: 1.5,
-            });
-            const searchResults = extractSearchResults(resultData);
-            return createMcpToolSuccessResponse({
-                result: searchResults,
-            });
-        }
-        catch (error) {
-            return handleMcpToolError(error, "AI-powered Variant Search");
-        }
-    });
-};

package/build/tools/unpublish-variant-mapi.js

@@ -1,73 +0,0 @@
-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("unpublish-variant-mapi", "Unpublish or schedule unpublishing Kontent.ai variant. For scheduling, verify current UTC time before using scheduledTo.", {
-        itemId: z.guid().describe("Content item UUID"),
-        languageId: z
-            .guid()
-            .describe("Language variant UUID (default: 00000000-0000-0000-0000-000000000000)"),
-        scheduledTo: z.iso
-            .datetime({ offset: true })
-            .optional()
-            .describe("ISO 8601 datetime for scheduled unpublish (omit for immediate)"),
-        displayTimezone: z
-            .string()
-            .optional()
-            .describe("Timezone for UI display (e.g., America/New_York, UTC)"),
-    }, async ({ itemId, languageId, scheduledTo, displayTimezone }, { authInfo: { token, clientId } = {} }) => {
-        const client = createMapiClient(clientId, token);
-        try {
-            // Validate that displayTimezone can only be used with scheduledTo
-            if (displayTimezone && !scheduledTo) {
-                throw new Error("The 'displayTimezone' parameter can only be used in combination with 'scheduledTo' parameter for scheduled unpublishing.");
-            }
-            let action;
-            let message;
-            if (scheduledTo) {
-                // Scheduled unpublishing
-                const requestData = {
-                    scheduled_to: scheduledTo,
-                };
-                // Add display_timezone if provided
-                if (displayTimezone) {
-                    requestData.display_timezone = displayTimezone;
-                }
-                await client
-                    .unpublishLanguageVariant()
-                    .byItemId(itemId)
-                    .byLanguageId(languageId)
-                    .withData(requestData)
-                    .toPromise();
-                action = "scheduled for unpublishing";
-                message = `Successfully scheduled language variant '${languageId}' for content item '${itemId}' to be unpublished at '${scheduledTo}'${displayTimezone ? ` (timezone: ${displayTimezone})` : ""}. The content will be removed from Delivery API at the scheduled time.`;
-            }
-            else {
-                // Immediate unpublishing
-                await client
-                    .unpublishLanguageVariant()
-                    .byItemId(itemId)
-                    .byLanguageId(languageId)
-                    .withoutData()
-                    .toPromise();
-                action = "unpublished";
-                message = `Successfully unpublished language variant '${languageId}' for content item '${itemId}'. The content has been moved to Archived and is no longer available through Delivery API.`;
-            }
-            return createMcpToolSuccessResponse({
-                message,
-                result: {
-                    itemId,
-                    languageId,
-                    scheduledTo: scheduledTo || null,
-                    displayTimezone: displayTimezone || null,
-                    action,
-                    timestamp: new Date().toISOString(),
-                },
-            });
-        }
-        catch (error) {
-            return handleMcpToolError(error, "Unpublish/Schedule Unpublishing Language Variant");
-        }
-    });
-};

package/build/tools/update-asset-mapi.js

@@ -1,24 +0,0 @@
-import { z } from "zod";
-import { createMapiClient } from "../clients/kontentClients.js";
-import { updateAssetDataSchema } from "../schemas/assetSchemas.js";
-import { handleMcpToolError } from "../utils/errorHandler.js";
-import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
-export const registerTool = (server) => {
-    server.tool("update-asset-mapi", "Update Kontent.ai asset by ID", {
-        id: z.guid(),
-        data: updateAssetDataSchema,
-    }, async ({ id, data }, { authInfo: { token, clientId } = {} }) => {
-        const client = createMapiClient(clientId, token);
-        try {
-            const response = await client
-                .upsertAsset()
-                .byAssetId(id)
-                .withData(() => data)
-                .toPromise();
-            return createMcpToolSuccessResponse(response.rawData);
-        }
-        catch (error) {
-            return handleMcpToolError(error, "Asset Update");
-        }
-    });
-};

package/build/tools/update-content-item-mapi.js

@@ -1,74 +0,0 @@
-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("update-content-item-mapi", "Update Kontent.ai content item", {
-        id: z.string().describe("Content item ID"),
-        name: z
-            .string()
-            .min(1)
-            .max(200)
-            .optional()
-            .describe("New name (1-200 chars)"),
-        collection: z
-            .object({
-            id: z.string().optional(),
-            codename: z.string().optional(),
-            external_id: z.string().optional(),
-        })
-            .optional()
-            .describe("Collection reference"),
-    }, async ({ id, name, collection }, { authInfo: { token, clientId } = {} }) => {
-        const client = createMapiClient(clientId, token);
-        try {
-            // First, verify the item exists by trying to get it
-            await client.viewContentItem().byItemId(id).toPromise();
-            // If we get here, the item exists, so we can update it
-            const updateData = {};
-            if (name !== undefined) {
-                updateData.name = name;
-            }
-            if (collection !== undefined) {
-                updateData.collection = collection;
-            }
-            // If no update data is provided, return an error
-            if (Object.keys(updateData).length === 0) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: "Update Content Item: No update data provided. At least one field (name or collection) must be specified.",
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            const response = await client
-                .upsertContentItem()
-                .byItemId(id)
-                .withData(updateData)
-                .toPromise();
-            return createMcpToolSuccessResponse({
-                message: `Content item '${id}' updated successfully`,
-                updatedItem: response.rawData,
-            });
-        }
-        catch (error) {
-            // Check if the error is because the item doesn't exist
-            if (error?.response?.status === 404 ||
-                error?.message?.includes("not found")) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Update Content Item: Content item with ID '${id}' does not exist. Use add-content-item-mapi to create new items.`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-            return handleMcpToolError(error, "Content Item Update");
-        }
-    });
-};

package/build/tools/update-language-variant-mapi.js

@@ -1,37 +0,0 @@
-import { z } from "zod";
-import { createMapiClient } from "../clients/kontentClients.js";
-import { languageVariantElementSchema } from "../schemas/contentItemSchemas.js";
-import { handleMcpToolError } from "../utils/errorHandler.js";
-import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
-export const registerTool = (server) => {
-    server.tool("update-language-variant-mapi", "Update Kontent.ai variant. Element values must fulfill limitations and guidelines defined in content type.", {
-        itemId: z.string().describe("Content item ID"),
-        languageId: z
-            .string()
-            .describe("Language variant ID (default: 00000000-0000-0000-0000-000000000000)"),
-        elements: z
-            .array(languageVariantElementSchema)
-            .describe("Content elements array"),
-        workflow_step_id: z.string().optional().describe("Workflow step ID"),
-    }, async ({ itemId, languageId, elements, workflow_step_id }, { authInfo: { token, clientId } = {} }) => {
-        const client = createMapiClient(clientId, token);
-        const data = {
-            elements,
-        };
-        if (workflow_step_id) {
-            data.workflow_step = { id: workflow_step_id };
-        }
-        try {
-            const response = await client
-                .upsertLanguageVariant()
-                .byItemId(itemId)
-                .byLanguageId(languageId)
-                .withData(() => data)
-                .toPromise();
-            return createMcpToolSuccessResponse(response.rawData);
-        }
-        catch (error) {
-            return handleMcpToolError(error, "Language Variant Update");
-        }
-    });
-};

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

@@ -1,32 +0,0 @@
-import { z } from "zod";
-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("update-workflow-mapi", "Update Kontent.ai workflow", {
-        id: z.guid().describe("Workflow ID"),
-        ...workflowInputSchema.shape,
-    }, async ({ id, 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
-                .updateWorkflow()
-                .byWorkflowId(id)
-                .withData(data)
-                .toPromise();
-            return createMcpToolSuccessResponse(response.rawData);
-        }
-        catch (error) {
-            return handleMcpToolError(error, "Workflow Update");
-        }
-    });
-};