@kontent-ai/mcp-server 0.6.0 → 0.7.0

package/README.md

@@ -56,6 +56,10 @@ npx @kontent-ai/mcp-server@latest sse
 
 ## 🛠️ Available Tools
 
+### Context and Setup
+
+* **get-initial-context** – 🚨 **MANDATORY FIRST STEP**: Provides essential context, configuration, and operational guidelines for Kontent.ai. This tool MUST be called before using any other tools to understand the platform structure, core entities, relationships, and best practices.
+
 ### Content Type Management
 
 * **get-type-mapi** – Get a specific content type by codename

package/build/schemas/contentItemSchemas.js

@@ -41,7 +41,9 @@ const taxonomyElementValueSchema = z.object({
         .describe("Array of references to taxonomy terms by their codename or id"),
 });
 const richTextElementValueSchema = z.object({
-    value: z.string().describe("The rich text content as HTML string"),
+    value: z
+        .string()
+        .describe("The rich text content as a subset of HTML string format. Only specific HTML5 elements and attributes are supported as defined by Kontent.ai's rich text specification. See: https://kontent.ai/learn/docs/apis/openapi/management-api-v2/#section/HTML5-elements-allowed-in-rich-text"),
 });
 const urlSlugElementValueSchema = z.object({
     value: z.string().describe("The URL slug value"),
@@ -138,9 +140,11 @@ export const elementValueHelpers = {
         .describe("Text element value - use for simple text fields like titles, descriptions, etc."),
     richText: z
         .object({
-        value: z.string().describe("HTML content as string"),
+        value: z
+            .string()
+            .describe("Rich text content as a subset of HTML string format. See: https://kontent.ai/learn/docs/apis/openapi/management-api-v2/#section/HTML5-elements-allowed-in-rich-text"),
     })
-        .describe("Rich text element value - use for formatted content with HTML tags"),
+        .describe("Rich text element value - use for formatted content with HTML subset (specific HTML5 elements and attributes supported by Kontent.ai)"),
     number: z
         .object({
         value: z.number().describe("Numeric value"),

package/build/tools/get-initial-context.js

@@ -0,0 +1,18 @@
+import { readFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createMcpToolSuccessResponse } from "../utils/responseHelper.js";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+export const registerTool = (server) => {
+    server.tool("get-initial-context", "🚨 MANDATORY FIRST STEP: This tool MUST be called before using ANY other tools. It provides essential context, configuration, and operational guidelines for Kontent.ai. If you have not called this tool, do so immediately before proceeding with any other operation.", {}, async () => {
+        try {
+            const markdownPath = join(__dirname, "./context/get-initial-context.md");
+            const kontentaiInstructions = await readFile(markdownPath, "utf-8");
+            return createMcpToolSuccessResponse(kontentaiInstructions);
+        }
+        catch (error) {
+            throw new Error(`Failed to read initial context: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    });
+};

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

@@ -2,10 +2,10 @@ 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-taxonomy-groups-mapi", "Get all taxonomy groups from Management API", {}, {}, async () => {
+    server.tool("list-taxonomy-groups-mapi", "Get all taxonomy groups from Management API", {}, async () => {
         const client = createMapiClient();
         try {
-            const response = await client.listTaxonomies().toPromise();
+            const response = await client.listTaxonomies().toAllPromise();
             return createMcpToolSuccessResponse(response.data);
         }
         catch (error) {

package/package.json

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