@contentstack/mcp 0.2.0 → 0.3.0

package/README.md

@@ -1,6 +1,6 @@
 # Contentstack MCP Server
 
-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, and Lytics, delivering extensive content administration, manipulation, delivery, personalization, analytics, deployment, and insights functionality.
+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
 
@@ -19,6 +19,7 @@ A Model Context Protocol (MCP) server that connects with Contentstack's Content
 - **Launch Deployment**: Complete deployment platform integration with environment management, deploy hooks, deployments, and CDN cache revalidation for hosting Contentstack-powered websites.
 - **Lytics Analytics**: Audience management, content classification, user profiling, and advanced analytics capabilities.
 - **Personalization**: Advanced personalization capabilities with audience segmentation, A/B testing, experience management, and analytics for optimizing user engagement.
+- **Developer Hub**: Complete Marketplace App lifecycle management with capabilities to create, update, delete, and retrieve Marketplace Apps, manage app installations across stacks and organizations.
 - **Flexible Query Options**: Advanced query capabilities with support for pagination, filtering, sorting, and including associated data.
 
 ## API Groups
@@ -30,6 +31,7 @@ The MCP server supports multiple API groups that can be used independently or to
 - **Analytics**: Usage analytics, performance monitoring, and operational insights
 - **BrandKit**: AI-powered brand management and content generation
 - **Launch**: Deployment platform for hosting and managing Contentstack-powered websites
+- **DeveloperHub**: Marketplace app lifecycle management and installations
 - **Lytics**: Advanced analytics and audience insights
 - **Personalize**: Advanced personalization and A/B testing capabilities
 - **All**: Enable all API groups
@@ -202,6 +204,29 @@ The MCP server supports multiple API groups that can be used independently or to
 
 - **revalidate_cdn_cache**: Revalidates the CDN cache for an environment when content or configuration is modified. Prompts the CDN to fetch the latest content from the origin server, ensuring visitors see the most up-to-date version across all domains in the environment.
 
+### Developer Hub
+
+#### Marketplace App Management
+
+- **create_an_app**: Creates a Marketplace App in an Organization.
+- **update_an_app**: Updates a specified Marketplace App in an Organization.
+- **delete_an_app**: Deletes a specified Marketplace App from an Organization.
+- **get_an_app**: Retrieves detailed information for a specified Marketplace App from an Organization.
+- **get_all_apps**: Retrieves all Marketplace Apps with pagination support, search capabilities, and filtering options for target type, enabling efficient Marketplace App discovery and management.
+
+#### Marketplace App OAuth Management
+
+- **get_app_oauth**: Retrieves the OAuth configuration details for a specified Marketplace App.
+- **get_oauth_scopes**: Retrieves available OAuth scopes for Marketplace Apps, with optional filtering by app type (stack or organization).
+- **update_app_oauth**: Updates the OAuth configuration for a specified Marketplace App, including redirect URIs, user token configuration, and app token configuration for secure API access.
+
+#### Marketplace App Installation Management
+
+- **install_an_app**: Installs a specified Marketplace App in a target stack or organization, enabling Marketplace App functionality within the designated scope based on app configuration.
+- **update_an_app_installation**: Updates a specified Marketplace App installation in a stack or organization.
+- **get_app_installations**: Retrieves all installations for a specified Marketplace App, providing visibility into where and how the Marketplace App is deployed across stacks and organizations.
+- **uninstall_an_app**: Uninstalls a specified Marketplace App from a stack or organization, removing Marketplace App functionality and cleaning up Marketplace App-related configurations.
+
 ### Lytics Analytics
 
 #### Audience Management
