@norbix.ai/mcp 0.2.0 → 0.3.0

package/dist/manifest/dtos.hub.json

@@ -10660,6 +10660,11 @@
     "type": "{ [index: string]: string }",
     "optional": true
    },
+   {
+    "name": "slug",
+    "type": "string",
+    "optional": true
+   },
    {
     "name": "description",
     "type": "string",
@@ -10760,6 +10765,11 @@
     "type": "{ [index: string]: string }",
     "optional": true
    },
+   {
+    "name": "slug",
+    "type": "string",
+    "optional": true
+   },
    {
     "name": "description",
     "type": "string",
@@ -12623,6 +12633,11 @@
     "type": "string",
     "optional": false
    },
+   {
+    "name": "env",
+    "type": "string",
+    "optional": true
+   },
    {
     "name": "eventName",
     "type": "string",
@@ -12743,6 +12758,11 @@
     "type": "string",
     "optional": true
    },
+   {
+    "name": "env",
+    "type": "string",
+    "optional": false
+   },
    {
     "name": "meta",
     "type": "IReadOnlyDictionary<string, string>",
@@ -15322,6 +15342,16 @@
     "name": "translateOptions",
     "type": "IReadOnlyDictionary<string, string>",
     "optional": true
+   },
+   {
+    "name": "default",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "unique",
+    "type": "boolean",
+    "optional": true
    }
   ]
  },
@@ -15342,6 +15372,31 @@
     "name": "multipleOf",
     "type": "number",
     "optional": true
+   },
+   {
+    "name": "default",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "unique",
+    "type": "boolean",
+    "optional": true
+   }
+  ]
+ },
+ "CurrencyDefaultDto": {
+  "base": null,
+  "fields": [
+   {
+    "name": "value",
+    "type": "number",
+    "optional": false
+   },
+   {
+    "name": "currency",
+    "type": "string",
+    "optional": false
    }
   ]
  },
@@ -15352,12 +15407,38 @@
     "name": "allowedCurrencies",
     "type": "IReadOnlyList<string>",
     "optional": true
+   },
+   {
+    "name": "multipleOf",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "minimum",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "maximum",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "default",
+    "type": "CurrencyDefaultDto",
+    "optional": true
    }
   ]
  },
  "BooleanFieldDto": {
   "base": "JsonSchemaFieldDto",
-  "fields": []
+  "fields": [
+   {
+    "name": "default",
+    "type": "boolean",
+    "optional": true
+   }
+  ]
  },
  "DateFieldDto": {
   "base": "JsonSchemaFieldDto",
@@ -15371,6 +15452,11 @@
     "name": "maximum",
     "type": "number",
     "optional": true
+   },
+   {
+    "name": "default",
+    "type": "number",
+    "optional": true
    }
   ]
  },
@@ -15386,6 +15472,16 @@
     "name": "maximum",
     "type": "number",
     "optional": true
+   },
+   {
+    "name": "default",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "unique",
+    "type": "boolean",
+    "optional": true
    }
   ]
  },
@@ -15401,7 +15497,23 @@
  },
  "TagsFieldDto": {
   "base": "JsonSchemaFieldDto",
-  "fields": []
+  "fields": [
+   {
+    "name": "minItems",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "maxItems",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "default",
+    "type": "IReadOnlyList<string>",
+    "optional": true
+   }
+  ]
  },
  "FileFieldDto": {
   "base": "JsonSchemaFieldDto",
@@ -15410,6 +15522,26 @@
     "name": "storages",
     "type": "IReadOnlyList<string>",
     "optional": true
+   },
+   {
+    "name": "minItems",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "maxItems",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "allowedFileType",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "maxSizeMb",
+    "type": "number",
+    "optional": true
    }
   ]
  },
@@ -15425,6 +15557,11 @@
     "name": "multiple",
     "type": "boolean",
     "optional": false
+   },
+   {
+    "name": "displayField",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -15455,6 +15592,11 @@
     "name": "multiple",
     "type": "boolean",
     "optional": false
+   },
+   {
+    "name": "displayField",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -15465,6 +15607,11 @@
     "name": "multiple",
     "type": "boolean",
     "optional": false
+   },
+   {
+    "name": "displayField",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -15480,6 +15627,61 @@
     "name": "multiple",
     "type": "boolean",
     "optional": false
+   },
+   {
+    "name": "default",
+    "type": "IReadOnlyList<string>",
+    "optional": true
+   }
+  ]
+ },
+ "ObjectFieldDto": {
+  "base": "JsonSchemaFieldDto",
+  "fields": [
+   {
+    "name": "properties",
+    "type": "IReadOnlyList<JsonSchemaFieldDto>",
+    "optional": false
+   },
+   {
+    "name": "required",
+    "type": "IReadOnlyList<string>",
+    "optional": true
+   }
+  ]
+ },
+ "ArrayFieldDto": {
+  "base": "JsonSchemaFieldDto",
+  "fields": [
+   {
+    "name": "items",
+    "type": "JsonSchemaFieldDto",
+    "optional": false
+   },
+   {
+    "name": "minItems",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "maxItems",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "uniqueItems",
+    "type": "boolean",
+    "optional": true
+   }
+  ]
+ },
+ "JsonFieldDto": {
+  "base": "JsonSchemaFieldDto",
+  "fields": [
+   {
+    "name": "maxBytes",
+    "type": "number",
+    "optional": true
    }
   ]
  },
