@contentful/mcp-tools 0.1.2 → 0.2.0

package/dist/index.d.ts

@@ -4188,23 +4188,71 @@ declare class ContentfulMcpTools {
                     limit: zod.ZodOptional<zod.ZodNumber>;
                     skip: zod.ZodOptional<zod.ZodNumber>;
                     order: zod.ZodOptional<zod.ZodString>;
-                }, "strip", zod.ZodTypeAny, {
-                    skip?: number | undefined;
-                    limit?: number | undefined;
-                    select?: string | undefined;
-                    include?: number | undefined;
-                    order?: string | undefined;
-                    links_to_entry?: string | undefined;
-                    content_type?: string | undefined;
-                }, {
-                    skip?: number | undefined;
-                    limit?: number | undefined;
-                    select?: string | undefined;
-                    include?: number | undefined;
-                    order?: string | undefined;
-                    links_to_entry?: string | undefined;
-                    content_type?: string | undefined;
-                }>;
+                    query: zod.ZodOptional<zod.ZodString>;
+                    'fields.title': zod.ZodOptional<zod.ZodString>;
+                    'fields.slug': zod.ZodOptional<zod.ZodString>;
+                    'fields.internalName': zod.ZodOptional<zod.ZodString>;
+                    'fields.text': zod.ZodOptional<zod.ZodString>;
+                    'fields.title[match]': zod.ZodOptional<zod.ZodString>;
+                    'fields.slug[match]': zod.ZodOptional<zod.ZodString>;
+                    'fields.title[exists]': zod.ZodOptional<zod.ZodBoolean>;
+                    'fields.slug[exists]': zod.ZodOptional<zod.ZodBoolean>;
+                    'sys.id[in]': zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+                    'sys.contentType.sys.id': zod.ZodOptional<zod.ZodString>;
+                    'sys.createdAt[gte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.createdAt[lte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.updatedAt[gte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.updatedAt[lte]': zod.ZodOptional<zod.ZodString>;
+                    'metadata.tags.sys.id[in]': zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+                }, "strip", zod.ZodAny, zod.objectOutputType<{
+                    content_type: zod.ZodOptional<zod.ZodString>;
+                    include: zod.ZodOptional<zod.ZodNumber>;
+                    select: zod.ZodOptional<zod.ZodString>;
+                    links_to_entry: zod.ZodOptional<zod.ZodString>;
+                    limit: zod.ZodOptional<zod.ZodNumber>;
+                    skip: zod.ZodOptional<zod.ZodNumber>;
+                    order: zod.ZodOptional<zod.ZodString>;
+                    query: zod.ZodOptional<zod.ZodString>;
+                    'fields.title': zod.ZodOptional<zod.ZodString>;
+                    'fields.slug': zod.ZodOptional<zod.ZodString>;
+                    'fields.internalName': zod.ZodOptional<zod.ZodString>;
+                    'fields.text': zod.ZodOptional<zod.ZodString>;
+                    'fields.title[match]': zod.ZodOptional<zod.ZodString>;
+                    'fields.slug[match]': zod.ZodOptional<zod.ZodString>;
+                    'fields.title[exists]': zod.ZodOptional<zod.ZodBoolean>;
+                    'fields.slug[exists]': zod.ZodOptional<zod.ZodBoolean>;
+                    'sys.id[in]': zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+                    'sys.contentType.sys.id': zod.ZodOptional<zod.ZodString>;
+                    'sys.createdAt[gte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.createdAt[lte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.updatedAt[gte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.updatedAt[lte]': zod.ZodOptional<zod.ZodString>;
+                    'metadata.tags.sys.id[in]': zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+                }, zod.ZodAny, "strip">, zod.objectInputType<{
+                    content_type: zod.ZodOptional<zod.ZodString>;
+                    include: zod.ZodOptional<zod.ZodNumber>;
+                    select: zod.ZodOptional<zod.ZodString>;
+                    links_to_entry: zod.ZodOptional<zod.ZodString>;
+                    limit: zod.ZodOptional<zod.ZodNumber>;
+                    skip: zod.ZodOptional<zod.ZodNumber>;
+                    order: zod.ZodOptional<zod.ZodString>;
+                    query: zod.ZodOptional<zod.ZodString>;
+                    'fields.title': zod.ZodOptional<zod.ZodString>;
+                    'fields.slug': zod.ZodOptional<zod.ZodString>;
+                    'fields.internalName': zod.ZodOptional<zod.ZodString>;
+                    'fields.text': zod.ZodOptional<zod.ZodString>;
+                    'fields.title[match]': zod.ZodOptional<zod.ZodString>;
+                    'fields.slug[match]': zod.ZodOptional<zod.ZodString>;
+                    'fields.title[exists]': zod.ZodOptional<zod.ZodBoolean>;
+                    'fields.slug[exists]': zod.ZodOptional<zod.ZodBoolean>;
+                    'sys.id[in]': zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+                    'sys.contentType.sys.id': zod.ZodOptional<zod.ZodString>;
+                    'sys.createdAt[gte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.createdAt[lte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.updatedAt[gte]': zod.ZodOptional<zod.ZodString>;
+                    'sys.updatedAt[lte]': zod.ZodOptional<zod.ZodString>;
+                    'metadata.tags.sys.id[in]': zod.ZodOptional<zod.ZodArray<zod.ZodString, "many">>;
+                }, zod.ZodAny, "strip">>;
             };
             annotations: {
                 readOnlyHint: boolean;
@@ -4219,8 +4267,26 @@ declare class ContentfulMcpTools {
                     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;
+                    'fields.slug'?: string | undefined;
+                    'fields.internalName'?: string | undefined;
+                    'fields.text'?: string | undefined;
+                    'fields.title[match]'?: string | undefined;
+                    'fields.slug[match]'?: string | undefined;
+                    'fields.title[exists]'?: boolean | undefined;
+                    'fields.slug[exists]'?: boolean | undefined;
+                    'sys.id[in]'?: string[] | undefined;
+                    'sys.contentType.sys.id'?: string | undefined;
+                    'sys.createdAt[gte]'?: string | undefined;
+                    'sys.createdAt[lte]'?: string | undefined;
+                    'sys.updatedAt[gte]'?: string | undefined;
+                    'sys.updatedAt[lte]'?: string | undefined;
+                    'metadata.tags.sys.id[in]'?: string[] | undefined;
+                } & {
+                    [k: string]: any;
                 };
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
@@ -4611,6 +4677,7 @@ declare class ContentfulMcpTools {
             } & {
                 environmentId: zod.ZodString;
                 name: zod.ZodString;
+                sourceEnvironmentId: zod.ZodOptional<zod.ZodString>;
             };
             annotations: {
                 readOnlyHint: boolean;
@@ -4622,6 +4689,7 @@ declare class ContentfulMcpTools {
                 spaceId: string;
                 environmentId: string;
                 name: string;
+                sourceEnvironmentId?: string | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
         };
         listEnvironments: {

package/dist/index.js

@@ -2181,16 +2181,48 @@ function createEditorInterfaceTools(config) {
 
 // src/tools/entries/searchEntries.ts
 import { z as z35 } from "zod";
+
+// src/utils/limits.ts
+function searchLimit(userLimit) {
+  return Math.min(userLimit || 10, 1e3);
+}
+
+// src/tools/entries/searchEntries.ts
 var SearchEntriesToolParams = BaseToolSchema.extend({
   query: z35.object({
+    // Core parameters (maintain backward compatibility)
     content_type: z35.string().optional().describe("Filter by content type"),
     include: z35.number().optional().describe("Include this many levels of linked entries"),
     select: z35.string().optional().describe("Comma-separated list of fields to return"),
     links_to_entry: z35.string().optional().describe("Find entries that link to the specified entry ID"),
-    limit: z35.number().optional().describe("Maximum number of entries to return"),
-    skip: z35.number().optional().describe("Skip this many entries"),
-    order: z35.string().optional().describe("Order entries by this field")
-  })
+    limit: z35.number().optional().describe(
+      "Maximum number of entries to return (default: 10, max: 100)"
+    ),
+    skip: z35.number().optional().describe("Skip this many entries for pagination"),
+    order: z35.string().optional().describe("Order entries by this field"),
+    // Full-text search
+    query: z35.string().optional().describe("Full-text search across all fields"),
+    // Common field-based searches (examples - any field is supported via catchall)
+    "fields.title": z35.string().optional().describe("Search by title field"),
+    "fields.slug": z35.string().optional().describe("Search by slug field"),
+    "fields.internalName": z35.string().optional().describe("Search by internal name field"),
+    "fields.text": z35.string().optional().describe("Search by text field (useful for testimonials)"),
+    "fields.title[match]": z35.string().optional().describe("Pattern match on title field"),
+    "fields.slug[match]": z35.string().optional().describe("Pattern match on slug field"),
+    "fields.title[exists]": z35.boolean().optional().describe("Check if title field exists"),
+    "fields.slug[exists]": z35.boolean().optional().describe("Check if slug field exists"),
+    // System field searches
+    "sys.id[in]": z35.array(z35.string()).optional().describe("Search by multiple entry IDs"),
+    "sys.contentType.sys.id": z35.string().optional().describe("Filter by content type ID"),
+    "sys.createdAt[gte]": z35.string().optional().describe("Created after date (ISO format)"),
+    "sys.createdAt[lte]": z35.string().optional().describe("Created before date (ISO format)"),
+    "sys.updatedAt[gte]": z35.string().optional().describe("Updated after date (ISO format)"),
+    "sys.updatedAt[lte]": z35.string().optional().describe("Updated before date (ISO format)"),
+    // Metadata searches
+    "metadata.tags.sys.id[in]": z35.array(z35.string()).optional().describe("Filter by tag IDs")
+  }).catchall(z35.any()).describe(
+    "Flexible search parameters supporting ANY Contentful API query parameter. Use fields.* for field searches, sys.* for system fields, and any other Contentful API parameter."
+  )
 });
 function searchEntriesTool(config) {
   async function tool2(args) {
@@ -2203,12 +2235,12 @@ function searchEntriesTool(config) {
       ...params,
       query: {
         ...args.query,
-        limit: Math.min(args.query.limit || 3, 3),
+        limit: searchLimit(args.query.limit),
         skip: args.query.skip || 0
       }
     });
     const summarized = summarizeData(entries, {
-      maxItems: 3,
+      maxItems: searchLimit(args.query.limit),
       remainingMessage: "To see more entries, please ask me to retrieve the next page."
     });
     return createSuccessResponse("Entries retrieved successfully", {
@@ -2649,7 +2681,10 @@ function createEntryTools(config) {
 import { z as z44 } from "zod";
 var CreateEnvironmentToolParams = BaseToolSchema.extend({
   environmentId: z44.string().describe("The ID of the environment to create"),
-  name: z44.string().describe("The name of the environment to create")
+  name: z44.string().describe("The name of the environment to create"),
+  sourceEnvironmentId: z44.string().describe(
+    "The ID of the source environment to clone from (defaults to master)"
+  ).optional()
 });
 function createEnvironmentTool(config) {
   async function tool2(args) {
@@ -2661,7 +2696,8 @@ function createEnvironmentTool(config) {
       },
       {
         name: args.name
-      }
+      },
+      args.sourceEnvironmentId ? { "X-Contentful-Source-Environment": args.sourceEnvironmentId } : void 0
     );
     return createSuccessResponse("Environment created successfully", {
       environment
@@ -3517,12 +3553,12 @@ function updateConceptSchemeTool(config) {
       topConcepts: "/topConcepts"
     };
     const patchOperations = [];
-    Object.entries(fieldMappings).forEach(([field, path2]) => {
+    Object.entries(fieldMappings).forEach(([field, path]) => {
       const value = args[field];
       if (value !== void 0) {
         patchOperations.push({
           op: "replace",
-          path: path2,
+          path,
           value
         });
       }
@@ -4033,10 +4069,6 @@ var AssetQuerySchema = z69.object({
 });
 
 // src/tools/jobs/space-to-space-migration/exportSpace.ts
-import path from "path";
-import { createRequire } from "module";
-var require2 = createRequire(import.meta.url);
-var contentfulExport = require2("contentful-export");
 var ExportSpaceToolParams = BaseToolSchema.extend({
   exportDir: z70.string().optional().describe(
     "Directory to save the exported space data (optional, defaults to current directory)"
@@ -4086,7 +4118,9 @@ function createExportSpaceTool(config) {
       contentFile: args.contentFile || `contentful-export-${args.spaceId}.json`
     };
     try {
-      const result = await contentfulExport(exportOptions);
+      const contentfulExport = await import("contentful-export");
+      const path = await import("path");
+      const result = await contentfulExport.default(exportOptions);
       const exportPath = path.join(
         exportOptions.exportDir,
         exportOptions.contentFile
@@ -4294,9 +4328,6 @@ var createParamCollectionTool = withErrorHandling(
 
 // src/tools/jobs/space-to-space-migration/importSpace.ts
 import { z as z72 } from "zod";
-import { createRequire as createRequire2 } from "module";
-var require3 = createRequire2(import.meta.url);
-var contentfulImport = require3("contentful-import");
 var ImportSpaceToolParams = BaseToolSchema.extend({
   contentFile: z72.string().optional().describe("Path to JSON file containing the content to import"),
   content: z72.record(z72.any()).optional().describe(
@@ -4334,7 +4365,8 @@ function createImportSpaceTool(config) {
       environmentId: args.environmentId || "master"
     };
     try {
-      const result = await contentfulImport(importOptions);
+      const contentfulImport = await import("contentful-import");
+      const result = await contentfulImport.default(importOptions);
       return createSuccessResponse("Space imported successfully", {
         spaceId: args.spaceId,
         environmentId: args.environmentId || "master",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-tools",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -40,13 +40,13 @@
     "directory": "packages/mcp-tools"
   },
   "dependencies": {
+    "@contentful/rich-text-types": "^16.8.5",
     "@modelcontextprotocol/sdk": "^1.17.0",
     "contentful-export": "^7.21.78",
-    "contentful-import": "^9.4.111",
+    "contentful-import": "^9.4.129",
     "contentful-management": "^11.54.3",
     "fast-xml-parser": "^5.2.5",
     "outdent": "^0.8.0",
-    "@contentful/rich-text-types": "^16.8.5",
     "tsup": "^8.5.0",
     "vitest": "^3.2.4",
     "zod": "^3.25.76"