@@ -279,9 +304,9 @@ The MCP server supports multiple API groups that can be used independently or to
 
 1. Create a Contentstack account at [Contentstack](https://www.contentstack.com/login/)
 
-### OAuth Setup (Required for CMA, Analytics, BrandKit, Launch, and Personalize)
+### OAuth Setup (Required for CMA, Analytics, BrandKit, Launch, DeveloperHub, and Personalize)
 
-**Important**: Before using Content Management API (CMA), Analytics, BrandKit, Launch, or Personalize tools, you must authenticate using OAuth:
+**Important**: Before using Content Management API (CMA), Analytics, BrandKit, Launch, DeveloperHub, or Personalize tools, you must authenticate using OAuth:
 
 ```bash
 npx @contentstack/mcp --auth
@@ -307,19 +332,20 @@ These variables can also be set as arguments
 - `CONTENTSTACK_LAUNCH_PROJECT_ID` / `--launch-project-id`: Your Launch Project ID (required for Launch tools)
 - `LYTICS_ACCESS_TOKEN` / `--lytics-access-token`: Your Lytics access token (required for Lytics tools)
 - `CONTENTSTACK_PERSONALIZE_PROJECT_ID` / `--personalize-project-id`: Your Personalize Project ID (required for Personalize tools)
-- `GROUPS` / `--groups`: Comma-separated list of API groups to enable (options: `cma`, `cda`, `analytics`, `brandkit`, `launch`, `lytics`, `personalize`, `all`. Default: `cma`)
+- `GROUPS` / `--groups`: Comma-separated list of API groups to enable (options: `cma`, `cda`, `analytics`, `brandkit`, `launch`, `developerhub`, `lytics`, `personalize`, `all`. Default: `cma`)
 
 ### Group Requirements Summary
 
-| Group           | Authentication | Required Tokens/Configuration          |
-| --------------- | -------------- | -------------------------------------- |
-| **CMA**         | OAuth          | Stack API Key                          |
-| **CDA**         | Token-based    | Stack API Key + Delivery Token         |
-| **Analytics**   | OAuth          | Stack API Key                          |
-| **BrandKit**    | OAuth          | Stack API Key + Brand Kit ID           |
-| **Launch**      | OAuth          | Stack API Key + Launch Project ID      |
-| **Lytics**      | Token-based    | Lytics Access Token                    |
-| **Personalize** | OAuth          | Stack API Key + Personalize Project ID |
+| Group            | Authentication | Required Tokens/Configuration          |
+| ---------------- | -------------- | -------------------------------------- |
+| **CMA**          | OAuth          | Stack API Key                          |
+| **CDA**          | Token-based    | Stack API Key + Delivery Token         |
+| **Analytics**    | OAuth          | Stack API Key                          |
+| **BrandKit**     | OAuth          | Stack API Key + Brand Kit ID           |
+| **Launch**       | OAuth          | Stack API Key + Launch Project ID      |
+| **DeveloperHub** | OAuth          | Stack API Key                          |
+| **Lytics**       | Token-based    | Lytics Access Token                    |
+| **Personalize**  | OAuth          | Stack API Key + Personalize Project ID |
 
 ### Usage with Claude Desktop
 
@@ -352,7 +378,7 @@ You can use this MCP without cloning the repository by simply modifying your Cla
 - The `CONTENTSTACK_LAUNCH_PROJECT_ID` is required only for Launch tools.
 - The `CONTENTSTACK_PERSONALIZE_PROJECT_ID` is required only for Personalize tools.
 - The `LYTICS_ACCESS_TOKEN` is required only for Lytics tools.
-- Before using CMA, Analytics, BrandKit, Launch, or Personalize groups, you must first run OAuth authentication: `npx @contentstack/mcp --auth`
+- Before using CMA, Analytics, BrandKit, Launch, DeveloperHub, or Personalize groups, you must first run OAuth authentication: `npx @contentstack/mcp --auth`
 
 If your MCPClient doesn't support environment variables, you can alternatively provide the required authentication parameters as command-line arguments:
 

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
   CallToolRequestSchema,
@@ -13,7 +13,7 @@ import dotenv from "dotenv";
 // package.json
 var package_default = {
   name: "@contentstack/mcp",
-  version: "0.2.0",
+  version: "0.3.0",
   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.12.0",
+    "@modelcontextprotocol/sdk": "^1.24.0",
     axios: "^1.9.0",
     dotenv: "^16.5.0",
     inquirer: "^12.6.3",
@@ -84,6 +84,17 @@ var package_default = {
   }
 };
 
+// src/oauth.ts
+import axios from "axios";
+import http from "http";
+import url from "url";
+import fs from "fs/promises";
+import path from "path";
+import os from "os";
+import open from "open";
+import crypto from "crypto";
+import inquirer from "inquirer";
+
 // src/utils/constants.ts
 var CMA_URLS = {
   NA: "https://api.contentstack.io",
@@ -176,6 +187,14 @@ var LAUNCH_URLS = {
   GCP_NA: "https://gcp-na-launch-api.contentstack.com/manage",
   GCP_EU: "https://gcp-eu-launch-api.contentstack.com/manage"
 };
+var DEVELOPERHUB_URLS = {
+  NA: "https://developerhub-api.contentstack.com",
+  EU: "https://eu-developerhub-api.contentstack.com",
+  AZURE_NA: "https://azure-na-developerhub-api.contentstack.com",
+  AZURE_EU: "https://azure-eu-developerhub-api.contentstack.com",
+  GCP_NA: "https://gcp-na-developerhub-api.contentstack.com",
+  GCP_EU: "https://gcp-eu-developerhub-api.contentstack.com"
+};
 var GroupEnum = {
   CMA: "cma",
   CDA: "cda",
@@ -184,7 +203,8 @@ var GroupEnum = {
   LYTICS: "lytics",
   ANALYTICS: "analytics",
   PERSONALIZE: "personalize",
-  LAUNCH: "launch"
+  LAUNCH: "launch",
+  DEVELOPERHUB: "developerhub"
 };
 var apiVersionHeaders = [
   "publish_variants_of_an_entry",
@@ -198,22 +218,11 @@ var TOOL_URLS = {
   lytics: "https://mcp.contentstack.com/lytics/tools",
   personalize: "https://mcp.contentstack.com/personalize/tools",
   analytics: "https://mcp.contentstack.com/analytics/tools",
-  launch: "https://mcp.contentstack.com/launch/tools"
+  launch: "https://mcp.contentstack.com/launch/tools",
+  developerhub: "https://mcp.contentstack.com/developerhub/tools"
 };
 
-// src/utils/index.ts
-import axios2 from "axios";
-
 // src/oauth.ts
-import axios from "axios";
-import http from "http";
-import url from "url";
-import fs from "fs/promises";
-import path from "path";
-import os from "os";
-import open from "open";
-import crypto from "crypto";
-import inquirer from "inquirer";
 var ContentstackOAuthHandler = class _ContentstackOAuthHandler {
   appId;
   clientId;
@@ -763,6 +772,18 @@ var ContentstackOAuthHandler = class _ContentstackOAuthHandler {
 var oauth_default = ContentstackOAuthHandler;
 
 // src/utils/index.ts
+import axios2 from "axios";
+import fs2 from "fs";
+var fetchToolsJson = async (url2) => {
+  try {
+    if (url2.startsWith("http")) {
+      return await axios2.get(url2);
+    }
+    return { data: JSON.parse(fs2.readFileSync(url2, "utf8")) };
+  } catch (error) {
+    throw new Error(`Error fetching tools from ${url2}: ${error}`);
+  }
+};
 var getBaseUrl = (region, group, subgroup) => {
   if (group === GroupEnum.CMA) {
     return CMA_URLS[region];
@@ -781,6 +802,8 @@ var getBaseUrl = (region, group, subgroup) => {
     return ANALYTICS_URLS[region];
   } else if (group === GroupEnum.LAUNCH) {
     return LAUNCH_URLS[region];
+  } else if (group === GroupEnum.DEVELOPERHUB) {
+    return DEVELOPERHUB_URLS[region];
   } else {
     throw new Error(`Invalid group: ${group}`);
   }
@@ -794,7 +817,8 @@ var getTools = async (groups) => {
       [GroupEnum.LYTICS]: TOOL_URLS.lytics,
       [GroupEnum.PERSONALIZE]: TOOL_URLS.personalize,
       [GroupEnum.ANALYTICS]: TOOL_URLS.analytics,
-      [GroupEnum.LAUNCH]: TOOL_URLS.launch
+      [GroupEnum.LAUNCH]: TOOL_URLS.launch,
+      [GroupEnum.DEVELOPERHUB]: TOOL_URLS.developerhub
     };
     if (groups.includes(GroupEnum.ALL)) {
       const [
@@ -804,15 +828,17 @@ var getTools = async (groups) => {
         lyticsRes,
         personalizeRes,
         analyticsRes,
-        launchRes
+        launchRes,
+        developerhubRes
       ] = await Promise.all([
-        axios2.get(TOOL_URLS.cma),
-        axios2.get(TOOL_URLS.cda),
-        axios2.get(TOOL_URLS.brandkit),
-        axios2.get(TOOL_URLS.lytics),
-        axios2.get(TOOL_URLS.personalize),
-        axios2.get(TOOL_URLS.analytics),
-        axios2.get(TOOL_URLS.launch)
+        fetchToolsJson(TOOL_URLS.cma),
+        fetchToolsJson(TOOL_URLS.cda),
+        fetchToolsJson(TOOL_URLS.brandkit),
+        fetchToolsJson(TOOL_URLS.lytics),
+        fetchToolsJson(TOOL_URLS.personalize),
+        fetchToolsJson(TOOL_URLS.analytics),
+        fetchToolsJson(TOOL_URLS.launch),
+        fetchToolsJson(TOOL_URLS.developerhub)
       ]);
       return {
         ...cmaRes.data,
@@ -821,7 +847,8 @@ var getTools = async (groups) => {
         ...lyticsRes.data,
         ...personalizeRes.data,
         ...analyticsRes.data,
-        ...launchRes.data
+        ...launchRes.data,
+        ...developerhubRes.data
       };
     }
     const responses = await Promise.all(
@@ -830,7 +857,7 @@ var getTools = async (groups) => {
         if (!url2) {
           throw new Error(`Invalid group: ${group}`);
         }
-        return axios2.get(url2);
+        return fetchToolsJson(url2);
       })
     );
     return responses.reduce((allTools, response) => {
@@ -1139,7 +1166,8 @@ var GROUPS = {
   LYTICS: "lytics",
   ANALYTICS: "analytics",
   PERSONALIZE: "personalize",
-  LAUNCH: "launch"
+  LAUNCH: "launch",
+  DEVELOPERHUB: "developerhub"
 };
 function getArgValue(argName) {
   const index = process.argv.findIndex((arg) => arg === argName);
@@ -1217,7 +1245,7 @@ function validateGroupRequirements(groups, options) {
 }
 function createContentstackMCPServer(options) {
   const { groups } = options;
-  const server = new Server(
+  const mcpServer = new McpServer(
     {
       name: "Contentstack MCP",
       version: package_default.version
@@ -1229,7 +1257,7 @@ function createContentstackMCPServer(options) {
     }
   );
   let toolData;
-  server.setRequestHandler(ListToolsRequestSchema, async () => {
+  mcpServer.server.setRequestHandler(ListToolsRequestSchema, async () => {
     try {
       toolData = await getTools(groups);
       if (!toolData || Object.keys(toolData).length === 0) {
@@ -1244,7 +1272,7 @@ function createContentstackMCPServer(options) {
       );
     }
   });
-  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  mcpServer.server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { name, arguments: args } = request.params;
     if (!name || !args) {
       throw new Error("Invalid request: Missing tool name or arguments");
@@ -1290,7 +1318,7 @@ function createContentstackMCPServer(options) {
       throw new Error(`Tool execution failed: ${error.message}`);
     }
   });
-  return server;
+  return mcpServer;
 }
 async function checkOAuthConfig() {
   try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contentstack/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "main": "./dist/index.js",
   "type": "module",
   "publishConfig": {
@@ -33,7 +33,7 @@
     "url": "https://github.com/contentstack/mcp.git"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
+    "@modelcontextprotocol/sdk": "^1.24.0",
     "axios": "^1.9.0",
     "dotenv": "^16.5.0",
     "inquirer": "^12.6.3",