@contentful/mcp-tools 0.3.1 → 0.4.0

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,7 +3716,7 @@ 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(),
@@ -3717,7 +3745,7 @@ 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) {
@@ -3776,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"),
@@ -3798,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
@@ -3825,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 = {
@@ -3850,7 +3878,7 @@ function updateConceptSchemeTool(config) {
         value: conceptLink
       });
     }
-    const updatedConceptScheme = await contentfulClient.conceptScheme.update(
+    const updatedConceptScheme = await contentfulClient.conceptScheme.patch(
       {
         ...params,
         version: args.version
@@ -3866,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"),
@@ -3876,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,
@@ -3958,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(
@@ -3982,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 },
@@ -4012,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"),
@@ -4022,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,
@@ -4037,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"),
@@ -4060,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
@@ -4080,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,
@@ -4097,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")
@@ -4106,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
@@ -4118,7 +4146,7 @@ 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)"),
@@ -4134,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"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentful/mcp-tools",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
@@ -45,7 +45,7 @@
     "@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",