@norbix.ai/mcp 0.2.1 → 0.4.0

package/dist/manifest/endpoints.json

@@ -1646,7 +1646,7 @@
   "method": "authenticate",
   "requestDto": "Authenticate",
   "responseDto": "AuthenticateResponse",
-  "path": "/auth",
+  "path": "/v3/auth",
   "verb": "POST",
   "pathParams": [],
   "scope": "unauthenticated"
@@ -2589,6 +2589,19 @@
   ],
   "scope": "project"
  },
+ {
+  "surface": "hub",
+  "group": "database",
+  "method": "getDatabaseSchemaIndexStatus",
+  "requestDto": "GetDatabaseSchemaIndexStatus",
+  "responseDto": "GetDatabaseSchemaIndexStatusResponse",
+  "path": "/{version}/database/schemas/{Id}/index-status",
+  "verb": "GET",
+  "pathParams": [
+   "Id"
+  ],
+  "scope": "project"
+ },
  {
   "surface": "hub",
   "group": "database",
@@ -3578,6 +3591,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",
@@ -5852,10 +5876,21 @@
  {
   "surface": "hub",
   "group": "oauth",
-  "method": "oAuthAuthorizeDecision",
-  "requestDto": "OAuthAuthorizeDecisionRequest",
-  "responseDto": "string",
-  "path": "/{version}/oauth/authorize",
+  "method": "oAuthConsent",
+  "requestDto": "OAuthConsentRequest",
+  "responseDto": "OAuthConsentResponse",
+  "path": "/{version}/oauth/consent",
+  "verb": "GET",
+  "pathParams": [],
+  "scope": "project"
+ },
+ {
+  "surface": "hub",
+  "group": "oauth",
+  "method": "oAuthConsentDecision",
+  "requestDto": "OAuthConsentDecisionRequest",
+  "responseDto": "OAuthConsentDecisionResponse",
+  "path": "/{version}/oauth/consent",
   "verb": "POST",
   "pathParams": [],
   "scope": "project"
@@ -6301,6 +6336,19 @@
   "pathParams": [],
   "scope": "project"
  },
+ {
+  "surface": "hub",
+  "group": "scheduler",
+  "method": "getSchedulerTaskRuns",
+  "requestDto": "GetSchedulerTaskRuns",
+  "responseDto": "SchedulerTaskRunsResponse",
+  "path": "/{version}/scheduler/tasks/{id}/runs",
+  "verb": "GET",
+  "pathParams": [
+   "id"
+  ],
+  "scope": "project"
+ },
  {
   "surface": "hub",
   "group": "scheduler",
@@ -6802,7 +6850,7 @@
   "method": "authenticate",
   "requestDto": "Authenticate",
   "responseDto": "AuthenticateResponse",
-  "path": "/auth",
+  "path": "/v3/auth",
   "verb": "POST",
   "pathParams": [],
   "scope": "unauthenticated"
@@ -7185,6 +7233,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.1",
+  "version": "0.4.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",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.0",
-    "@norbix.ai/ts": "^4.11.0",
+    "@norbix.ai/ts": "^4.17.0",
     "express": "^4.21.2",
     "zod": "^3.24.0"
   },