@kontent-ai/mcp-server 0.20.0 → 0.21.0

package/README.md

@@ -91,7 +91,7 @@ npx @kontent-ai/mcp-server@latest shttp
 * **upsert-language-variant-mapi** – Create or update Kontent.ai language variant of a content item via Management API. This adds actual content to the content item elements. When updating an existing variant, only the provided elements will be modified
 * **create-variant-version-mapi** – Create new version of Kontent.ai language variant via Management API. This operation creates a new version of an existing language variant, useful for content versioning and creating new drafts from published content
 * **delete-language-variant-mapi** – Delete Kontent.ai language variant from Management API
-* **filter-variants-mapi** – Filter Kontent.ai language variants of content items using Management API. Use for exact keyword matching and finding specific terms in content. Supports full filtering capabilities (content types, workflow steps, taxonomies, etc.)
+* **filter-variants-mapi** – Filter Kontent.ai language variants of content items using Management API. Use for exact keyword matching and finding specific terms in content. Supports full filtering capabilities (content types, workflow steps, taxonomies, etc.) and optionally includes full content of variants
 * **search-variants-mapi** – AI-powered semantic search for finding content by meaning and concepts in a specific language variant. Use for: conceptual searches when you don't know exact keywords. Limited filtering options (variant ID only)
 
 ### Asset Management

package/build/schemas/filterVariantSchemas.js

@@ -1,9 +1,18 @@
 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"),
-});
+// UserReferenceDataContract is a union type - either id or email, but not both
+const userReferenceSchema = z
+    .union([
+    z.object({
+        id: z.string().describe("User identifier"),
+        email: z.never().optional(),
+    }),
+    z.object({
+        id: z.never().optional(),
+        email: z.string().email().describe("User email address"),
+    }),
+])
+    .describe("Reference to a user by either their id or email (but not both)");
 // Search variants tool input schema
 export const filterVariantsSchema = z.object({
     search_phrase: z
@@ -19,13 +28,13 @@ export const filterVariantsSchema = z.object({
         .array(userReferenceSchema)
         .min(1)
         .optional()
-        .describe("Array of references to users by their id or email"),
+        .describe("Array of references to users by their id or email (but not both per user)"),
     has_no_contributors: z
         .boolean()
         .optional()
         .describe("Filter for content item language variants that have no contributors assigned"),
     completion_statuses: z
-        .array(z.enum(["unfinished", "completed", "not_translated", "all_done"]))
+        .array(z.enum(["unfinished", "ready", "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"),
@@ -48,24 +57,26 @@ export const filterVariantsSchema = z.object({
         taxonomy_identifier: referenceObjectSchema.describe("Reference to a taxonomy group by its id, codename, or external id"),
         term_identifiers: z
             .array(referenceObjectSchema)
+            .optional()
             .describe("Array of references to taxonomy terms by their id, codename, or external id"),
         include_uncategorized: z
             .boolean()
+            .optional()
             .describe("Whether to include content item language variants that don't have any taxonomy terms assigned in this taxonomy group"),
     }))
         .min(1)
         .optional()
         .describe("Array of taxonomy groups with taxonomy terms"),
     order_by: z
-        .enum(["name", "due", "last_modified"])
+        .enum(["name", "due_date", "last_modified"])
         .optional()
         .describe("Field to order by"),
     order_direction: z
         .enum(["asc", "desc"])
         .optional()
         .describe("Order direction"),
-    continuation_token: z
-        .string()
+    include_content: z
+        .boolean()
         .optional()
-        .describe("Continuation token for pagination"),
+        .describe("Whether to include the full content of language variants in the response"),
 });

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

@@ -5,22 +5,22 @@ import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
 import { throwError } from "../utils/throwError.js";
 export const registerTool = (server) => {
     server.tool("filter-variants-mapi", `Filter Kontent.ai language variants of content items using Management API.
-    
+
     USE FOR:
     - EXACT keyword matching: finding specific words, phrases, names, codes, or IDs in content. Example: 'find items containing rabbit' → search 'rabbit'
     - Advanced filtering by content type, contributors, workflow steps, taxonomies etc
     - CAN expand concepts to keywords when using filter (e.g., "neurology-related" → "neurology neurological brain nervous system")
-    - Also use as fallback when AI search is unavailable`, filterVariantsSchema.shape, async ({ search_phrase, content_types, contributors, has_no_contributors, completion_statuses, language, workflow_steps, taxonomy_groups, order_by, order_direction, continuation_token, }, { authInfo: { token, clientId } = {} }) => {
+    - Also use as fallback when AI search is unavailable
+    - Optionally includes full content of variants with include_content parameter`, filterVariantsSchema.shape, async ({ search_phrase, content_types, contributors, has_no_contributors, completion_statuses, language, workflow_steps, taxonomy_groups, order_by, order_direction, include_content, }, { authInfo: { token, clientId } = {} }) => {
         try {
             const environmentId = clientId ?? process.env.KONTENT_ENVIRONMENT_ID;
             if (!environmentId) {
                 throwError("Missing required environment ID");
             }
-            const additionalHeaders = continuation_token
-                ? [{ header: "X-Continuation", value: continuation_token }]
-                : undefined;
-            const client = createMapiClient(environmentId, token, additionalHeaders);
-            const requestPayload = {
+            const client = createMapiClient(environmentId, token);
+            const response = await client.earlyAccess
+                .filterLanguageVariants()
+                .withData({
                 filters: {
                     search_phrase,
                     content_types,
@@ -34,19 +34,16 @@ export const registerTool = (server) => {
                 order: order_by
                     ? {
                         by: order_by,
-                        direction: order_direction === "desc" ? "Descending" : "Ascending",
+                        direction: order_direction || "asc",
                     }
-                    : null,
-            };
-            const response = await client
-                .post()
-                .withAction(`projects/${environmentId}/early-access/variants/filter`)
-                .withData(requestPayload)
-                .toPromise();
-            return createMcpToolSuccessResponse(response.data);
+                    : undefined,
+                include_content: include_content ?? false,
+            })
+                .toAllPromise();
+            return createMcpToolSuccessResponse(response.responses.flatMap((r) => r.rawData.data));
         }
         catch (error) {
-            return handleMcpToolError(error, "Variant Search");
+            return handleMcpToolError(error, "Variant Filter");
         }
     });
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kontent-ai/mcp-server",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "type": "module",
   "scripts": {
     "build": "rimraf build && tsc",
@@ -8,8 +8,8 @@
     "start:shttp": "node build/bin.js shttp",
     "dev:stdio": "tsx watch src/bin.ts stdio",
     "dev:shttp": "tsx watch src/bin.ts shttp",
-    "format": "cross-env node node_modules/@biomejs/biome/bin/biome ci ./ --config-path=./biome.json",
-    "format:fix": "cross-env node node_modules/@biomejs/biome/bin/biome check ./ --fix --unsafe  --config-path=./biome.json"
+    "format": "cross-env node node_modules/@biomejs/biome/bin/biome ci ./",
+    "format:fix": "cross-env node node_modules/@biomejs/biome/bin/biome check ./ --fix --unsafe"
   },
   "bin": {
     "@kontent-ai/mcp-server": "./build/bin.js"
@@ -21,7 +21,7 @@
   "author": "Jiri Lojda",
   "license": "MIT",
   "dependencies": {
-    "@kontent-ai/management-sdk": "^7.9.0",
+    "@kontent-ai/management-sdk": "^7.11.0",
     "@modelcontextprotocol/sdk": "^1.12.0",
     "applicationinsights": "^2.9.8",
     "dotenv": "^16.5.0",