@contentful/mcp-tools 0.3.0 → 0.3.1

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

@@ -3689,28 +3689,58 @@ function getConceptSchemeTool(config) {
 // src/tools/taxonomies/concept-schemes/listConceptSchemes.ts
 import { z as z63 } from "zod";
 import ctfl8 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 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 +3761,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");
@@ -4093,7 +4123,6 @@ 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"),
@@ -4124,7 +4153,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 +4178,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 +4202,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 +4305,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 +4328,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 +4378,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.3.1",
   "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 .",
@@ -46,12 +47,14 @@
     "contentful-import": "^9.4.129",
     "contentful-management": "^11.54.3",
     "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",