@contentful/mcp-server 1.13.0 → 1.14.0

package/README.md

@@ -71,6 +71,7 @@ npm run build
 | `CONTENTFUL_HOST`                    | ❌ No    | `api.contentful.com` | Contentful API host                                                                                                                                                                                      |
 | `NODE_ENV`                           | ❌ No    | `production`         | Node Environment to run in                                                                                                                                                                               |
 | `MAX_BULK_SIZE`                      | ❌ No    | `10`                 | Maximum number of IDs allowed in a single bulk-operation tool call (1–100). Caps publish/unpublish/archive/unarchive on entries and assets. Mitigates accidental mass operations from AI hallucinations. |
+| `ENABLE_EXO_TOOLS`                   | ❌ No    | `false`              | Opt in to Experience Orchestration (ExO) tools. Set to `true` to register the ExO tool collections (component types, data assemblies, experiences, templates, fragments). Also requires the token to hold the `exoM1` entitlement in at least one accessible org — both gates must pass. |
 
 ### Configuration
 

package/dist/index.js

@@ -21,7 +21,7 @@ function registerAllResources(_server) {
 
 // src/tools/register.ts
 init_esm_shims();
-import { ContentfulMcpTools } from "@contentful/mcp-tools";
+import { ContentfulMcpTools, hasExoM1Entitlement } from "@contentful/mcp-tools";
 
 // src/config/env.ts
 init_esm_shims();
@@ -4105,6 +4105,9 @@ var EnvSchema = external_exports.object({
     "Maximum number of IDs allowed in a single bulk-operation tool call (default: 10, max: 100). Mitigates accidental mass operations from AI hallucinations."
   ),
   ORGANIZATION_ID: external_exports.string().optional().describe("Contentful organization ID"),
+  ENABLE_EXO_TOOLS: external_exports.string().optional().transform((v) => v === "true").describe(
+    'Opt in to Experience Orchestration (ExO) tools. Set to "true" to register the ExO tool collections (component types, data assemblies, experiences, templates, fragments). Tools register only if the token also holds the exoM1 entitlement in at least one accessible org \u2014 both gates must pass. Defaults to off.'
+  ),
   CONTENTFUL_DELIVERY_TOKEN: external_exports.string().optional().describe(
     "Contentful CDA token (used with export_space to export only published content)"
   ),
@@ -4123,7 +4126,7 @@ init_esm_shims();
 
 // src/mcpVersion.ts
 init_esm_shims();
-var MCP_VERSION = "1.12.3";
+var MCP_VERSION = "1.13.0";
 
 // src/getVersion.ts
 var getVersion = () => {
@@ -4131,14 +4134,14 @@ var getVersion = () => {
 };
 
 // src/tools/register.ts
-function registerAllTools(server) {
+async function registerAllTools(server) {
   if (!env.success || !env.data) {
     throw new Error("Environment variables are not properly configured");
   }
   const parsedProtectedEnvs = env.data.PROTECTED_ENVIRONMENTS ? env.data.PROTECTED_ENVIRONMENTS.split(",").map((e) => e.trim()).filter(Boolean) : void 0;
   const protectedEnvironments = parsedProtectedEnvs?.length ? parsedProtectedEnvs : void 0;
   const maxBulkSize = env.data.MAX_BULK_SIZE ? Number(env.data.MAX_BULK_SIZE) : void 0;
-  const tools = new ContentfulMcpTools({
+  const baseConfig = {
     accessToken: env.data.CONTENTFUL_MANAGEMENT_ACCESS_TOKEN,
     host: env.data.CONTENTFUL_HOST,
     spaceId: env.data.SPACE_ID,
@@ -4150,6 +4153,11 @@ function registerAllTools(server) {
     hostDelivery: env.data.CONTENTFUL_DELIVERY_HOST,
     protectedEnvironments,
     maxBulkSize
+  };
+  const registerExoTools = env.data.ENABLE_EXO_TOOLS && await hasExoM1Entitlement(baseConfig);
+  const tools = new ContentfulMcpTools({
+    ...baseConfig,
+    exoToolsRegistered: registerExoTools
   });
   const aiActionTools = tools.getAiActionTools();
   const assetTools = tools.getAssetTools();
@@ -4175,7 +4183,14 @@ function registerAllTools(server) {
     orgTools,
     spaceTools,
     tagTools,
-    taxonomyTools
+    taxonomyTools,
+    ...registerExoTools ? [
+      tools.getComponentTypeTools(),
+      tools.getDataAssemblyTools(),
+      tools.getExperienceTools(),
+      tools.getTemplateTools(),
+      tools.getFragmentTools()
+    ] : []
   ];
   allToolCollections.forEach((toolCollection) => {
     Object.values(toolCollection).forEach((tool) => {
@@ -4238,7 +4253,7 @@ async function initializeServer() {
     name: MCP_SERVER_NAME,
     version: getVersion()
   });
-  registerAllTools(server);
+  await registerAllTools(server);
   registerAllPrompts(server);
   registerAllResources(server);
   return server;