@centrali-io/centrali-mcp 3.1.7 → 4.0.1

package/README.md

@@ -36,11 +36,17 @@ Add to your MCP client configuration (e.g., Claude Desktop, Cursor):
 
 ## Available Tools
 
-### Structures
+### Collections
 | Tool | Description |
 |------|-------------|
-| `list_structures` | List all data structures (schemas) in the workspace |
-| `get_structure` | Get full schema for a structure by record slug |
+| `list_collections` | List all data collections (schemas) in the workspace |
+| `get_collection` | Get full schema for a collection by record slug |
+
+### Structures (Deprecated)
+| Tool | Description |
+|------|-------------|
+| `list_structures` | *Deprecated: use `list_collections`* — List all data structures in the workspace |
+| `get_structure` | *Deprecated: use `get_collection`* — Get full schema for a structure by record slug |
 
 ### Records
 | Tool | Description |
@@ -73,8 +79,10 @@ Add to your MCP client configuration (e.g., Claude Desktop, Cursor):
 
 | URI | Description |
 |-----|-------------|
-| `centrali://structures` | List of all structures with name, slug, description |
-| `centrali://structures/{slug}` | Full schema for a specific structure |
+| `centrali://collections` | List of all collections with name, slug, description |
+| `centrali://collections/{slug}` | Full schema for a specific collection |
+| `centrali://structures` | *Deprecated: use `centrali://collections`* |
+| `centrali://structures/{slug}` | *Deprecated: use `centrali://collections/{slug}`* |
 
 ## Development
 

package/dist/index.js

@@ -47,6 +47,7 @@ function main() {
             version: "1.0.0",
         });
         // Register all tools
+        (0, structures_js_1.registerCollectionTools)(server, sdk);
         (0, structures_js_1.registerStructureTools)(server, sdk);
         (0, records_js_1.registerRecordTools)(server, sdk);
         (0, search_js_1.registerSearchTools)(server, sdk);
@@ -56,6 +57,7 @@ function main() {
         (0, insights_js_1.registerInsightTools)(server, sdk);
         (0, validation_js_1.registerValidationTools)(server, sdk);
         // Register resources
+        (0, structures_js_2.registerCollectionResources)(server, sdk);
         (0, structures_js_2.registerStructureResources)(server, sdk);
         // Start stdio transport
         const transport = new stdio_js_1.StdioServerTransport();

package/dist/resources/structures.d.ts

@@ -1,3 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CentraliSDK } from "@centrali-io/centrali-sdk";
 export declare function registerStructureResources(server: McpServer, sdk: CentraliSDK): void;
+export declare function registerCollectionResources(server: McpServer, sdk: CentraliSDK): void;

