@contentful/mcp-tools 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -4268,12 +4268,12 @@ declare class ContentfulMcpTools {
                 spaceId: string;
                 environmentId: string;
                 query: {
+                    query?: string | undefined;
                     skip?: number | undefined;
                     limit?: number | undefined;
                     select?: string | undefined;
                     include?: number | undefined;
                     order?: string | undefined;
-                    query?: string | undefined;
                     links_to_entry?: string | undefined;
                     content_type?: string | undefined;
                     'fields.title'?: string | undefined;
@@ -5479,7 +5479,6 @@ declare class ContentfulMcpTools {
                 organizationId: zod.ZodString;
                 conceptId: zod.ZodOptional<zod.ZodString>;
                 limit: zod.ZodOptional<zod.ZodNumber>;
-                skip: zod.ZodOptional<zod.ZodNumber>;
                 select: zod.ZodOptional<zod.ZodString>;
                 include: zod.ZodOptional<zod.ZodNumber>;
                 order: zod.ZodOptional<zod.ZodString>;
@@ -5493,7 +5492,6 @@ declare class ContentfulMcpTools {
             };
             tool: (params: {
                 organizationId: string;
-                skip?: number | undefined;
                 limit?: number | undefined;
                 select?: string | undefined;
                 include?: number | undefined;
@@ -5723,11 +5721,34 @@ declare class ContentfulMcpTools {
             description: string;
             inputParams: {
                 organizationId: zod.ZodString;
-                limit: zod.ZodOptional<zod.ZodNumber>;
-                skip: zod.ZodOptional<zod.ZodNumber>;
-                select: zod.ZodOptional<zod.ZodString>;
-                include: zod.ZodOptional<zod.ZodNumber>;
-                order: zod.ZodOptional<zod.ZodString>;
+                query: zod.ZodOptional<zod.ZodUnion<[zod.ZodObject<{
+                    query: zod.ZodOptional<zod.ZodString>;
+                    pageNext: zod.ZodOptional<zod.ZodString>;
+                    pagePrev: zod.ZodOptional<zod.ZodString>;
+                    limit: zod.ZodOptional<zod.ZodNumber>;
+                    order: zod.ZodOptional<zod.ZodString>;
+                    skip: zod.ZodOptional<zod.ZodNever>;
+                }, "passthrough", zod.ZodTypeAny, zod.objectOutputType<{
+                    query: zod.ZodOptional<zod.ZodString>;
+                    pageNext: zod.ZodOptional<zod.ZodString>;
+                    pagePrev: zod.ZodOptional<zod.ZodString>;
+                    limit: zod.ZodOptional<zod.ZodNumber>;
+                    order: zod.ZodOptional<zod.ZodString>;
+                    skip: zod.ZodOptional<zod.ZodNever>;
+                }, zod.ZodTypeAny, "passthrough">, zod.objectInputType<{
+                    query: zod.ZodOptional<zod.ZodString>;
+                    pageNext: zod.ZodOptional<zod.ZodString>;
+                    pagePrev: zod.ZodOptional<zod.ZodString>;
+                    limit: zod.ZodOptional<zod.ZodNumber>;
+                    order: zod.ZodOptional<zod.ZodString>;
+                    skip: zod.ZodOptional<zod.ZodNever>;
+                }, zod.ZodTypeAny, "passthrough">>, zod.ZodObject<{
+                    pageUrl: zod.ZodOptional<zod.ZodString>;
+                }, "strip", zod.ZodTypeAny, {
+                    pageUrl?: string | undefined;
+                }, {
+                    pageUrl?: string | undefined;
+                }>]>>;
             };
             annotations: {
                 readOnlyHint: boolean;
@@ -5735,11 +5756,16 @@ declare class ContentfulMcpTools {
             };
             tool: (params: {
                 organizationId: string;
-                skip?: number | undefined;
-                limit?: number | undefined;
-                select?: string | undefined;
-                include?: number | undefined;
-                order?: string | undefined;
+                query?: zod.objectOutputType<{
+                    query: zod.ZodOptional<zod.ZodString>;
+                    pageNext: zod.ZodOptional<zod.ZodString>;
+                    pagePrev: zod.ZodOptional<zod.ZodString>;
+                    limit: zod.ZodOptional<zod.ZodNumber>;
+                    order: zod.ZodOptional<zod.ZodString>;
+                    skip: zod.ZodOptional<zod.ZodNever>;
+                }, zod.ZodTypeAny, "passthrough"> | {
+                    pageUrl?: string | undefined;
+                } | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
         updateConceptScheme: {

package/dist/index.js

@@ -54,7 +54,7 @@ function withErrorHandling(handler, errorPrefix = "Error") {
 }
 
 // src/utils/tools.ts
-import ctfl from "contentful-management";
+import { createClient } from "contentful-management";
 import { z } from "zod";
 var BaseToolSchema = z.object({
   spaceId: z.string().describe("The ID of the Contentful space"),
@@ -69,7 +69,7 @@ function createToolClient(config, params) {
       "X-Contentful-User-Agent-Tool": `contentful-mcp/${config.mcpVersion}`
     }
   };
-  return ctfl.createClient(clientConfig, { type: "plain" });
+  return createClient(clientConfig);
 }
 function createClientConfig(config) {
   const clientConfig = {
@@ -750,7 +750,9 @@ var AssetMetadataSchema = z13.object({
 var FileSchema = z14.object({
   fileName: z14.string().describe("The name of the file"),
   contentType: z14.string().describe("The MIME type of the file"),
-  upload: z14.string().optional().describe("The upload URL or file data")
+  upload: z14.string().optional().describe(
+    "The file source. Accepts either a publicly accessible https:// URL, or a base64-encoded data URI (e.g. data:image/png;base64,...). Use the data URI format to upload local files \u2014 the MCP client should base64-encode the file before passing it here."
+  )
 });
 var UploadAssetToolParams = BaseToolSchema.extend({
   title: z14.string().describe("The title of the asset"),
@@ -769,11 +771,37 @@ function uploadAssetTool(config) {
     };
     const contentfulClient = createToolClient(config, args);
     const locale = args.locale || "en-US";
+    const fileField = {
+      fileName: args.file.fileName,
+      contentType: args.file.contentType
+    };
+    if (args.file.upload?.startsWith("data:")) {
+      const commaIndex = args.file.upload.indexOf(",");
+      if (commaIndex === -1) {
+        throw new Error(
+          "Invalid data URI format. Expected data:<mime>;base64,<data>"
+        );
+      }
+      const base64 = args.file.upload.slice(commaIndex + 1);
+      const decoded = Buffer.from(base64, "base64");
+      const buffer = decoded.buffer.slice(
+        decoded.byteOffset,
+        decoded.byteOffset + decoded.byteLength
+      );
+      const upload = await contentfulClient.upload.create(params, {
+        file: buffer
+      });
+      fileField.uploadFrom = {
+        sys: { type: "Link", linkType: "Upload", id: upload.sys.id }
+      };
+    } else if (args.file.upload) {
+      fileField.upload = args.file.upload;
+    }
     const assetProps = {
       fields: {
         title: { [locale]: args.title },
         description: args.description ? { [locale]: args.description } : void 0,
-        file: { [locale]: args.file }
+        file: { [locale]: fileField }
       },
       metadata: args.metadata
     };
@@ -1260,7 +1288,7 @@ function createAssetTools(config) {
   return {
     uploadAsset: {
       title: "upload_asset",
-      description: "Upload a new asset",
+      description: "Upload a new asset. When uploading local binary files as base64, always re-encode from the source file immediately before the tool call \u2014 never re-use base64 from a previous tool output or from context.",
       inputParams: UploadAssetToolParams.shape,
       annotations: {
         readOnlyHint: false,
@@ -3300,7 +3328,7 @@ function createLocaleTools(config) {
 
 // src/tools/orgs/listOrgs.ts
 import { z as z54 } from "zod";
-import ctfl2 from "contentful-management";
+import { createClient as createClient2 } from "contentful-management";
 var ListOrgsToolParams = z54.object({
   limit: z54.number().optional().describe("Maximum number of organizations to return (max 10)"),
   skip: z54.number().optional().describe("Skip this many organizations for pagination"),
@@ -3311,7 +3339,7 @@ function listOrgsTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl2.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient2(clientConfig);
     const organizations = await contentfulClient.organization.getAll({
       query: {
         limit: Math.min(args.limit || 10, 10),
@@ -3348,7 +3376,7 @@ function listOrgsTool(config) {
 
 // src/tools/orgs/getOrg.ts
 import { z as z55 } from "zod";
-import ctfl3 from "contentful-management";
+import { createClient as createClient3 } from "contentful-management";
 var GetOrgToolParams = z55.object({
   organizationId: z55.string().describe("The ID of the organization to retrieve")
 });
@@ -3356,7 +3384,7 @@ function getOrgTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl3.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient3(clientConfig);
     const organization = await contentfulClient.organization.get({
       organizationId: args.organizationId
     });
@@ -3397,7 +3425,7 @@ function createOrgTools(config) {
 
 // src/tools/spaces/listSpaces.ts
 import { z as z56 } from "zod";
-import ctfl4 from "contentful-management";
+import { createClient as createClient4 } from "contentful-management";
 var ListSpacesToolParams = z56.object({
   limit: z56.number().optional().describe("Maximum number of spaces to return (max 10)"),
   skip: z56.number().optional().describe("Skip this many spaces for pagination"),
@@ -3408,7 +3436,7 @@ function listSpacesTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl4.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient4(clientConfig);
     const spaces = await contentfulClient.space.getMany({
       query: {
         limit: Math.min(args.limit || 10, 10),
@@ -3445,7 +3473,7 @@ function listSpacesTool(config) {
 
 // src/tools/spaces/getSpace.ts
 import { z as z57 } from "zod";
-import ctfl5 from "contentful-management";
+import { createClient as createClient5 } from "contentful-management";
 var GetSpaceToolParams = z57.object({
   spaceId: z57.string().describe("The ID of the space to retrieve")
 });
@@ -3453,7 +3481,7 @@ function getSpaceTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl5.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient5(clientConfig);
     const space = await contentfulClient.space.get({
       spaceId: args.spaceId
     });
@@ -3597,7 +3625,7 @@ function createTagTools(config) {
 
 // src/tools/taxonomies/concept-schemes/createConceptScheme.ts
 import { z as z61 } from "zod";
-import ctfl6 from "contentful-management";
+import { createClient as createClient6 } from "contentful-management";
 
 // src/types/conceptPayloadTypes.ts
 import { z as z60 } from "zod";
@@ -3629,7 +3657,7 @@ function createConceptSchemeTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl6.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient6(clientConfig);
     const conceptSchemePayload = {
       prefLabel: args.prefLabel,
       ...Object.fromEntries(
@@ -3664,7 +3692,7 @@ function createConceptSchemeTool(config) {
 
 // src/tools/taxonomies/concept-schemes/getConceptScheme.ts
 import { z as z62 } from "zod";
-import ctfl7 from "contentful-management";
+import { createClient as createClient7 } from "contentful-management";
 var GetConceptSchemeToolParams = z62.object({
   organizationId: z62.string().describe("The ID of the Contentful organization"),
   conceptSchemeId: z62.string().describe("The ID of the concept scheme to retrieve")
@@ -3673,7 +3701,7 @@ function getConceptSchemeTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl7.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient7(clientConfig);
     const params = {
       organizationId: args.organizationId,
       conceptSchemeId: args.conceptSchemeId
@@ -3688,29 +3716,59 @@ function getConceptSchemeTool(config) {
 
 // src/tools/taxonomies/concept-schemes/listConceptSchemes.ts
 import { z as z63 } from "zod";
-import ctfl8 from "contentful-management";
+import { createClient as createClient8 } from "contentful-management";
+import { cloneDeep } from "lodash-es";
 var ListConceptSchemesToolParams = z63.object({
-  organizationId: z63.string().describe("The ID of the Contentful organization"),
-  limit: z63.number().optional().describe("Maximum number of concept schemes to return"),
-  skip: z63.number().optional().describe("Skip this many concept schemes for pagination"),
-  select: z63.string().optional().describe("Comma-separated list of fields to return"),
-  include: z63.number().optional().describe("Include this many levels of linked entries"),
-  order: z63.string().optional().describe("Order concept schemes by this field")
-});
+  organizationId: z63.string(),
+  query: z63.union([
+    z63.object({
+      query: z63.string().optional(),
+      pageNext: z63.string().optional().describe("Cursor token for the next page of concept schemes"),
+      pagePrev: z63.string().optional().describe(
+        "Cursor token for the previous page of concept schemes"
+      ),
+      limit: z63.number().optional().describe("Maximum number of concept schemes to return"),
+      order: z63.string().optional().describe("Order concept schemes by this field"),
+      skip: z63.never().optional()
+    }).passthrough(),
+    // handles [key: string]: any from BasicQueryOptions
+    z63.object({
+      pageUrl: z63.string().optional()
+    })
+  ]).optional().describe(
+    'Query parameters for listing concept schemes, supports either pageUrl for cursor-based pagination.  Offset "skip" pagination is not supported.'
+  )
+}).describe(
+  "Parameters for listing concept schemes, cursor-based pagination is strictly enforced"
+);
 function listConceptSchemesTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl8.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient8(clientConfig);
+    const query = {};
+    if (args.query) {
+      if ("pageUrl" in args.query && args.query.pageUrl) {
+        query["pageUrl"] = args.query.pageUrl;
+      } else {
+        const complexQuery = cloneDeep(args.query);
+        if (complexQuery["query"]) query["query"] = complexQuery["query"];
+        if (complexQuery["pageNext"])
+          query["pageNext"] = complexQuery["pageNext"];
+        if (complexQuery["pagePrev"])
+          query["pagePrev"] = complexQuery["pagePrev"];
+        if (complexQuery["select"]) query["select"] = complexQuery["select"];
+        if (complexQuery["include"]) query["include"] = complexQuery["include"];
+        if (complexQuery["order"]) query["order"] = complexQuery["order"];
+        if (complexQuery["limit"]) query["limit"] = complexQuery["limit"];
+      }
+    }
+    if (!query["limit"] && !query["pageUrl"]) {
+      query["limit"] = 10;
+    }
     const conceptSchemes = await contentfulClient.conceptScheme.getMany({
       organizationId: args.organizationId,
-      query: {
-        limit: args.limit || 10,
-        skip: args.skip || 0,
-        ...args.select && { select: args.select },
-        ...args.include && { include: args.include },
-        ...args.order && { order: args.order }
-      }
+      query
     });
     const summarizedConceptSchemes = conceptSchemes.items.map(
       (conceptScheme) => ({
@@ -3731,14 +3789,14 @@ function listConceptSchemesTool(config) {
       },
       {
         maxItems: 10,
-        remainingMessage: "To see more concept schemes, please ask me to retrieve the next page using the skip parameter."
+        remainingMessage: "To see more concept schemes, please ask me to retrieve the next page using cursor based pagination with pageNext and pagePrev."
       }
     );
+    const queryLimit = args.query && "limit" in args.query ? args.query.limit : void 0;
     return createSuccessResponse("Concept schemes retrieved successfully", {
       conceptSchemes: summarized,
       total: conceptSchemes.total || conceptSchemes.items.length,
-      limit: conceptSchemes.limit || args.limit || 10,
-      skip: conceptSchemes.skip || args.skip || 0
+      limit: conceptSchemes.limit || queryLimit || 10
     });
   }
   return withErrorHandling(tool2, "Error listing concept schemes");
@@ -3746,7 +3804,7 @@ function listConceptSchemesTool(config) {
 
 // src/tools/taxonomies/concept-schemes/updateConceptScheme.ts
 import { z as z64 } from "zod";
-import ctfl9 from "contentful-management";
+import { createClient as createClient9 } from "contentful-management";
 var UpdateConceptSchemeToolParams = z64.object({
   organizationId: z64.string().describe("The ID of the Contentful organization"),
   conceptSchemeId: z64.string().describe("The ID of the concept scheme to update"),
@@ -3768,7 +3826,7 @@ function updateConceptSchemeTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl9.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient9(clientConfig);
     const params = {
       organizationId: args.organizationId,
       conceptSchemeId: args.conceptSchemeId
@@ -3795,11 +3853,11 @@ function updateConceptSchemeTool(config) {
       }
     });
     if (args.uri !== void 0) {
-      patchOperations.push({
-        op: args.uri === null ? "remove" : "replace",
-        path: "/uri",
-        ...args.uri !== null && { value: args.uri }
-      });
+      if (args.uri === null) {
+        patchOperations.push({ op: "remove", path: "/uri" });
+      } else {
+        patchOperations.push({ op: "replace", path: "/uri", value: args.uri });
+      }
     }
     if (args.addConcept) {
       const conceptLink = {
@@ -3820,7 +3878,7 @@ function updateConceptSchemeTool(config) {
         value: conceptLink
       });
     }
-    const updatedConceptScheme = await contentfulClient.conceptScheme.update(
+    const updatedConceptScheme = await contentfulClient.conceptScheme.patch(
       {
         ...params,
         version: args.version
@@ -3836,7 +3894,7 @@ function updateConceptSchemeTool(config) {
 
 // src/tools/taxonomies/concept-schemes/deleteConceptScheme.ts
 import { z as z65 } from "zod";
-import ctfl10 from "contentful-management";
+import { createClient as createClient10 } from "contentful-management";
 var DeleteConceptSchemeToolParams = z65.object({
   organizationId: z65.string().describe("The ID of the Contentful organization"),
   conceptSchemeId: z65.string().describe("The ID of the concept scheme to delete"),
@@ -3846,7 +3904,7 @@ function deleteConceptSchemeTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl10.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient10(clientConfig);
     await contentfulClient.conceptScheme.delete({
       organizationId: args.organizationId,
       conceptSchemeId: args.conceptSchemeId,
@@ -3928,7 +3986,7 @@ function createConceptSchemeTools(config) {
 
 // src/tools/taxonomies/concepts/createConcept.ts
 import { z as z66 } from "zod";
-import ctfl11 from "contentful-management";
+import { createClient as createClient11 } from "contentful-management";
 var CreateConceptToolParams = z66.object({
   organizationId: z66.string().describe("The ID of the Contentful organization"),
   conceptId: z66.string().optional().describe(
@@ -3952,7 +4010,7 @@ function createConceptTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl11.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient11(clientConfig);
     const conceptPayload = {
       prefLabel: args.prefLabel,
       ...args.uri !== void 0 && { uri: args.uri },
@@ -3982,7 +4040,7 @@ function createConceptTool(config) {
 
 // src/tools/taxonomies/concepts/deleteConcept.ts
 import { z as z67 } from "zod";
-import ctfl12 from "contentful-management";
+import { createClient as createClient12 } from "contentful-management";
 var DeleteConceptToolParams = z67.object({
   organizationId: z67.string().describe("The ID of the Contentful organization"),
   conceptId: z67.string().describe("The ID of the concept to delete"),
@@ -3992,7 +4050,7 @@ function deleteConceptTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl12.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient12(clientConfig);
     await contentfulClient.concept.delete({
       organizationId: args.organizationId,
       conceptId: args.conceptId,
@@ -4007,7 +4065,7 @@ function deleteConceptTool(config) {
 
 // src/tools/taxonomies/concepts/updateConcept.ts
 import { z as z68 } from "zod";
-import ctfl13 from "contentful-management";
+import { createClient as createClient13 } from "contentful-management";
 var UpdateConceptToolParams = z68.object({
   organizationId: z68.string().describe("The ID of the Contentful organization"),
   conceptId: z68.string().describe("The ID of the concept to update"),
@@ -4030,7 +4088,7 @@ function updateConceptTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl13.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient13(clientConfig);
     const existingConcept = await contentfulClient.concept.get({
       organizationId: args.organizationId,
       conceptId: args.conceptId
@@ -4050,7 +4108,7 @@ function updateConceptTool(config) {
       broader: args.broader ?? existingConcept.broader,
       related: args.related ?? existingConcept.related
     };
-    const updatedConcept = await contentfulClient.concept.updatePut(
+    const updatedConcept = await contentfulClient.concept.update(
       {
         organizationId: args.organizationId,
         conceptId: args.conceptId,
@@ -4067,7 +4125,7 @@ function updateConceptTool(config) {
 
 // src/tools/taxonomies/concepts/getConcept.ts
 import { z as z69 } from "zod";
-import ctfl14 from "contentful-management";
+import { createClient as createClient14 } from "contentful-management";
 var GetConceptToolParams = z69.object({
   organizationId: z69.string().describe("The ID of the Contentful organization"),
   conceptId: z69.string().describe("The ID of the concept to retrieve")
@@ -4076,7 +4134,7 @@ function getConceptTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl14.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient14(clientConfig);
     const concept = await contentfulClient.concept.get({
       organizationId: args.organizationId,
       conceptId: args.conceptId
@@ -4088,12 +4146,11 @@ function getConceptTool(config) {
 
 // src/tools/taxonomies/concepts/listConcepts.ts
 import { z as z70 } from "zod";
-import ctfl15 from "contentful-management";
+import { createClient as createClient15 } from "contentful-management";
 var ListConceptsToolParams = z70.object({
   organizationId: z70.string().describe("The ID of the Contentful organization"),
   conceptId: z70.string().optional().describe("The ID of the concept (required for descendants/ancestors)"),
   limit: z70.number().optional().describe("Maximum number of concepts to return"),
-  skip: z70.number().optional().describe("Skip this many concepts for pagination"),
   select: z70.string().optional().describe("Comma-separated list of fields to return"),
   include: z70.number().optional().describe("Include this many levels of linked entries"),
   order: z70.string().optional().describe("Order concepts by this field"),
@@ -4105,7 +4162,7 @@ function listConceptsTool(config) {
   async function tool2(args) {
     const clientConfig = createClientConfig(config);
     delete clientConfig.space;
-    const contentfulClient = ctfl15.createClient(clientConfig, { type: "plain" });
+    const contentfulClient = createClient15(clientConfig);
     if ((args.getDescendants || args.getAncestors) && !args.conceptId) {
       throw new Error(
         "conceptId is required when getting descendants or ancestors"
@@ -4124,7 +4181,6 @@ function listConceptsTool(config) {
         organizationId: args.organizationId,
         conceptId: args.conceptId,
         ...args.limit && { limit: args.limit },
-        ...args.skip && { skip: args.skip },
         ...args.select && { select: args.select },
         ...args.include && { include: args.include },
         ...args.order && { order: args.order }
@@ -4150,7 +4206,6 @@ function listConceptsTool(config) {
         organizationId: args.organizationId,
         conceptId: args.conceptId,
         ...args.limit && { limit: args.limit },
-        ...args.skip && { skip: args.skip },
         ...args.select && { select: args.select },
         ...args.include && { include: args.include },
         ...args.order && { order: args.order }
@@ -4175,7 +4230,6 @@ function listConceptsTool(config) {
       organizationId: args.organizationId,
       query: {
         limit: args.limit || 10,
-        skip: args.skip || 0,
         ...args.select && { select: args.select },
         ...args.include && { include: args.include },
         ...args.order && { order: args.order }
@@ -4279,6 +4333,8 @@ function createTaxonomyTools(config) {
 
 // src/tools/jobs/space-to-space-migration/exportSpace.ts
 import { z as z72 } from "zod";
+import * as contentfulExportModule from "contentful-export";
+import { join } from "path";
 
 // src/types/querySchema.ts
 import { z as z71 } from "zod";
@@ -4300,6 +4356,7 @@ var AssetQuerySchema = z71.object({
 });
 
 // src/tools/jobs/space-to-space-migration/exportSpace.ts
+var contentfulExport = contentfulExportModule.default ?? contentfulExportModule;
 var ExportSpaceToolParams = BaseToolSchema.extend({
   exportDir: z72.string().optional().describe(
     "Directory to save the exported space data (optional, defaults to current directory)"
@@ -4349,10 +4406,8 @@ function createExportSpaceTool(config) {
       contentFile: args.contentFile || `contentful-export-${args.spaceId}.json`
     };
     try {
-      const contentfulExport = await import("contentful-export");
-      const path = await import("path");
-      const result = await contentfulExport.default(exportOptions);
-      const exportPath = path.join(
+      const result = await contentfulExport(exportOptions);
+      const exportPath = join(
         exportOptions.exportDir,
         exportOptions.contentFile
       );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-tools",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -27,6 +27,7 @@
     "dev": "tsup --watch",
     "test": "vitest",
     "test:run": "vitest run",
+    "typecheck": "tsc --noEmit -p tsconfig.lib.json && tsc --noEmit -p tsconfig.spec.json",
     "format": "prettier --check \"**/*.{ts,js,json,md}\"",
     "format:fix": "prettier --write \"**/*.{ts,js,json,md}\"",
     "lint": "eslint --ext .ts,.js .",
@@ -44,14 +45,16 @@
     "@modelcontextprotocol/sdk": "^1.26.0",
     "contentful-export": "^7.21.78",
     "contentful-import": "^9.4.129",
-    "contentful-management": "^11.54.3",
+    "contentful-management": "^12.2.0",
     "fast-xml-parser": "^5.3.8",
+    "lodash-es": "^4.17.23",
     "outdent": "^0.8.0",
     "tsup": "^8.5.0",
     "vitest": "^3.2.4",
     "zod": "^3.25.76"
   },
   "devDependencies": {
+    "@types/lodash-es": "^4.17.12",
     "@types/node": "^22.16.5",
     "eslint": "^9.35.0",
     "prettier": "^3.6.2",