@centrali-io/centrali-mcp 4.2.3 → 4.2.5

package/dist/tools/describe.js

@@ -469,6 +469,16 @@ function registerDescribeTools(server) {
                                 required_params: ["triggerId"],
                             },
                         },
+                        sandbox_api: {
+                            description: "Functions receive an `api` object with built-in utilities. Key crypto methods:",
+                            crypto: {
+                                "api.crypto.sha256(data)": "SHA256 hash → base64 string",
+                                "api.crypto.hmacSha256(key, data, options?)": "HMAC-SHA256 → base64 string. options: { keyEncoding: 'utf8' | 'base64' }",
+                                "api.crypto.rsaSign(privateKeyPem, data, algorithm?)": "RSA signature → base64url string. algorithm: 'RS256' (default), 'RS384', 'RS512'",
+                                "api.crypto.signJwt(privateKeyPem, payload, options?)": "Build + sign a JWT → 'header.payload.signature'. options: { algorithm, expiresIn (seconds), issuer }",
+                            },
+                            note: "Private keys should be stored as encrypted trigger params. signJwt automatically sets iat and supports RS256/RS384/RS512.",
+                        },
                         tips: [
                             "Use list_functions to see all available functions",
                             "Use list_triggers to see how functions are wired to execution events",
@@ -477,6 +487,7 @@ function registerDescribeTools(server) {
                             "Use pause_trigger/resume_trigger to temporarily disable triggers without deleting them",
                             "Use test_function to validate code before creating or updating a function",
                             "Use create_function + create_trigger together to set up a complete compute pipeline",
+                            "Use api.crypto.signJwt() for GitHub App, Google Cloud, or Azure AD authentication flows",
                         ],
                     }, null, 2),
                 },

package/dist/tools/structures.js

@@ -135,9 +135,9 @@ function registerCollectionTools(server, sdk) {
             };
         }
     }));
