@contentful/mcp-tools 0.4.2 → 0.4.5

package/dist/index.d.ts

@@ -57,6 +57,10 @@ interface ContentfulConfig {
     appId?: string;
     /** Version number to use for MCP tool calls */
     mcpVersion: string;
+    /** Contentful CDA token for exporting only published content */
+    deliveryToken?: string;
+    /** Contentful Delivery API host (used with deliveryToken for custom CDA endpoints) */
+    hostDelivery?: string;
 }
 
 /**
@@ -5982,11 +5986,11 @@ declare class ContentfulMcpTools {
                     } | undefined;
                     downloadAssets?: boolean | undefined;
                     maxAllowedLimit?: number | undefined;
+                    errorLogFile?: string | undefined;
+                    useVerboseRenderer?: boolean | undefined;
                     deliveryToken?: string | undefined;
                     hostDelivery?: string | undefined;
                     rawProxy?: boolean | undefined;
-                    errorLogFile?: string | undefined;
-                    useVerboseRenderer?: boolean | undefined;
                 }, {
                     config?: string | undefined;
                     spaceId?: string | undefined;
@@ -6025,11 +6029,11 @@ declare class ContentfulMcpTools {
                     } | undefined;
                     downloadAssets?: boolean | undefined;
                     maxAllowedLimit?: number | undefined;
+                    errorLogFile?: string | undefined;
+                    useVerboseRenderer?: boolean | undefined;
                     deliveryToken?: string | undefined;
                     hostDelivery?: string | undefined;
                     rawProxy?: boolean | undefined;
-                    errorLogFile?: string | undefined;
-                    useVerboseRenderer?: boolean | undefined;
                 }>>;
                 import: zod.ZodOptional<zod.ZodObject<{
                     spaceId: zod.ZodOptional<zod.ZodString>;
@@ -6066,9 +6070,9 @@ declare class ContentfulMcpTools {
                     timeout?: number | undefined;
                     contentFile?: string | undefined;
                     skipContentModel?: boolean | undefined;
-                    rawProxy?: boolean | undefined;
                     errorLogFile?: string | undefined;
                     useVerboseRenderer?: boolean | undefined;
+                    rawProxy?: boolean | undefined;
                     contentModelOnly?: boolean | undefined;
                     skipLocales?: boolean | undefined;
                     skipContentUpdates?: boolean | undefined;
@@ -6089,9 +6093,9 @@ declare class ContentfulMcpTools {
                     timeout?: number | undefined;
                     contentFile?: string | undefined;
                     skipContentModel?: boolean | undefined;
-                    rawProxy?: boolean | undefined;
                     errorLogFile?: string | undefined;
                     useVerboseRenderer?: boolean | undefined;
+                    rawProxy?: boolean | undefined;
                     contentModelOnly?: boolean | undefined;
                     skipLocales?: boolean | undefined;
                     skipContentUpdates?: boolean | undefined;
@@ -6148,11 +6152,11 @@ declare class ContentfulMcpTools {
                     } | undefined;
                     downloadAssets?: boolean | undefined;
                     maxAllowedLimit?: number | undefined;
+                    errorLogFile?: string | undefined;
+                    useVerboseRenderer?: boolean | undefined;
                     deliveryToken?: string | undefined;
                     hostDelivery?: string | undefined;
                     rawProxy?: boolean | undefined;
-                    errorLogFile?: string | undefined;
-                    useVerboseRenderer?: boolean | undefined;
                 } | undefined;
                 import?: {
                     config?: string | undefined;
@@ -6166,9 +6170,9 @@ declare class ContentfulMcpTools {
                     timeout?: number | undefined;
                     contentFile?: string | undefined;
                     skipContentModel?: boolean | undefined;
-                    rawProxy?: boolean | undefined;
                     errorLogFile?: string | undefined;
                     useVerboseRenderer?: boolean | undefined;
+                    rawProxy?: boolean | undefined;
                     contentModelOnly?: boolean | undefined;
                     skipLocales?: boolean | undefined;
                     skipContentUpdates?: boolean | undefined;
@@ -6246,15 +6250,8 @@ declare class ContentfulMcpTools {
                 }>>;
                 downloadAssets: zod.ZodDefault<zod.ZodOptional<zod.ZodBoolean>>;
                 maxAllowedLimit: zod.ZodDefault<zod.ZodOptional<zod.ZodNumber>>;
-                deliveryToken: zod.ZodOptional<zod.ZodString>;
-                host: zod.ZodOptional<zod.ZodString>;
-                hostDelivery: zod.ZodOptional<zod.ZodString>;
-                proxy: zod.ZodOptional<zod.ZodString>;
-                rawProxy: zod.ZodOptional<zod.ZodBoolean>;
-                headers: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodString>>;
                 errorLogFile: zod.ZodOptional<zod.ZodString>;
                 useVerboseRenderer: zod.ZodOptional<zod.ZodBoolean>;
-                config: zod.ZodOptional<zod.ZodString>;
             };
             annotations: {
                 readOnlyHint: boolean;
@@ -6276,10 +6273,6 @@ declare class ContentfulMcpTools {
                 contentOnly: boolean;
                 downloadAssets: boolean;
                 maxAllowedLimit: number;
-                config?: string | undefined;
-                host?: string | undefined;
-                proxy?: string | undefined;
-                headers?: Record<string, string> | undefined;
                 exportDir?: string | undefined;
                 contentFile?: string | undefined;
                 queryEntries?: {
@@ -6298,9 +6291,6 @@ declare class ContentfulMcpTools {
                     order?: string | undefined;
                     mimetype_group?: string | undefined;
                 } | undefined;
-                deliveryToken?: string | undefined;
-                hostDelivery?: string | undefined;
-                rawProxy?: boolean | undefined;
                 errorLogFile?: string | undefined;
                 useVerboseRenderer?: boolean | undefined;
             }, extra?: _modelcontextprotocol_sdk_shared_protocol_js.RequestHandlerExtra<_modelcontextprotocol_sdk_types_js.ServerRequest, _modelcontextprotocol_sdk_types_js.ServerNotification>) => Promise<ToolResponse>;
@@ -6324,14 +6314,9 @@ declare class ContentfulMcpTools {
                 assetsDirectory: zod.ZodOptional<zod.ZodString>;
                 timeout: zod.ZodDefault<zod.ZodOptional<zod.ZodNumber>>;
                 retryLimit: zod.ZodDefault<zod.ZodOptional<zod.ZodNumber>>;
-                host: zod.ZodOptional<zod.ZodString>;
-                proxy: zod.ZodOptional<zod.ZodString>;
-                rawProxy: zod.ZodOptional<zod.ZodBoolean>;
                 rateLimit: zod.ZodDefault<zod.ZodOptional<zod.ZodNumber>>;
-                headers: zod.ZodOptional<zod.ZodRecord<zod.ZodString, zod.ZodAny>>;
                 errorLogFile: zod.ZodOptional<zod.ZodString>;
                 useVerboseRenderer: zod.ZodOptional<zod.ZodBoolean>;
-                config: zod.ZodOptional<zod.ZodString>;
             };
             annotations: {
                 readOnlyHint: boolean;
@@ -6352,13 +6337,8 @@ declare class ContentfulMcpTools {
                 uploadAssets: boolean;
                 skipAssetUpdates: boolean;
                 rateLimit: number;
-                config?: string | undefined;
                 content?: Record<string, any> | undefined;
-                host?: string | undefined;
-                proxy?: string | undefined;
-                headers?: Record<string, any> | undefined;
                 contentFile?: string | undefined;
-                rawProxy?: boolean | undefined;
                 errorLogFile?: string | undefined;
                 useVerboseRenderer?: boolean | undefined;
                 assetsDirectory?: string | undefined;

package/dist/index.js

@@ -2190,6 +2190,20 @@ function searchLimit(userLimit) {
   return Math.min(userLimit || 10, 1e3);
 }
 
+// src/utils/queryParams.ts
+function normalizeArrayFilters(query) {
+  const normalized = {};
+  let didConvert = false;
+  for (const key of Object.keys(query)) {
+    const value = query[key];
+    if (Array.isArray(value)) {
+      normalized[key] = value.join(",");
+      didConvert = true;
+    }
+  }
+  return didConvert ? { ...query, ...normalized } : query;
+}
+
 // src/tools/entries/searchEntries.ts
 var SearchEntriesToolParams = BaseToolSchema.extend({
   query: z35.object({
@@ -2236,11 +2250,11 @@ function searchEntriesTool(config) {
     const contentfulClient = createToolClient(config, args);
     const entries = await contentfulClient.entry.getMany({
       ...params,
-      query: {
+      query: normalizeArrayFilters({
         ...args.query,
         limit: searchLimit(args.query.limit),
         skip: args.query.skip || 0
-      }
+      })
     });
     const summarized = summarizeData(entries, {
       maxItems: searchLimit(args.query.limit),
@@ -2951,12 +2965,14 @@ function createEnvironmentTool(config) {
     const environment = await contentfulClient.environment.createWithId(
       {
         spaceId: args.spaceId,
-        environmentId: args.environmentId
+        environmentId: args.environmentId,
+        ...args.sourceEnvironmentId && {
+          sourceEnvironmentId: args.sourceEnvironmentId
+        }
       },
       {
         name: args.name
-      },
-      args.sourceEnvironmentId ? { "X-Contentful-Source-Environment": args.sourceEnvironmentId } : void 0
+      }
     );
     return createSuccessResponse("Environment created successfully", {
       environment
@@ -4378,15 +4394,8 @@ var ExportSpaceToolParams = BaseToolSchema.extend({
   ),
   downloadAssets: z72.boolean().optional().default(false).describe("Download actual asset files"),
   maxAllowedLimit: z72.number().optional().default(1e3).describe("Maximum number of items per request"),
-  deliveryToken: z72.string().optional().describe("CDA token to export only published content (excludes tags)"),
-  host: z72.string().optional().describe("Management API host"),
-  hostDelivery: z72.string().optional().describe("Delivery API host"),
-  proxy: z72.string().optional().describe("HTTP/HTTPS proxy config"),
-  rawProxy: z72.boolean().optional().describe("Pass raw proxy config directly to Axios"),
-  headers: z72.record(z72.string()).optional().describe("Additional headers to include in requests"),
   errorLogFile: z72.string().optional().describe("Path to error log output file"),
-  useVerboseRenderer: z72.boolean().optional().describe("Line-by-line logging, useful for CI"),
-  config: z72.string().optional().describe("Path to a JSON config file with all options")
+  useVerboseRenderer: z72.boolean().optional().describe("Line-by-line logging, useful for CI")
 });
 function createExportSpaceTool(config) {
   async function tool2(args) {
@@ -4398,6 +4407,9 @@ function createExportSpaceTool(config) {
     const exportOptions = {
       ...args,
       managementToken,
+      host: config.host ?? "api.contentful.com",
+      ...config.deliveryToken && { deliveryToken: config.deliveryToken },
+      ...config.hostDelivery && { hostDelivery: config.hostDelivery },
       environmentId: args.environmentId || "master",
       exportDir: args.exportDir || process.cwd(),
       contentFile: args.contentFile || `contentful-export-${args.spaceId}.json`
@@ -4628,14 +4640,9 @@ var ImportSpaceToolParams = BaseToolSchema.extend({
   assetsDirectory: z74.string().optional().describe("Path to directory containing exported asset files"),
   timeout: z74.number().optional().default(3e3).describe("Time between retries during asset processing (ms)"),
   retryLimit: z74.number().optional().default(10).describe("Max retries for asset processing"),
-  host: z74.string().optional().describe("Management API host"),
-  proxy: z74.string().optional().describe("HTTP/HTTPS proxy string (host:port or user:pass@host:port)"),
-  rawProxy: z74.boolean().optional().describe("Pass proxy config directly to Axios"),
   rateLimit: z74.number().optional().default(7).describe("Max requests per second to the API"),
-  headers: z74.record(z74.any()).optional().describe("Additional headers to attach to requests"),
   errorLogFile: z74.string().optional().describe("Path to error log file"),
-  useVerboseRenderer: z74.boolean().optional().describe("Line-by-line progress output (good for CI)"),
-  config: z74.string().optional().describe("Path to config JSON file (merged with CLI args)")
+  useVerboseRenderer: z74.boolean().optional().describe("Line-by-line progress output (good for CI)")
 });
 function createImportSpaceTool(config) {
   async function tool2(args) {
@@ -4647,6 +4654,7 @@ function createImportSpaceTool(config) {
     const importOptions = {
       ...args,
       managementToken,
+      host: config.host ?? "api.contentful.com",
       environmentId: args.environmentId || "master"
     };
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-tools",
-  "version": "0.4.2",
+  "version": "0.4.5",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",