@contentstack/mcp 0.4.0 → 0.5.1

package/README.md

@@ -1,5 +1,7 @@
 # Contentstack MCP Server
 
+> **⚠️ EXPERIMENTAL**: This MCP server is currently in experimental stage. Features, APIs, and functionality may change without notice. Use in production environments at your own risk. We welcome feedback and contributions as we work towards a stable release.
+
 A Model Context Protocol (MCP) server that connects with Contentstack's Content Management API, Content Delivery API, BrandKit AI, Personalize API, Analytics API, Launch API, Developer Hub, and Lytics, delivering extensive content administration, manipulation, delivery, personalization, analytics, deployment, marketplace App management, and insights functionality.
 
 ## Features
@@ -198,9 +200,22 @@ The MCP server supports multiple API groups that can be used independently or to
 
 ### Launch API
 
+#### Project Management
+
+- **get_all_projects**: Fetches the list of all projects in your organization with pagination support. Returns project details including repository information, organization UID, and metadata.
+- **get_a_project**: Fetches a specific project in Launch using the project UID. Returns comprehensive project details including repository configuration and metadata.
+- **create_a_project**: Creates a project in Launch using either a Git Provider or File Upload. For Git Provider: connect your GitHub/Bitbucket account and provide repository details. For File Upload: first get a signed upload URL, then upload your ZIP file (valid for 10 minutes).
+- **update_a_project**: Updates an existing project in your organization. Allows modification of project name and description.
+- **delete_a_project**: Deletes an existing project in your organization. This action is permanent and will remove all associated environments and deployments.
+
 #### Environment Management
 
 - **get_environments**: Retrieves environment configurations with comprehensive details including build settings, deployment information, password protection, and recent commits using cursor-based pagination. Returns empty commits if the project was created by file upload and not connected to GitHub.
+- **get_all_environments**: Fetches the list of all environments in a project with pagination support. Returns environment details including build settings, Git branch configuration, and domain information.
+- **get_an_environment**: Fetches a specific environment from a project using the project UID and environment UID. Returns comprehensive environment details including build configuration, domains, and settings.
+- **create_an_environment**: Creates a new environment in your Launch project. For Git Provider projects, specify the Git branch. For File Upload projects, first get a signed upload URL and upload your ZIP file (valid for 10 minutes).
+- **update_an_environment**: Updates an existing environment in your project. Allows modification of build settings, Git branch, environment variables, password protection, and feature flags.
+- **delete_an_environment**: Deletes an existing environment in your project. This action is permanent and will remove all associated deployments.
 
 #### Deploy Hook Management
 
@@ -213,7 +228,18 @@ The MCP server supports multiple API groups that can be used independently or to
 #### Deployment Management
 
 - **get_latest_live_deployment**: Retrieves the most recent live deployment for a specified environment or project. Returns comprehensive deployment details including build configuration, Git information, deployment status, and performance metrics.
+- **get_all_deployments**: Fetches the list of all deployments within a specific environment with pagination support. Returns deployment details including build status, Git commit information, duration, and preview URLs.
+- **get_deployment**: Retrieves a specific deployment from an environment using the project UID, environment UID, and deployment UID. Returns comprehensive deployment details including status, build information, and performance metrics.
 - **create_deployment**: Creates a new deployment for the specified environment. Initiates the build and deployment process using the latest commit from the environment's configured Git branch.
+- **get_deployment_logs**: Fetches the deployment logs of a specific deployment. These logs provide detailed build and deployment information, helping track the build process and identify issues. Supports optional timestamp parameter for pagination.
+- **get_server_logs**: Fetches the server logs of a specific deployment. These logs capture runtime information from deployed apps, helping monitor performance and debug runtime issues. Requires startTime and endTime parameters.
+
+#### File Upload Management
+
+- **get_signed_upload_url_project**: Fetches the signed URL where you must upload the ZIP file when creating a project via file upload. The signed URL is valid for 10 minutes. After getting this URL, upload your ZIP file, then use the uploadUid in the Create Project API.
+- **get_signed_upload_url_environment**: Fetches the signed URL where you must upload the ZIP file when creating an environment via file upload. The signed URL is valid for 10 minutes. Only available for FILEUPLOAD projects.
+- **get_signed_upload_url_deployment**: Retrieves the signed URL where you must upload the ZIP file when creating or redeploying a deployment via file upload. The signed URL is valid for 10 minutes. Only available for FILEUPLOAD projects.
+- **get_signed_download_url_deployment**: Returns the signed URL to download the uploaded file from the latest deployment. The signed URL is valid for 15 minutes (900 seconds).
 
 #### Cache Management
 

package/dist/index.js

@@ -13,7 +13,7 @@ import dotenv from "dotenv";
 // package.json
 var package_default = {
   name: "@contentstack/mcp",
-  version: "0.4.0",
+  version: "0.5.1",
   main: "./dist/index.js",
   type: "module",
   publishConfig: {
@@ -46,7 +46,7 @@ var package_default = {
     url: "https://github.com/contentstack/mcp.git"
   },
   dependencies: {
-    "@modelcontextprotocol/sdk": "1.25.1",
+    "@modelcontextprotocol/sdk": "1.25.2",
     axios: "^1.13.2",
     dotenv: "^17.2.3",
     inquirer: "^13.1.0",
@@ -922,6 +922,16 @@ async function buildContentstackRequest(actionMapper, args, groupName, subgroupN
       }
     });
   }
