@centrali-io/centrali-mcp 4.2.1 → 4.2.3

package/src/tools/structures.ts

@@ -143,4 +143,131 @@ 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.",
+    {
+      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')"),
+      description: z.string().optional().describe("Optional description of the collection"),
+      properties: z
+        .array(z.record(z.string(), z.any()))
+        .optional()
+        .describe(
+          "Array of property definitions. Each property needs 'name' and 'type' (string|number|boolean|datetime|array|object|reference). Type-specific options go at the top level, NOT inside a 'config' key. Use describe_collections for full schema reference."
+        ),
+      enableVersioning: z.boolean().optional().describe("Enable record versioning (default: false)"),
+      schemaDiscoveryMode: z
+        .enum(["strict", "flexible"])
+        .optional()
+        .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 }) => {
+      try {
+        const input: Record<string, any> = { name, slug };
+        if (description !== undefined) input.description = description;
+        if (properties !== undefined) input.properties = properties;
+        if (enableVersioning !== undefined) input.enableVersioning = enableVersioning;
+        if (schemaDiscoveryMode !== undefined) input.schemaDiscoveryMode = schemaDiscoveryMode;
+        if (tags !== undefined) input.tags = tags;
+        const result = await sdk.collections.create(input as any);
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(result.data, null, 2) },
+          ],
+        };
+      } catch (error: unknown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatError(error, `creating collection '${slug}'`),
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+
+  server.tool(
+    "update_collection",
+    "Update an existing collection by ID. Only include the fields you want to change.",
+    {
+      collectionId: z.string().describe("The collection ID (UUID) to update"),
+      name: z.string().optional().describe("Updated display name"),
+      description: z.string().optional().describe("Updated description"),
+      properties: z
+        .array(z.record(z.string(), z.any()))
+        .optional()
+        .describe("Updated array of property definitions (replaces existing properties)"),
+      enableVersioning: z.boolean().optional().describe("Enable or disable record versioning"),
+      tags: z.array(z.string()).optional().describe("Updated tags"),
+      defaultTtlSeconds: z
+        .number()
+        .nullable()
+        .optional()
+        .describe("Default TTL in seconds for new records. Set to null to clear."),
+    },
+    async ({ collectionId, name, description, properties, enableVersioning, tags, defaultTtlSeconds }) => {
+      try {
+        const input: Record<string, any> = {};
+        if (name !== undefined) input.name = name;
+        if (description !== undefined) input.description = description;
+        if (properties !== undefined) input.properties = properties;
+        if (enableVersioning !== undefined) input.enableVersioning = enableVersioning;
+        if (tags !== undefined) input.tags = tags;
+        if (defaultTtlSeconds !== undefined) input.defaultTtlSeconds = defaultTtlSeconds;
+        const result = await sdk.collections.update(collectionId, input as any);
+        return {
+          content: [
+            { type: "text", text: JSON.stringify(result.data, null, 2) },
+          ],
+        };
+      } catch (error: unknown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatError(error, `updating collection '${collectionId}'`),
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
+
+  server.tool(
+    "delete_collection",
+    "Delete a collection by ID. This permanently removes the collection schema and all its records.",
+    {
+      collectionId: z.string().describe("The collection ID (UUID) to delete"),
+    },
+    async ({ collectionId }) => {
+      try {
+        await sdk.collections.delete(collectionId);
+        return {
+          content: [
+            {
+              type: "text",
+              text: `Collection '${collectionId}' deleted successfully.`,
+            },
+          ],
+        };
+      } catch (error: unknown) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: formatError(error, `deleting collection '${collectionId}'`),
+            },
+          ],
+          isError: true,
+        };
+      }
+    }
+  );
 }