@kontent-ai/mcp-server 0.8.2 → 0.9.0

package/README.md

@@ -88,6 +88,7 @@ npx @kontent-ai/mcp-server@latest sse
 * **delete-content-item-mapi** – Delete a content item by internal ID
 * **upsert-language-variant-mapi** – Create or update a language variant with content using internal IDs
 * **delete-language-variant-mapi** – Delete a language variant of a content item by internal IDs
+* **filter-variants-mapi** – Search and filter language variants using filters and search phrases
 
 ### Asset Management
 

package/build/schemas/contentItemSchemas.js

@@ -1,11 +1,5 @@
 import { z } from "zod";
-const referenceObjectSchema = z
-    .object({
-    id: z.string().optional(),
-    codename: z.string().optional(),
-    external_id: z.string().optional(),
-})
-    .describe("An object with an id, codename, or external_id property referencing another item. Using id is preferred for better performance.");
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
 const languageVariantElementBaseSchema = z.object({
     element: referenceObjectSchema,
     value: z.any(),

package/build/schemas/filterVariantSchemas.js

@@ -0,0 +1,54 @@
+import { z } from "zod";
+import { referenceObjectSchema } from "./referenceObjectSchema.js";
+const userReferenceSchema = z.object({
+    id: z.string().optional().describe("User identifier"),
+    email: z.string().email().optional().describe("User email address"),
+});
+// Search variants tool input schema
+export const filterVariantsSchema = z.object({
+    search_phrase: z
+        .string()
+        .optional()
+        .describe("Search phrase to look for in content"),
+    content_types: z
+        .array(referenceObjectSchema)
+        .min(1)
+        .optional()
+        .describe("Array of references to content types by their id, codename, or external id"),
+    contributors: z
+        .array(userReferenceSchema)
+        .min(1)
+        .optional()
+        .describe("Array of references to users by their id or email"),
+    completion_statuses: z
+        .array(z.enum(["unfinished", "completed", "not_translated", "all_done"]))
+        .min(1)
+        .optional()
+        .describe("Array of completion statuses to filter by. It is not the same thing as workflow steps, it reflects e.g. not filled in required elements"),
+    language: referenceObjectSchema
+        .optional()
+        .describe("Reference to a language by its id, codename, or external id (defaults to default language)"),
+    workflow_steps: z
+        .array(z.object({
+        workflow_identifier: referenceObjectSchema.describe("Reference to a workflow by its id, codename, or external id"),
+        step_identifiers: z
+            .array(referenceObjectSchema)
+            .min(1)
+            .describe("Array of references to workflow steps by their id, codename, or external id"),
+    }))
+        .min(1)
+        .optional()
+        .describe("Array of workflows with workflow steps"),
+    order_by: z
+        .enum(["name", "due", "last_modified"])
+        .optional()
+        .describe("Field to order by"),
+    order_direction: z
+        .enum(["asc", "desc"])
+        .optional()
+        .describe("Order direction"),
+    continuation_token: z
+        .string()
+        .optional()
+        .describe("Continuation token for pagination"),
+});

package/build/schemas/referenceObjectSchema.js

@@ -0,0 +1,9 @@
+import z from "zod";
+// Define a reusable reference object schema
+export const referenceObjectSchema = z
+    .object({
+    id: z.string().optional(),
+    codename: z.string().optional(),
+    external_id: z.string().optional(),
+})
+    .describe("An object with an id, codename, or external_id property referencing another item. Using id is preferred for better performance.");

package/build/server.js

@@ -6,6 +6,7 @@ import { registerTool as registerAddContentTypeSnippetMapi } from "./tools/add-c
 import { registerTool as registerAddTaxonomyGroupMapi } from "./tools/add-taxonomy-group-mapi.js";
 import { registerTool as registerDeleteContentItemMapi } from "./tools/delete-content-item-mapi.js";
 import { registerTool as registerDeleteLanguageVariantMapi } from "./tools/delete-language-variant-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 registerGetInitialContext } from "./tools/get-initial-context.js";
 import { registerTool as registerGetItemDapi } from "./tools/get-item-dapi.js";
@@ -53,5 +54,6 @@ export const createServer = () => {
     registerDeleteContentItemMapi(server);
     registerUpsertLanguageVariantMapi(server);
     registerDeleteLanguageVariantMapi(server);
+    registerFilterVariantsMapi(server);
     return { server };
 };

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

@@ -0,0 +1,66 @@
+import { filterVariantsSchema } from "../schemas/filterVariantSchemas.js";
+import { handleMcpToolError } from "../utils/errorHandler.js";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+import { throwError } from "../utils/throwError.js";
+export const registerTool = (server) => {
+    server.tool("filter-variants-mapi", "Search and filter language variants of content items using the Management API.", filterVariantsSchema.shape, async ({ search_phrase, content_types, contributors, completion_statuses, language, workflow_steps, order_by, order_direction, continuation_token, }) => {
+        try {
+            const requestPayload = {
+                filters: {
+                    search_phrase,
+                    content_types,
+                    contributors,
+                    completion_statuses,
+                    language,
+                    workflow_steps,
+                },
+                order: order_by
+                    ? {
+                        by: order_by,
+                        direction: order_direction === "desc" ? "Descending" : "Ascending",
+                    }
+                    : null,
+            };
+            const environmentId = process.env.KONTENT_ENVIRONMENT_ID;
+            const apiKey = process.env.KONTENT_API_KEY;
+            if (!environmentId || !apiKey) {
+                throwError("Missing required environment variables");
+            }
+            const url = `https://manage.kontent.ai/v2/projects/${environmentId}/early-access/variants/filter`;
+            const headers = {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            };
+            if (continuation_token) {
+                headers["X-Continuation"] = continuation_token;
+            }
+            const response = await fetch(url, {
+                method: "POST",
+                headers: headers,
+                body: JSON.stringify(requestPayload),
+            });
+            if (!response.ok) {
+                const responseText = await response.text();
+                let responseData;
+                try {
+                    responseData = JSON.parse(responseText);
+                }
+                catch {
+                    responseData = responseText;
+                }
+                const error = new Error(`HTTP error! status: ${response.status}`);
+                error.response = {
+                    status: response.status,
+                    statusText: response.statusText,
+                    data: responseData,
+                };
+                throw error;
+            }
+            const responseData = await response.json();
+            return createMcpToolSuccessResponse(responseData);
+        }
+        catch (error) {
+            return handleMcpToolError(error, "Variant Search");
+        }
+    });
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontent-ai/mcp-server",
-  "version": "0.8.2",
+  "version": "0.9.0",
   "type": "module",
   "scripts": {
     "build": "rimraf build && tsc",