+  const customHeaders = {};
+  if (actionMapper.headers) {
+    Object.entries(actionMapper.headers).forEach(
+      ([headerName, argName]) => {
+        if (args[argName] !== void 0) {
+          customHeaders[headerName] = args[argName];
+        }
+      }
+    );
+  }
   let body = void 0;
   if (actionMapper.body) {
     if (actionMapper.type === "complex") {
@@ -955,7 +965,8 @@ async function buildContentstackRequest(actionMapper, args, groupName, subgroupN
     url2,
     body,
     queryParams,
-    options
+    options,
+    customHeaders
   );
   return returnObj;
 }
@@ -979,7 +990,8 @@ async function buildGraphQLRequest(actionMapper, args, groupName, subgroupName,
     actionMapper.apiUrl,
     graphqlBody,
     {},
-    options
+    options,
+    {}
   );
 }
 function buildBodyPayload(schema, data) {
@@ -1039,7 +1051,7 @@ function buildBodyPayload(schema, data) {
   }
   return walk(schema).value;
 }
-async function buildReturnValue(groupName, subgroupName, method, url2, data, queryParams, options) {
+async function buildReturnValue(groupName, subgroupName, method, url2, data, queryParams, options, customHeaders = {}) {
   if (!url2) {
     throw new Error("URL is required");
   }
@@ -1047,6 +1059,7 @@ async function buildReturnValue(groupName, subgroupName, method, url2, data, que
     apiKey,
     deliveryToken,
     brandKitUID,
+    organizationUid,
     launchProjectId,
     personalizeProjectId,
     lyticsAccessToken,
@@ -1131,11 +1144,15 @@ async function buildReturnValue(groupName, subgroupName, method, url2, data, que
       if (!launchProjectId) {
         throw new Error("Launch Project ID is required for Launch API");
       }
+      if (!organizationUid) {
+        throw new Error("Organization UID is required for Launch API");
+      }
       config.headers = {
         ...config.headers,
         "apollographql-client-name": "contentfly-client",
         "apollographql-client-version": "1.3",
-        "x-project-uid": launchProjectId
+        "x-project-uid": launchProjectId,
+        "x-organization-uid": organizationUid
       };
     }
     config.headers = {
@@ -1143,6 +1160,12 @@ async function buildReturnValue(groupName, subgroupName, method, url2, data, que
       ...oauthHeaders
     };
   }
+  if (Object.keys(customHeaders).length > 0) {
+    config.headers = {
+      ...config.headers,
+      ...customHeaders
+    };
+  }
   return config;
 }
 
@@ -1152,6 +1175,7 @@ var TOKEN_ARGS = {
   OAUTH: "--auth",
   DELIVERY: "--delivery-token",
   API_KEY: "--stack-api-key",
+  ORGANIZATION_UID: "--organization-uid",
   BRAND_KIT_ID: "--brand-kit-id",
   LYTICS_ACCESS_TOKEN: "--lytics-access-token",
   PERSONALIZE_PROJECT_ID: "--personalize-project-id",
@@ -1343,6 +1367,7 @@ async function initializeMCP() {
   const apiKey = getArgValue(TOKEN_ARGS.API_KEY);
   const deliveryToken = getArgValue(TOKEN_ARGS.DELIVERY);
   const brandKitID = getArgValue(TOKEN_ARGS.BRAND_KIT_ID);
+  const organizationUid = getArgValue(TOKEN_ARGS.ORGANIZATION_UID);
   const launchProjectId = getArgValue(TOKEN_ARGS.LAUNCH_PROJECT_ID);
   const personalizeProjectId = getArgValue(TOKEN_ARGS.PERSONALIZE_PROJECT_ID);
   const lyticsAccessToken = getArgValue(TOKEN_ARGS.LYTICS_ACCESS_TOKEN);
@@ -1362,6 +1387,9 @@ async function initializeMCP() {
   if (deliveryToken) {
     process.env.CONTENTSTACK_DELIVERY_TOKEN = deliveryToken;
   }
+  if (organizationUid) {
+    process.env.CONTENTSTACK_ORGANIZATION_UID = organizationUid;
+  }
   if (lyticsAccessToken) {
     process.env.LYTICS_ACCESS_TOKEN = lyticsAccessToken;
   }
@@ -1389,6 +1417,7 @@ async function initializeMCP() {
     apiKey: process.env.CONTENTSTACK_API_KEY || "",
     deliveryToken: process.env.CONTENTSTACK_DELIVERY_TOKEN || "",
     brandKitUID: process.env.CONTENTSTACK_BRAND_KIT_ID || "",
+    organizationUid: process.env.CONTENTSTACK_ORGANIZATION_UID || "",
     launchProjectId: process.env.CONTENTSTACK_LAUNCH_PROJECT_ID || "",
     lyticsAccessToken: process.env.LYTICS_ACCESS_TOKEN || "",
     personalizeProjectId: process.env.CONTENTSTACK_PERSONALIZE_PROJECT_ID || "",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/mcp",
-  "version": "0.4.0",
+  "version": "0.5.1",
   "main": "./dist/index.js",
   "type": "module",
   "publishConfig": {
@@ -33,7 +33,7 @@
     "url": "https://github.com/contentstack/mcp.git"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.25.1",
+    "@modelcontextprotocol/sdk": "1.25.2",
     "axios": "^1.13.2",
     "dotenv": "^17.2.3",
     "inquirer": "^13.1.0",