-    server.tool("create_collection", "Create a new data collection (schema). Define the name, slug, description, and properties (fields) for the collection.", {
+    server.tool("create_collection", "Create a new data collection (schema). Define the name, recordSlug, description, and properties (fields) for the collection.", {
         name: zod_1.z.string().describe("Display name for the collection (e.g., 'Customers')"),
-        slug: zod_1.z.string().describe("URL-safe identifier used in API calls (e.g., 'customers')"),
+        recordSlug: zod_1.z.string().describe("URL-safe identifier used in API calls (e.g., 'customers'). This is the recordSlug, not 'slug'."),
         description: zod_1.z.string().optional().describe("Optional description of the collection"),
         properties: zod_1.z
             .array(zod_1.z.record(zod_1.z.string(), zod_1.z.any()))
@@ -149,9 +149,9 @@ function registerCollectionTools(server, sdk) {
             .optional()
             .describe("Schema discovery mode: 'strict' rejects unknown fields, 'flexible' auto-adds them"),
         tags: zod_1.z.array(zod_1.z.string()).optional().describe("Optional tags for organizing collections"),
-    }, (_a) => __awaiter(this, [_a], void 0, function* ({ name, slug, description, properties, enableVersioning, schemaDiscoveryMode, tags }) {
+    }, (_a) => __awaiter(this, [_a], void 0, function* ({ name, recordSlug, description, properties, enableVersioning, schemaDiscoveryMode, tags }) {
         try {
-            const input = { name, slug };
+            const input = { name, recordSlug };
             if (description !== undefined)
                 input.description = description;
             if (properties !== undefined)
@@ -174,7 +174,7 @@ function registerCollectionTools(server, sdk) {
                 content: [
                     {
                         type: "text",
-                        text: formatError(error, `creating collection '${slug}'`),
+                        text: formatError(error, `creating collection '${recordSlug}'`),
                     },
                 ],
                 isError: true,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-mcp",
-  "version": "4.2.3",
+  "version": "4.2.5",
   "description": "Centrali MCP Server - AI assistant integration for Centrali workspaces",
   "main": "dist/index.js",
   "type": "commonjs",
@@ -25,7 +25,7 @@
   "author": "Blueinit",
   "license": "ISC",
   "dependencies": {
-    "@centrali-io/centrali-sdk": "^4.2.0",
+    "@centrali-io/centrali-sdk": "^4.2.4",
     "@modelcontextprotocol/sdk": "^1.12.1"
   },
   "devDependencies": {

package/src/tools/describe.ts

@@ -539,6 +539,16 @@ export function registerDescribeTools(server: McpServer) {
                   required_params: ["triggerId"],
                 },
               },
+              sandbox_api: {
+                description: "Functions receive an `api` object with built-in utilities. Key crypto methods:",
+                crypto: {
+                  "api.crypto.sha256(data)": "SHA256 hash → base64 string",
+                  "api.crypto.hmacSha256(key, data, options?)": "HMAC-SHA256 → base64 string. options: { keyEncoding: 'utf8' | 'base64' }",
+                  "api.crypto.rsaSign(privateKeyPem, data, algorithm?)": "RSA signature → base64url string. algorithm: 'RS256' (default), 'RS384', 'RS512'",
+                  "api.crypto.signJwt(privateKeyPem, payload, options?)": "Build + sign a JWT → 'header.payload.signature'. options: { algorithm, expiresIn (seconds), issuer }",
+                },
+                note: "Private keys should be stored as encrypted trigger params. signJwt automatically sets iat and supports RS256/RS384/RS512.",
+              },
               tips: [
                 "Use list_functions to see all available functions",
                 "Use list_triggers to see how functions are wired to execution events",
@@ -547,6 +557,7 @@ export function registerDescribeTools(server: McpServer) {
                 "Use pause_trigger/resume_trigger to temporarily disable triggers without deleting them",
                 "Use test_function to validate code before creating or updating a function",
                 "Use create_function + create_trigger together to set up a complete compute pipeline",
+                "Use api.crypto.signJwt() for GitHub App, Google Cloud, or Azure AD authentication flows",
               ],
             },
             null,

package/src/tools/structures.ts

@@ -146,10 +146,10 @@ export function registerCollectionTools(server: McpServer, sdk: CentraliSDK) {
 
   server.tool(
     "create_collection",
-    "Create a new data collection (schema). Define the name, slug, description, and properties (fields) for the collection.",
+    "Create a new data collection (schema). Define the name, recordSlug, description, and properties (fields) for the collection.",
     {
       name: z.string().describe("Display name for the collection (e.g., 'Customers')"),
-      slug: z.string().describe("URL-safe identifier used in API calls (e.g., 'customers')"),
+      recordSlug: z.string().describe("URL-safe identifier used in API calls (e.g., 'customers'). This is the recordSlug, not 'slug'."),
       description: z.string().optional().describe("Optional description of the collection"),
       properties: z
         .array(z.record(z.string(), z.any()))
@@ -164,9 +164,9 @@ export function registerCollectionTools(server: McpServer, sdk: CentraliSDK) {
         .describe("Schema discovery mode: 'strict' rejects unknown fields, 'flexible' auto-adds them"),
       tags: z.array(z.string()).optional().describe("Optional tags for organizing collections"),
     },
-    async ({ name, slug, description, properties, enableVersioning, schemaDiscoveryMode, tags }) => {
+    async ({ name, recordSlug, description, properties, enableVersioning, schemaDiscoveryMode, tags }) => {
       try {
-        const input: Record<string, any> = { name, slug };
+        const input: Record<string, any> = { name, recordSlug };
         if (description !== undefined) input.description = description;
         if (properties !== undefined) input.properties = properties;
         if (enableVersioning !== undefined) input.enableVersioning = enableVersioning;
@@ -183,7 +183,7 @@ export function registerCollectionTools(server: McpServer, sdk: CentraliSDK) {
           content: [
             {
               type: "text",
-              text: formatError(error, `creating collection '${slug}'`),
+              text: formatError(error, `creating collection '${recordSlug}'`),
             },
           ],
           isError: true,