@contentful/mcp-tools 0.12.6 → 0.12.7

package/dist/index.d.ts

@@ -64,6 +64,8 @@ interface ContentfulConfig {
     appId?: string;
     /** Version number to use for MCP tool calls */
     mcpVersion: string;
+    /** Which MCP server surface is issuing the call. Threaded into the client-identifying headers for Datadog attribution. Defaults to 'local' when unset. */
+    mcpSource?: 'local' | 'remote';
     /** Contentful CDA token for exporting only published content */
     deliveryToken?: string;
     /** Contentful Delivery API host (used with deliveryToken for custom CDA endpoints) */

package/dist/index.js

@@ -60,23 +60,34 @@ var BaseToolSchema = z.object({
   spaceId: z.string().describe("The ID of the Contentful space"),
   environmentId: z.string().describe("The ID of the Contentful environment")
 });
-function createToolClient(config, params) {
+function buildUserAgentToolValue(config, options) {
+  const source = config.mcpSource ?? "local";
+  return `contentful-mcp${options?.exo ? "-exo" : ""}/${source}-${config.mcpVersion}`;
+}
+function createToolClient(config, params, options) {
+  const userAgentTool = buildUserAgentToolValue(config, options);
   const clientConfig = {
     accessToken: config.accessToken,
     host: config.host ?? "api.contentful.com",
     space: params.spaceId ?? config.spaceId,
     headers: {
-      "X-Contentful-User-Agent-Tool": `contentful-mcp/${config.mcpVersion}`
+      "X-Contentful-User-Agent-Tool": userAgentTool,
+      "User-Agent": userAgentTool
     }
   };
   return createClient(clientConfig);
 }
+function createExoToolClient(config, params) {
+  return createToolClient(config, params, { exo: true });
+}
 function createClientConfig(config) {
+  const userAgentTool = buildUserAgentToolValue(config);
   const clientConfig = {
     accessToken: config.accessToken,
     host: config.host ?? "api.contentful.com",
     headers: {
-      "X-Contentful-User-Agent-Tool": `contentful-mcp/${config.mcpVersion}`
+      "X-Contentful-User-Agent-Tool": userAgentTool,
+      "User-Agent": userAgentTool
     }
   };
   return clientConfig;
@@ -5832,7 +5843,7 @@ var GetComponentToolParams = BaseToolSchema.extend({
 });
 function getComponentTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const component = await contentfulClient.component.get({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -5855,7 +5866,7 @@ var ListComponentsToolParams = BaseToolSchema.extend({
 });
 function listComponentsTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const cursorParam = args.pageNext ? { pageNext: args.pageNext } : args.pagePrev ? { pagePrev: args.pagePrev } : {};
     const components = await contentfulClient.component.getMany({
       spaceId: args.spaceId,
@@ -6190,7 +6201,7 @@ function createComponentTool(config) {
       args.environmentId,
       config.protectedEnvironments
     );
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const component = await contentfulClient.component.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
       {
@@ -6240,7 +6251,7 @@ function upsertComponentTool(config) {
       environmentId: args.environmentId,
       componentId: args.componentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.component.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -6292,7 +6303,7 @@ function deleteComponentTool(config) {
       environmentId: args.environmentId,
       componentId: args.componentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const component = await contentfulClient.component.get(params);
     const expectedToken = buildConfirmToken(
       "component",
@@ -6337,7 +6348,7 @@ function publishComponentTool(config) {
       environmentId: args.environmentId,
       componentId: args.componentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.component.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -6374,7 +6385,7 @@ function unpublishComponentTool(config) {
       environmentId: args.environmentId,
       componentId: args.componentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.component.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -6494,7 +6505,7 @@ var GetExperienceFragmentToolParams = BaseToolSchema.extend({
 });
 function getExperienceFragmentTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceFragment = await contentfulClient.experienceFragment.get({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -6517,7 +6528,7 @@ var ListExperienceFragmentsToolParams = BaseToolSchema.extend({
 });
 function listExperienceFragmentsTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceFragments = await contentfulClient.experienceFragment.getMany({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -6568,7 +6579,7 @@ function createExperienceFragmentTool(config) {
       args.environmentId,
       config.protectedEnvironments
     );
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceFragment = await contentfulClient.experienceFragment.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
       {
@@ -6619,7 +6630,7 @@ function updateExperienceFragmentTool(config) {
       environmentId: args.environmentId,
       experienceFragmentId: args.experienceFragmentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experienceFragment.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -6672,7 +6683,7 @@ function deleteExperienceFragmentTool(config) {
       environmentId: args.environmentId,
       experienceFragmentId: args.experienceFragmentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceFragment = await contentfulClient.experienceFragment.get(params);
     const expectedToken = buildConfirmToken(
       "experienceFragment",
@@ -6717,7 +6728,7 @@ function publishExperienceFragmentTool(config) {
       environmentId: args.environmentId,
       experienceFragmentId: args.experienceFragmentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experienceFragment.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -6754,7 +6765,7 @@ function unpublishExperienceFragmentTool(config) {
       environmentId: args.environmentId,
       experienceFragmentId: args.experienceFragmentId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experienceFragment.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -6877,7 +6888,7 @@ var GetExperienceTemplateToolParams = BaseToolSchema.extend({
 });
 function getExperienceTemplateTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceTemplate = await contentfulClient.experienceTemplate.get({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -6900,7 +6911,7 @@ var ListExperienceTemplatesToolParams = BaseToolSchema.extend({
 });
 function listExperienceTemplatesTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceTemplates = await contentfulClient.experienceTemplate.getMany({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -6947,7 +6958,7 @@ function createExperienceTemplateTool(config) {
       args.environmentId,
       config.protectedEnvironments
     );
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceTemplate = await contentfulClient.experienceTemplate.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
       {
@@ -6997,7 +7008,7 @@ function upsertExperienceTemplateTool(config) {
       environmentId: args.environmentId,
       experienceTemplateId: args.experienceTemplateId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experienceTemplate.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7052,7 +7063,7 @@ function deleteExperienceTemplateTool(config) {
       environmentId: args.environmentId,
       experienceTemplateId: args.experienceTemplateId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experienceTemplate = await contentfulClient.experienceTemplate.get(params);
     const expectedToken = buildConfirmToken(
       "experienceTemplate",
@@ -7097,7 +7108,7 @@ function publishExperienceTemplateTool(config) {
       environmentId: args.environmentId,
       experienceTemplateId: args.experienceTemplateId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experienceTemplate.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7134,7 +7145,7 @@ function unpublishExperienceTemplateTool(config) {
       environmentId: args.environmentId,
       experienceTemplateId: args.experienceTemplateId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experienceTemplate.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7257,7 +7268,7 @@ var GetExperienceToolParams = BaseToolSchema.extend({
 });
 function getExperienceTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experience = await contentfulClient.experience.get({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -7280,7 +7291,7 @@ var ListExperiencesToolParams = BaseToolSchema.extend({
 });
 function listExperiencesTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experiences = await contentfulClient.experience.getMany({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -7333,7 +7344,7 @@ function createExperienceTool(config) {
       args.environmentId,
       config.protectedEnvironments
     );
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experience = await contentfulClient.experience.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
       {
@@ -7386,7 +7397,7 @@ function upsertExperienceTool(config) {
       environmentId: args.environmentId,
       experienceId: args.experienceId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experience.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7436,7 +7447,7 @@ function deleteExperienceTool(config) {
       environmentId: args.environmentId,
       experienceId: args.experienceId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const experience = await contentfulClient.experience.get(params);
     const expectedToken = buildConfirmToken(
       "experience",
@@ -7481,7 +7492,7 @@ function publishExperienceTool(config) {
       environmentId: args.environmentId,
       experienceId: args.experienceId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experience.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7518,7 +7529,7 @@ function unpublishExperienceTool(config) {
       environmentId: args.environmentId,
       experienceId: args.experienceId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.experience.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7638,7 +7649,7 @@ var GetDataAssemblyToolParams = BaseToolSchema.extend({
 });
 function getDataAssemblyTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const dataAssembly = await contentfulClient.dataAssembly.get({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -7658,7 +7669,7 @@ var GetPublishedDataAssemblyToolParams = BaseToolSchema.extend({
 });
 function getPublishedDataAssemblyTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const dataAssembly = await contentfulClient.dataAssembly.getPublished({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -7681,7 +7692,7 @@ var ListDataAssembliesToolParams = BaseToolSchema.extend({
 });
 function listDataAssembliesTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const dataAssemblies = await contentfulClient.dataAssembly.getMany({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -7715,7 +7726,7 @@ var ListPublishedDataAssembliesToolParams = BaseToolSchema.extend({
 });
 function listPublishedDataAssembliesTool(config) {
   async function tool2(args) {
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const dataAssemblies = await contentfulClient.dataAssembly.getManyPublished({
       spaceId: args.spaceId,
       environmentId: args.environmentId,
@@ -7874,7 +7885,7 @@ function createDataAssemblyTool(config) {
       args.environmentId,
       config.protectedEnvironments
     );
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const dataAssembly = await contentfulClient.dataAssembly.create(
       { spaceId: args.spaceId, environmentId: args.environmentId },
       {
@@ -7933,7 +7944,7 @@ function updateDataAssemblyTool(config) {
       environmentId: args.environmentId,
       dataAssemblyId: args.dataAssemblyId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.dataAssembly.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -7984,7 +7995,7 @@ function deleteDataAssemblyTool(config) {
       environmentId: args.environmentId,
       dataAssemblyId: args.dataAssemblyId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const dataAssembly = await contentfulClient.dataAssembly.get(params);
     const expectedToken = buildConfirmToken(
       "dataAssembly",
@@ -8029,7 +8040,7 @@ function publishDataAssemblyTool(config) {
       environmentId: args.environmentId,
       dataAssemblyId: args.dataAssemblyId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.dataAssembly.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(
@@ -8066,7 +8077,7 @@ function unpublishDataAssemblyTool(config) {
       environmentId: args.environmentId,
       dataAssemblyId: args.dataAssemblyId
     };
-    const contentfulClient = createToolClient(config, args);
+    const contentfulClient = createExoToolClient(config, args);
     const current = await contentfulClient.dataAssembly.get(params);
     if (args.version !== current.sys.version) {
       throw new Error(

package/package.json

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