package/dist/resources/structures.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerStructureResources = registerStructureResources;
+exports.registerCollectionResources = registerCollectionResources;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 function formatError(error, context) {
     var _a, _b;
@@ -36,7 +37,7 @@ function formatError(error, context) {
 function registerStructureResources(server, sdk) {
     // Static resource: list all structures (gives LLM workspace context)
     server.resource("structures-list", "centrali://structures", {
-        description: "List of all data structures in the workspace with name, slug, and description",
+        description: "[DEPRECATED: use centrali://collections instead] List of all data structures in the workspace with name, slug, and description",
         mimeType: "application/json",
     }, (uri) => __awaiter(this, void 0, void 0, function* () {
         try {
@@ -84,7 +85,7 @@ function registerStructureResources(server, sdk) {
             }
         }),
     }), {
-        description: "Full schema definition for a specific structure",
+        description: "[DEPRECATED: use centrali://collections/{slug} instead] Full schema definition for a specific structure",
         mimeType: "application/json",
     }, (uri_1, _a) => __awaiter(this, [uri_1, _a], void 0, function* (uri, { slug }) {
         try {
@@ -104,3 +105,74 @@ function registerStructureResources(server, sdk) {
         }
     }));
 }
+function registerCollectionResources(server, sdk) {
+    // Static resource: list all collections (gives LLM workspace context)
+    server.resource("collections-list", "centrali://collections", {
+        description: "List of all data collections in the workspace with name, slug, and description",
+        mimeType: "application/json",
+    }, (uri) => __awaiter(this, void 0, void 0, function* () {
+        try {
+            const result = yield sdk.collections.list({ limit: 100 });
+            const summary = (result.data || []).map((s) => {
+                var _a;
+                return ({
+                    name: s.name,
+                    recordSlug: s.recordSlug,
+                    description: s.description || "",
+                    propertyCount: ((_a = s.properties) === null || _a === void 0 ? void 0 : _a.length) || 0,
+                    status: s.status,
+                });
+            });
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify(summary, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(formatError(error, "listing collections resource"));
+        }
+    }));
+    // Resource template: full schema for a specific collection
+    server.resource("collection-schema", new mcp_js_1.ResourceTemplate("centrali://collections/{slug}", {
+        list: () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const result = yield sdk.collections.list({ limit: 100 });
+                return {
+                    resources: (result.data || []).map((s) => ({
+                        uri: `centrali://collections/${s.recordSlug}`,
+                        name: s.name,
+                        description: s.description || `Schema for ${s.name}`,
+                        mimeType: "application/json",
+                    })),
+                };
+            }
+            catch (error) {
+                throw new Error(formatError(error, "listing collection schemas"));
+            }
+        }),
+    }), {
+        description: "Full schema definition for a specific collection",
+        mimeType: "application/json",
+    }, (uri_1, _a) => __awaiter(this, [uri_1, _a], void 0, function* (uri, { slug }) {
+        try {
+            const result = yield sdk.collections.getBySlug(slug);
+            return {
+                contents: [
+                    {
+                        uri: uri.href,
+                        mimeType: "application/json",
+                        text: JSON.stringify(result.data, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            throw new Error(formatError(error, `getting collection schema for '${slug}'`));
+        }
+    }));
+}

package/dist/tools/search.js

@@ -36,19 +36,27 @@ function formatError(error, context) {
 function registerSearchTools(server, sdk) {
     server.tool("search_records", "Full-text search across records in the workspace. Powered by Meilisearch. Optionally filter by structure(s) and limit results.", {
         query: zod_1.z.string().describe("The search query string"),
+        collections: zod_1.z
+            .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
+            .optional()
+            .describe("Filter by collection slug(s). Single slug string or array of slugs"),
         structures: zod_1.z
             .union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())])
             .optional()
-            .describe("Filter by structure slug(s). Single slug string or array of slugs"),
+            .describe("[DEPRECATED: use collections instead] Filter by structure slug(s). Single slug string or array of slugs"),
         limit: zod_1.z
             .number()
             .optional()
             .describe("Maximum results to return (default: 20, max: 100)"),
-    }, (_a) => __awaiter(this, [_a], void 0, function* ({ query, structures, limit }) {
+    }, (_a) => __awaiter(this, [_a], void 0, function* ({ query, collections, structures, limit }) {
         try {
             const options = {};
-            if (structures)
-                options.structures = structures;
+            if (collections) {
+                options.collections = collections;
+            }
+            else if (structures) {
+                options.collections = structures;
+            }
             if (limit)
                 options.limit = limit;
             const result = yield sdk.search(query, Object.keys(options).length > 0 ? options : undefined);

package/dist/tools/structures.d.ts

@@ -1,3 +1,4 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { CentraliSDK } from "@centrali-io/centrali-sdk";
 export declare function registerStructureTools(server: McpServer, sdk: CentraliSDK): void;
+export declare function registerCollectionTools(server: McpServer, sdk: CentraliSDK): void;

package/dist/tools/structures.js

@@ -10,6 +10,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerStructureTools = registerStructureTools;
+exports.registerCollectionTools = registerCollectionTools;
 const zod_1 = require("zod");
 function formatError(error, context) {
     var _a, _b;
@@ -34,7 +35,7 @@ function formatError(error, context) {
     return `Error ${context}: ${error instanceof Error ? error.message : String(error)}`;
 }
 function registerStructureTools(server, sdk) {
-    server.tool("list_structures", "List all data structures (schemas) in the Centrali workspace. Returns name, slug, description, and property definitions for each structure.", {
+    server.tool("list_structures", "[DEPRECATED: use list_collections instead] List all data structures (schemas) in the Centrali workspace. Returns name, slug, description, and property definitions for each structure.", {
         page: zod_1.z.number().optional().describe("Page number (1-indexed)"),
         limit: zod_1.z.number().optional().describe("Results per page"),
     }, (_a) => __awaiter(this, [_a], void 0, function* ({ page, limit }) {
@@ -58,7 +59,7 @@ function registerStructureTools(server, sdk) {
             };
         }
     }));
-    server.tool("get_structure", "Get the full schema definition for a specific structure by its record slug. Returns properties, types, constraints, and configuration.", {
+    server.tool("get_structure", "[DEPRECATED: use get_collection instead] Get the full schema definition for a specific structure by its record slug. Returns properties, types, constraints, and configuration.", {
         recordSlug: zod_1.z
             .string()
             .describe("The structure's record slug (e.g., 'orders', 'customers')"),
@@ -84,3 +85,54 @@ function registerStructureTools(server, sdk) {
         }
     }));
 }
+function registerCollectionTools(server, sdk) {
+    server.tool("list_collections", "List all data collections (schemas) in the Centrali workspace. Returns name, slug, description, and property definitions for each collection.", {
+        page: zod_1.z.number().optional().describe("Page number (1-indexed)"),
+        limit: zod_1.z.number().optional().describe("Results per page"),
+    }, (_a) => __awaiter(this, [_a], void 0, function* ({ page, limit }) {
+        try {
+            const result = yield sdk.collections.list({ page, limit });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result.data, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(error, "listing collections"),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }));
+    server.tool("get_collection", "Get the full schema definition for a specific collection by its record slug. Returns properties, types, constraints, and configuration.", {
+        recordSlug: zod_1.z
+            .string()
+            .describe("The collection's record slug (e.g., 'orders', 'customers')"),
+    }, (_a) => __awaiter(this, [_a], void 0, function* ({ recordSlug }) {
+        try {
+            const result = yield sdk.collections.getBySlug(recordSlug);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(result.data, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: formatError(error, `getting collection '${recordSlug}'`),
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-mcp",
-  "version": "3.1.7",
+  "version": "4.0.1",
   "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": "^3.1.4",
+    "@centrali-io/centrali-sdk": "^4.0.1",
     "@modelcontextprotocol/sdk": "^1.12.1"
   },
   "devDependencies": {

package/src/index.ts

@@ -3,7 +3,7 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CentraliSDK } from "@centrali-io/centrali-sdk";
-import { registerStructureTools } from "./tools/structures.js";
+import { registerStructureTools, registerCollectionTools } from "./tools/structures.js";
 import { registerRecordTools } from "./tools/records.js";
 import { registerSearchTools } from "./tools/search.js";
 import { registerComputeTools } from "./tools/compute.js";
@@ -11,7 +11,7 @@ import { registerSmartQueryTools } from "./tools/smart-queries.js";
 import { registerOrchestrationTools } from "./tools/orchestrations.js";
 import { registerInsightTools } from "./tools/insights.js";
 import { registerValidationTools } from "./tools/validation.js";
-import { registerStructureResources } from "./resources/structures.js";
+import { registerStructureResources, registerCollectionResources } from "./resources/structures.js";
 
 function getRequiredEnv(name: string): string {
   const value = process.env[name];
@@ -41,6 +41,7 @@ async function main() {
   });
 
   // Register all tools
+  registerCollectionTools(server, sdk);
   registerStructureTools(server, sdk);
   registerRecordTools(server, sdk);
   registerSearchTools(server, sdk);
@@ -51,6 +52,7 @@ async function main() {
   registerValidationTools(server, sdk);
 
   // Register resources
+  registerCollectionResources(server, sdk);
   registerStructureResources(server, sdk);
 
   // Start stdio transport

package/src/resources/structures.ts

@@ -32,7 +32,7 @@ export function registerStructureResources(
     "centrali://structures",
     {
       description:
-        "List of all data structures in the workspace with name, slug, and description",
+        "[DEPRECATED: use centrali://collections instead] List of all data structures in the workspace with name, slug, and description",
       mimeType: "application/json",
     },
     async (uri) => {
@@ -64,6 +64,7 @@ export function registerStructureResources(
   server.resource(
     "structure-schema",
     new ResourceTemplate("centrali://structures/{slug}", {
+
       list: async () => {
         try {
           const result = await sdk.structures.list({ limit: 100 });
@@ -81,7 +82,7 @@ export function registerStructureResources(
       },
     }),
     {
-      description: "Full schema definition for a specific structure",
+      description: "[DEPRECATED: use centrali://collections/{slug} instead] Full schema definition for a specific structure",
       mimeType: "application/json",
     },
     async (uri, { slug }) => {
@@ -102,3 +103,84 @@ export function registerStructureResources(
     }
   );
 }
+
+export function registerCollectionResources(
+  server: McpServer,
+  sdk: CentraliSDK
+) {
+  // Static resource: list all collections (gives LLM workspace context)
+  server.resource(
+    "collections-list",
+    "centrali://collections",
+    {
+      description:
+        "List of all data collections in the workspace with name, slug, and description",
+      mimeType: "application/json",
+    },
+    async (uri) => {
+      try {
+        const result = await sdk.collections.list({ limit: 100 });
+        const summary = (result.data || []).map((s) => ({
+          name: s.name,
+          recordSlug: s.recordSlug,
+          description: s.description || "",
+          propertyCount: s.properties?.length || 0,
+          status: s.status,
+        }));
+        return {
+          contents: [
+            {
+              uri: uri.href,
+              mimeType: "application/json",
+              text: JSON.stringify(summary, null, 2),
+            },
+          ],
+        };
+      } catch (error: unknown) {
+        throw new Error(formatError(error, "listing collections resource"));
+      }
+    }
+  );
+
+  // Resource template: full schema for a specific collection
+  server.resource(
+    "collection-schema",
+    new ResourceTemplate("centrali://collections/{slug}", {
+      list: async () => {
+        try {
+          const result = await sdk.collections.list({ limit: 100 });
+          return {
+            resources: (result.data || []).map((s) => ({
+              uri: `centrali://collections/${s.recordSlug}`,
+              name: s.name,
+              description: s.description || `Schema for ${s.name}`,
+              mimeType: "application/json",
+            })),
+          };
+        } catch (error: unknown) {
+          throw new Error(formatError(error, "listing collection schemas"));
+        }
+      },
+    }),
+    {
+      description: "Full schema definition for a specific collection",
+      mimeType: "application/json",
+    },
+    async (uri, { slug }) => {
+      try {
+        const result = await sdk.collections.getBySlug(slug as string);
+        return {
+          contents: [
+            {
+              uri: uri.href,
+              mimeType: "application/json",
+              text: JSON.stringify(result.data, null, 2),
+            },
+          ],
+        };
+      } catch (error: unknown) {
+        throw new Error(formatError(error, `getting collection schema for '${slug}'`));
+      }
+    }
+  );
+}

package/src/tools/search.ts

@@ -29,21 +29,31 @@ export function registerSearchTools(server: McpServer, sdk: CentraliSDK) {
     "Full-text search across records in the workspace. Powered by Meilisearch. Optionally filter by structure(s) and limit results.",
     {
       query: z.string().describe("The search query string"),
+      collections: z
+        .union([z.string(), z.array(z.string())])
+        .optional()
+        .describe(
+          "Filter by collection slug(s). Single slug string or array of slugs"
+        ),
       structures: z
         .union([z.string(), z.array(z.string())])
         .optional()
         .describe(
-          "Filter by structure slug(s). Single slug string or array of slugs"
+          "[DEPRECATED: use collections instead] Filter by structure slug(s). Single slug string or array of slugs"
         ),
       limit: z
         .number()
         .optional()
         .describe("Maximum results to return (default: 20, max: 100)"),
     },
-    async ({ query, structures, limit }) => {
+    async ({ query, collections, structures, limit }) => {
       try {
-        const options: { structures?: string | string[]; limit?: number } = {};
-        if (structures) options.structures = structures;
+        const options: { collections?: string | string[]; structures?: string | string[]; limit?: number } = {};
+        if (collections) {
+          options.collections = collections;
+        } else if (structures) {
+          options.collections = structures;
+        }
         if (limit) options.limit = limit;
 
         const result = await sdk.search(

package/src/tools/structures.ts

@@ -26,7 +26,7 @@ function formatError(error: unknown, context: string): string {
 export function registerStructureTools(server: McpServer, sdk: CentraliSDK) {
   server.tool(
     "list_structures",
-    "List all data structures (schemas) in the Centrali workspace. Returns name, slug, description, and property definitions for each structure.",
+    "[DEPRECATED: use list_collections instead] List all data structures (schemas) in the Centrali workspace. Returns name, slug, description, and property definitions for each structure.",
     {
       page: z.number().optional().describe("Page number (1-indexed)"),
       limit: z.number().optional().describe("Results per page"),
@@ -55,7 +55,7 @@ export function registerStructureTools(server: McpServer, sdk: CentraliSDK) {
 
   server.tool(
     "get_structure",
-    "Get the full schema definition for a specific structure by its record slug. Returns properties, types, constraints, and configuration.",
+    "[DEPRECATED: use get_collection instead] Get the full schema definition for a specific structure by its record slug. Returns properties, types, constraints, and configuration.",
     {
       recordSlug: z
         .string()
@@ -83,3 +83,64 @@ export function registerStructureTools(server: McpServer, sdk: CentraliSDK) {
     }
   );
 }
+
+export function registerCollectionTools(server: McpServer, sdk: CentraliSDK) {
+  server.tool(
+    "list_collections",
+    "List all data collections (schemas) in the Centrali workspace. Returns name, slug, description, and property definitions for each collection.",
+    {
+      page: z.number().optional().describe("Page number (1-indexed)"),
+      limit: z.number().optional().describe("Results per page"),
+    },
+    async ({ page, limit }) => {
+      try {
+        const result = await sdk.collections.list({ page, limit });
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(result.data, null, 2) },
+          ],
+        };
+      } catch (error: unknown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatError(error, "listing collections"),
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+
+  server.tool(
+    "get_collection",
+    "Get the full schema definition for a specific collection by its record slug. Returns properties, types, constraints, and configuration.",
+    {
+      recordSlug: z
+        .string()
+        .describe("The collection's record slug (e.g., 'orders', 'customers')"),
+    },
+    async ({ recordSlug }) => {
+      try {
+        const result = await sdk.collections.getBySlug(recordSlug);
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(result.data, null, 2) },
+          ],
+        };
+      } catch (error: unknown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatError(error, `getting collection '${recordSlug}'`),
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+}