@@ -16744,6 +16946,26 @@
    }
   ]
  },
+ "GetFileByIdResponse": {
+  "base": "ResponseBase",
+  "fields": [
+   {
+    "name": "file",
+    "type": "FileResourceRefDto",
+    "optional": true
+   },
+   {
+    "name": "isPublic",
+    "type": "boolean",
+    "optional": true
+   },
+   {
+    "name": "publicUrl",
+    "type": "string",
+    "optional": true
+   }
+  ]
+ },
  "GetFolderFilesResponse": {
   "base": "ResponseBase",
   "fields": [
@@ -22845,6 +23067,11 @@
     "name": "sortOrder",
     "type": "number",
     "optional": true
+   },
+   {
+    "name": "expandReferences",
+    "type": "boolean",
+    "optional": false
    }
   ]
  },
@@ -22865,6 +23092,11 @@
     "name": "databaseIntegrationId",
     "type": "string",
     "optional": true
+   },
+   {
+    "name": "expandReferences",
+    "type": "boolean",
+    "optional": false
    }
   ]
  },
@@ -22995,6 +23227,11 @@
     "name": "update",
     "type": "string",
     "optional": false
+   },
+   {
+    "name": "arrayFilters",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -23020,6 +23257,11 @@
     "name": "update",
     "type": "string",
     "optional": false
+   },
+   {
+    "name": "arrayFilters",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -23513,6 +23755,21 @@
    }
   ]
  },
+ "GetFileById": {
+  "base": "CodeMashRequestBase",
+  "fields": [
+   {
+    "name": "filesIntegrationId",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "id",
+    "type": "string",
+    "optional": false
+   }
+  ]
+ },
  "GetFolderFiles": {
   "base": "CodeMashListPaginationRequestBase",
   "fields": [

package/dist/manifest/endpoints.json

@@ -3578,6 +3578,17 @@
   "pathParams": [],
   "scope": "project"
  },
+ {
+  "surface": "hub",
+  "group": "files",
+  "method": "getFileById",
+  "requestDto": "GetFileById",
+  "responseDto": "GetFileByIdResponse",
+  "path": "/{version}/files/item/by-id",
+  "verb": "GET",
+  "pathParams": [],
+  "scope": "project"
+ },
  {
   "surface": "hub",
   "group": "files",
@@ -7185,6 +7196,20 @@
   ],
   "scope": "project"
  },
