@centrali-io/centrali-mcp 4.2.2 → 4.2.4

package/dist/tools/describe.js

@@ -184,28 +184,30 @@ function registerDescribeTools(server) {
                         },
                         property_shape: {
                             name: "string — field name (e.g., 'email', 'totalAmount')",
-                            type: "string — the field data type (see field_types below)",
+                            type: "string — one of: string, number, boolean, datetime, array, object, reference",
+                            description: "string | null — optional human-readable description",
                             required: "boolean — whether the field is mandatory",
-                            unique: "boolean — whether values must be unique across records",
-                            defaultValue: "any | null — default value for new records",
-                            description: "string | null — field description",
-                            config: "object | null — type-specific configuration (e.g., min/max for numbers, options for select)",
+                            nullable: "boolean — whether the field accepts null values",
+                            isUnique: "boolean — whether values must be unique across records",
+                            immutable: "boolean — field cannot be changed after creation",
+                            default: "any | null — default value for new records",
+                            enum: "any[] | null — restrict to specific allowed values",
                         },
                         field_types: {
-                            text: "Short text string",
-                            long_text: "Multi-line text / rich text",
-                            number: "Numeric value (integer or decimal). Config: { min, max, precision }",
-                            boolean: "True/false toggle",
-                            date: "Date value (ISO 8601)",
-                            datetime: "Date and time value (ISO 8601 with time)",
-                            email: "Email address (validated format)",
-                            url: "URL (validated format)",
-                            select: "Single choice from predefined options. Config: { options: [{ label, value }] }",
-                            multi_select: "Multiple choices from predefined options. Config: { options: [{ label, value }] }",
-                            reference: "Foreign key to another collection. Config: { referenceSlug: 'other-collection-slug' }",
-                            file: "File attachment (stored in Azure Blob Storage)",
-                            json: "Arbitrary JSON object",
-                            auto_increment: "Auto-incrementing integer (read-only)",
+                            string: "Text field. Options: minLength, maxLength, pattern (regex), renderAs ('textarea'|'secret'|'color'|'code'|'html'|'markdown'), enum (string[]), not (disallowed values), isSecret (boolean). Use enum for select-like behavior.",
+                            number: "Numeric field (integer or decimal). Options: minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf, enum (number[]), autoIncrement ({ startAt, incrementBy? }).",
+                            boolean: "True/false toggle. Options: default (boolean), enum ([true]|[false]).",
+                            datetime: "ISO 8601 date/time field. Options: earliestDate, latestDate, exclusiveEarliest, exclusiveLatest, default (ISO string), enum (ISO string[]).",
+                            array: "Array of typed items. Required: items: { type: 'string'|'number'|'boolean'|'datetime'|'object' }. Options: minItems, maxItems, uniqueItems, itemSchema (PropertyDefinition[] when items.type='object').",
+                            object: "Nested object. Options: properties (PropertyDefinition[]), requiredProperties (string[]), strictProperties (boolean — reject unknown fields).",
+                            reference: "Foreign key to another collection. Required: target (collection recordSlug), relationship ('many-to-one'|'one-to-one'|'many-to-many'), onDelete ('restrict'|'cascade'|'set_null'). Options: targetField (default: 'id'), displayField, nullable (required if onDelete='set_null').",
+                        },
+                        examples: {
+                            string_with_enum: '{ "name": "status", "type": "string", "required": true, "enum": ["active", "inactive", "archived"] }',
+                            number_with_range: '{ "name": "price", "type": "number", "minimum": 0, "maximum": 10000 }',
+                            reference: '{ "name": "categoryId", "type": "reference", "target": "categories", "relationship": "many-to-one", "onDelete": "restrict" }',
+                            array_of_strings: '{ "name": "tags", "type": "array", "items": { "type": "string" } }',
+                            nested_object: '{ "name": "address", "type": "object", "properties": [{ "name": "street", "type": "string" }, { "name": "city", "type": "string" }] }',
                         },
                         crud_tools: {
                             create_collection: {
@@ -231,6 +233,10 @@ function registerDescribeTools(server) {
                             "Use create_collection to define new data schemas with typed properties",
                             "Properties array defines the fields — each needs at minimum a name and type",
                             "Use schemaDiscoveryMode: 'flexible' to auto-add new fields when records are created",
+                            "For enum/select behavior, use type 'string' with an 'enum' array — there is no 'select' type",
+                            "For multi-line text, use type 'string' with renderAs: 'textarea'",
+                            "For JSON blobs, use type 'object' with strictProperties: false",
+                            "Property options go at the top level of the property object, NOT nested inside a 'config' key",
                         ],
                     }, null, 2),
                 },

package/dist/tools/structures.js

@@ -135,23 +135,23 @@ 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()))
             .optional()
-            .describe("Array of property definitions. Each property has name, type, and optional config (required, unique, defaultValue, description, config)"),
+            .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: zod_1.z.boolean().optional().describe("Enable record versioning (default: false)"),
         schemaDiscoveryMode: zod_1.z
             .enum(["strict", "flexible"])
             .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,
