@contentstack/mcp 0.3.1 → 0.5.0

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
@@ -57,6 +59,11 @@ The MCP server supports multiple API groups that can be used independently or to
 
 - **get_all_content_types**: This tool retrieves the schema and metadata of a specified content type from a Contentstack stack, supporting branch selection, query filtering, pagination, and optional inclusion of global field schema and branch metadata.
 - **get_a_single_content_type**: This tool retrieves the schema and configuration details of a specified content type within a stack, supporting optional inclusion of global field definitions and branch metadata for developer reference.
+- **create_a_content_type**: This tool creates a new content type in the specified Contentstack stack, supporting branch selection and optional branch metadata inclusion.
+- **update_content_type**: This tool updates an existing content type in the specified Contentstack stack, supporting branch selection and optional branch metadata inclusion.
+- **delete_content_type**: This tool deletes an existing content type and all the entries within it.
+- **get_all_references_of_ct**: This tool retrieves a list of all content types that are referenced within the specified content type. This includes both direct and nested references.
+- **export_content_type**: This tool exports a specific content type and its schema. The data is exported in JSON format.
 - **get_all_global_fields**: This tool retrieves metadata for all global fields configured within the specified stack, supporting optional branch selection and branch metadata inclusion.
 - **get_a_single_global_field**: This tool retrieves metadata and configuration details for a specified global field within a Contentstack stack, supporting branch selection and optional inclusion of branch context.
 
@@ -112,10 +119,20 @@ The MCP server supports multiple API groups that can be used independently or to
 
 - **get_all_branches**: This tool retrieves metadata for all branches within a specified stack, supporting pagination via limit and skip parameters.
 - **get_a_single_branch**: This tool retrieves metadata and configuration details for a specified branch within a Contentstack stack, enabling branch-level inspection and management.
+- **create_a_branch**: This tool creates a new branch in the specified Contentstack stack.
+- **delete_a_branch**: This tool deletes a branch in the specified Contentstack stack.
 - **merge_branch**: This tool merges content types and global fields from a compare branch into a base branch, with optional per item strategy overrides.
 - **get_all_branch_aliases**: This tool retrieves metadata for all branch aliases within a specified stack, supporting pagination via limit and skip parameters.
 - **get_a_single_branch_alias**: This tool retrieves metadata and configuration details for a specified branch alias within a Contentstack stack, enabling branch management and validation operations.
+- **assign_a_branch_alias**: This tool creates a new alias in a particular stack of your organization. This alias can point to any existing branch (target branch) of your stack.
+- **delete_a_branch_alias**: This tool permanently deletes the specified branch alias from the selected stack.
+- **get_all_merge_jobs**: This tool retrieves a list of all the recent merge jobs within a specific period.
 - **get_a_single_merge_job**: This tool retrieves detailed information for a specified merge job within a stack, using the provided merge_job_uid parameter.
+- **compare_branches**: This tool retrieves a list of all the differences between two branches.
+- **compare_content_types_between_branches**: This tool retrieves a list of all the differences in content types between the two specified branches.
+- **compare_global_fields_between_branches**: This tool retrieves a list of all the differences in global fields between the two specified branches.
+- **compare_specific_ct_between_branches**: This tool retrieves all the differences of the specified content type between the two specified branches.
+- **compare_specific_gf_between_branches**: This tool retrieves all the differences of the specified global field between the two specified branches.
 
 #### Release Management
 
@@ -183,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
 
@@ -198,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.3.1",
+  version: "0.5.0",
   main: "./dist/index.js",
   type: "module",
   publishConfig: {
@@ -46,11 +46,11 @@ var package_default = {
     url: "https://github.com/contentstack/mcp.git"
   },
   dependencies: {
-    "@modelcontextprotocol/sdk": "1.24.3",
-    axios: "^1.9.0",
-    dotenv: "^16.5.0",
-    inquirer: "^12.6.3",
-    open: "^10.1.2"
+    "@modelcontextprotocol/sdk": "1.25.2",
+    axios: "^1.13.2",
+    dotenv: "^17.2.3",
+    inquirer: "^13.1.0",
+    open: "^11.0.0"
   },
   devDependencies: {
     "@commitlint/cli": "^19.8.1",
@@ -1047,6 +1047,7 @@ async function buildReturnValue(groupName, subgroupName, method, url2, data, que
     apiKey,
     deliveryToken,
     brandKitUID,
+    organizationUid,
     launchProjectId,
     personalizeProjectId,
     lyticsAccessToken,
@@ -1131,11 +1132,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 = {
@@ -1152,6 +1157,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 +1349,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 +1369,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 +1399,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.3.1",
+  "version": "0.5.0",
   "main": "./dist/index.js",
   "type": "module",
   "publishConfig": {
@@ -33,11 +33,11 @@
     "url": "https://github.com/contentstack/mcp.git"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "1.24.3",
-    "axios": "^1.9.0",
-    "dotenv": "^16.5.0",
-    "inquirer": "^12.6.3",
-    "open": "^10.1.2"
+    "@modelcontextprotocol/sdk": "1.25.2",
+    "axios": "^1.13.2",
+    "dotenv": "^17.2.3",
+    "inquirer": "^13.1.0",
+    "open": "^11.0.0"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.8.1",