+ {
+  "surface": "api",
+  "group": "files",
+  "method": "getFileById",
+  "requestDto": "GetFileByIdRequest",
+  "responseDto": "GetFileByIdResponse",
+  "path": "/{version}/files/{filesIntegrationId}/by-id/{id}",
+  "verb": "GET",
+  "pathParams": [
+   "filesIntegrationId",
+   "id"
+  ],
+  "scope": "project"
+ },
  {
   "surface": "api",
   "group": "files",

package/dist/server.js

@@ -72,7 +72,6 @@ export const curated = [
     { name: 'norbix_get_marketplace_integrations', surface: 'hub', group: 'code', method: 'getMarketplaceIntegrations', description: 'List marketplace integrations of the project.' },
     { name: 'norbix_save_marketplace_integration', surface: 'hub', group: 'code', method: 'saveMarketplaceIntegration', description: 'Create or update a marketplace integration.' },
     { name: 'norbix_get_database_schemas', surface: 'hub', group: 'database', method: 'getDatabaseSchemas', description: 'List database collection schemas of the project.' },
-    { name: 'norbix_find_documents', surface: 'api', group: 'database', method: 'find', description: 'Query documents in a database collection (filter, sort, projection, paging).' },
     { name: 'norbix_get_roles', surface: 'hub', group: 'membership', method: 'getRoles', description: 'List membership roles of the project.' },
     { name: 'norbix_get_policies', surface: 'hub', group: 'membership', method: 'getPolicies', description: 'List membership policies of the project.' },
     { name: 'norbix_get_logs', surface: 'hub', group: 'logs', method: 'getLogs', description: 'Query project logs.' },
@@ -106,6 +105,69 @@ export function buildServer(handle) {
         .string()
         .optional()
         .describe('Database integration id; omit for the project default database.');
+    const expandReferences = z
+        .boolean()
+        .optional()
+        .describe('true = every reference field (user, role, taxonomy term, collection record, file) comes back as { id, display } — an array of them when the field is multiple. display is the target’s displayField (a term: { title, slug? }); null when the target is missing or your key may not read it. Default false = the stored ids only.');
+    server.registerTool('norbix_find_documents', {
+        title: 'norbix_find_documents',
+        description: 'Query documents in a database collection: MongoDB filter, sort, cursor paging, optional reference expansion. [GET /{version}/database/collections/{collectionName}]',
+        inputSchema: {
+            collectionName: z.string().describe('Collection (schema) name, e.g. "products".'),
+            filter: jsonValue.optional().describe('MongoDB filter (object or JSON string), e.g. { "price": { "$gt": 5 } }.'),
+            sortBy: z.string().optional().describe('Field to sort by.'),
+            sortOrder: z.number().int().optional().describe('1 = ascending, -1 = descending.'),
+            pageSize: z.number().int().min(1).max(1000).optional(),
+            startingAfter: z.string().optional().describe('Cursor paging: id of the last document of the previous page.'),
+            endingBefore: z.string().optional().describe('Cursor paging: id of the first document of the next page.'),
+            expandReferences,
+            databaseIntegrationId: integrationId,
+            body: z
+                .record(z.unknown())
+                .optional()
+                .describe('Any other FindRequest field (schemaVersion, pagingArgs, …). The named inputs above win over the same key here.'),
+        },
+    }, async ({ collectionName, filter, sortBy, sortOrder, pageSize, startingAfter, endingBefore, expandReferences: expand, databaseIntegrationId, body }) => {
+        try {
+            return json(await invoke(handle.client, 'api', 'database', 'find', {
+                ...(body ?? {}),
+                collectionName,
+                ...(filter !== undefined ? { filter: asJson(filter) } : {}),
+                ...(sortBy !== undefined ? { sortBy } : {}),
+                ...(sortOrder !== undefined ? { sortOrder } : {}),
+                ...(pageSize !== undefined ? { pageSize } : {}),
+                ...(startingAfter !== undefined ? { startingAfter } : {}),
+                ...(endingBefore !== undefined ? { endingBefore } : {}),
+                ...(expand !== undefined ? { expandReferences: expand } : {}),
+                ...(databaseIntegrationId ? { databaseIntegrationId } : {}),
+            }));
+        }
+        catch (e) {
+            return err(e);
+        }
+    });
+    server.registerTool('norbix_find_one_document', {
+        title: 'norbix_find_one_document',
+        description: 'Get one document by id, with optional reference expansion. [GET /{version}/database/collections/{collectionName}/{id}]',
+        inputSchema: {
+            collectionName: z.string().describe('Collection (schema) name.'),
+            id: z.string().describe('Document id.'),
+            expandReferences,
+            databaseIntegrationId: integrationId,
+        },
+    }, async ({ collectionName, id, expandReferences: expand, databaseIntegrationId }) => {
+        try {
+            return json(await invoke(handle.client, 'api', 'database', 'findOne', {
+                collectionName,
+                id,
+                ...(expand !== undefined ? { expandReferences: expand } : {}),
+                ...(databaseIntegrationId ? { databaseIntegrationId } : {}),
+            }));
+        }
+        catch (e) {
+            return err(e);
+        }
+    });
     server.registerTool('norbix_insert_document', {
         title: 'norbix_insert_document',
         description: 'Insert one document into a database collection. Returns the new id. [POST /{version}/database/collections/{collectionName}]',
@@ -133,14 +195,18 @@ export function buildServer(handle) {
             collectionName: z.string().describe('Collection (schema) name.'),
             id: z.string().describe('Document id.'),
             update: jsonValue.describe('The fields to change as a plain document, e.g. { "field": "value" } (object or JSON string). No $ operators.'),
+            arrayFilters: jsonValue
+                .optional()
+                .describe('MongoDB arrayFilters for positional paths in update, e.g. update { "items.$[i].qty": 2 } with arrayFilters [ { "i.sku": "A1" } ] (array or JSON string).'),
             databaseIntegrationId: integrationId,
         },
-    }, async ({ collectionName, id, update, databaseIntegrationId }) => {
+    }, async ({ collectionName, id, update, arrayFilters, databaseIntegrationId }) => {
         try {
             return json(await invoke(handle.client, 'api', 'database', 'updateOne', {
                 collectionName,
                 id,
                 update: asJson(update),
+                ...(arrayFilters !== undefined ? { arrayFilters: asJson(arrayFilters) } : {}),
                 ...(databaseIntegrationId ? { databaseIntegrationId } : {}),
             }));
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norbix.ai/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Norbix MCP server — manage projects, integrations, databases, membership, notifications and every other Norbix Hub/API endpoint from Claude, Cursor, VS Code, Windsurf or any MCP client.",
   "author": "UAB Isidos",
   "license": "MIT",
@@ -35,7 +35,7 @@
   },
   "scripts": {
     "generate-manifest": "node scripts/generate-manifest.mjs",
-    "build": "tsc && cp -r src/manifest dist/manifest && node -e \"require('fs').chmodSync('dist/index.js', 0o755)\"",
+    "build": "tsc && node -e \"const fs=require('fs');fs.rmSync('dist/manifest',{recursive:true,force:true});fs.cpSync('src/manifest','dist/manifest',{recursive:true});fs.chmodSync('dist/index.js',0o755)\"",
     "prepublishOnly": "npm run build",
     "start": "node dist/index.js",
     "start:http": "node dist/index.js --http",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "@norbix.ai/ts": "^4.11.0",
+    "@norbix.ai/ts": "^4.14.0",
     "express": "^4.21.2",
     "zod": "^3.24.0"
   },