@@ -191,7 +191,11 @@ function registerCollectionTools(server, sdk) {
             .describe("Updated array of property definitions (replaces existing properties)"),
         enableVersioning: zod_1.z.boolean().optional().describe("Enable or disable record versioning"),
         tags: zod_1.z.array(zod_1.z.string()).optional().describe("Updated tags"),
-        defaultTtlSeconds: zod_1.z.number().nullable().optional().describe("Default TTL in seconds for new records. Set to null to clear."),
+        defaultTtlSeconds: zod_1.z
+            .number()
+            .nullable()
+            .optional()
+            .describe("Default TTL in seconds for new records. Set to null to clear."),
     }, (_a) => __awaiter(this, [_a], void 0, function* ({ collectionId, name, description, properties, enableVersioning, tags, defaultTtlSeconds }) {
         try {
             const input = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-mcp",
-  "version": "4.2.2",
+  "version": "4.2.4",
   "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

@@ -201,32 +201,41 @@ export function registerDescribeTools(server: McpServer) {
               },
               property_shape: {
                 name: "string — field name (e.g., 'email', 'totalAmount')",
-                type: "string — the field data type (see field_types below)",
+                type: "string — one of: string, number, boolean, datetime, array, object, reference",
+                description: "string | null — optional human-readable description",
                 required: "boolean — whether the field is mandatory",
-                unique: "boolean — whether values must be unique across records",
-                defaultValue: "any | null — default value for new records",
-                description: "string | null — field description",
-                config:
-                  "object | null — type-specific configuration (e.g., min/max for numbers, options for select)",
+                nullable: "boolean — whether the field accepts null values",
+                isUnique: "boolean — whether values must be unique across records",
+                immutable: "boolean — field cannot be changed after creation",
+                default: "any | null — default value for new records",
+                enum: "any[] | null — restrict to specific allowed values",
               },
               field_types: {
-                text: "Short text string",
-                long_text: "Multi-line text / rich text",
-                number: "Numeric value (integer or decimal). Config: { min, max, precision }",
-                boolean: "True/false toggle",
-                date: "Date value (ISO 8601)",
-                datetime: "Date and time value (ISO 8601 with time)",
-                email: "Email address (validated format)",
-                url: "URL (validated format)",
-                select:
-                  "Single choice from predefined options. Config: { options: [{ label, value }] }",
-                multi_select:
-                  "Multiple choices from predefined options. Config: { options: [{ label, value }] }",
+                string:
+                  "Text field. Options: minLength, maxLength, pattern (regex), renderAs ('textarea'|'secret'|'color'|'code'|'html'|'markdown'), enum (string[]), not (disallowed values), isSecret (boolean). Use enum for select-like behavior.",
+                number:
+                  "Numeric field (integer or decimal). Options: minimum, maximum, exclusiveMinimum, exclusiveMaximum, multipleOf, enum (number[]), autoIncrement ({ startAt, incrementBy? }).",
+                boolean: "True/false toggle. Options: default (boolean), enum ([true]|[false]).",
+                datetime:
+                  "ISO 8601 date/time field. Options: earliestDate, latestDate, exclusiveEarliest, exclusiveLatest, default (ISO string), enum (ISO string[]).",
+                array:
+                  "Array of typed items. Required: items: { type: 'string'|'number'|'boolean'|'datetime'|'object' }. Options: minItems, maxItems, uniqueItems, itemSchema (PropertyDefinition[] when items.type='object').",
+                object:
+                  "Nested object. Options: properties (PropertyDefinition[]), requiredProperties (string[]), strictProperties (boolean — reject unknown fields).",
                 reference:
-                  "Foreign key to another collection. Config: { referenceSlug: 'other-collection-slug' }",
-                file: "File attachment (stored in Azure Blob Storage)",
-                json: "Arbitrary JSON object",
-                auto_increment: "Auto-incrementing integer (read-only)",
+                  "Foreign key to another collection. Required: target (collection recordSlug), relationship ('many-to-one'|'one-to-one'|'many-to-many'), onDelete ('restrict'|'cascade'|'set_null'). Options: targetField (default: 'id'), displayField, nullable (required if onDelete='set_null').",
+              },
+              examples: {
+                string_with_enum:
+                  '{ "name": "status", "type": "string", "required": true, "enum": ["active", "inactive", "archived"] }',
+                number_with_range:
+                  '{ "name": "price", "type": "number", "minimum": 0, "maximum": 10000 }',
+                reference:
+                  '{ "name": "categoryId", "type": "reference", "target": "categories", "relationship": "many-to-one", "onDelete": "restrict" }',
+                array_of_strings:
+                  '{ "name": "tags", "type": "array", "items": { "type": "string" } }',
+                nested_object:
+                  '{ "name": "address", "type": "object", "properties": [{ "name": "street", "type": "string" }, { "name": "city", "type": "string" }] }',
               },
               crud_tools: {
                 create_collection: {
@@ -252,6 +261,10 @@ export function registerDescribeTools(server: McpServer) {
                 "Use create_collection to define new data schemas with typed properties",
                 "Properties array defines the fields — each needs at minimum a name and type",
                 "Use schemaDiscoveryMode: 'flexible' to auto-add new fields when records are created",
+                "For enum/select behavior, use type 'string' with an 'enum' array — there is no 'select' type",
+                "For multi-line text, use type 'string' with renderAs: 'textarea'",
+                "For JSON blobs, use type 'object' with strictProperties: false",
+                "Property options go at the top level of the property object, NOT nested inside a 'config' key",
               ],
             },
             null,

package/src/tools/structures.ts

@@ -146,15 +146,17 @@ 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()))
         .optional()
-        .describe("Array of property definitions. Each property has name, type, and optional config (required, unique, defaultValue, description, config)"),
+        .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"])
@@ -162,15 +164,14 @@ 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;
         if (schemaDiscoveryMode !== undefined) input.schemaDiscoveryMode = schemaDiscoveryMode;
         if (tags !== undefined) input.tags = tags;
-
         const result = await sdk.collections.create(input as any);
         return {
           content: [
@@ -182,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,
@@ -204,7 +205,11 @@ export function registerCollectionTools(server: McpServer, sdk: CentraliSDK) {
         .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."),
+      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 {
@@ -215,7 +220,6 @@ export function registerCollectionTools(server: McpServer, sdk: CentraliSDK) {
         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: [