@norbix.ai/mcp 0.6.0 → 0.8.0

package/README.md

@@ -166,7 +166,9 @@ NORBIX_HUB_URL=https://hub.norbix.ai norbix-mcp --http --port 3010
 `norbix_test_integration`, `norbix_get_code_functions`, `norbix_get_code_function_qualifiers`,
 `norbix_invoke_code_function`, `norbix_get_code_function_event_sample`,
 `norbix_get_code_function_runs`, `norbix_get_marketplace_integrations`,
-`norbix_save_marketplace_integration`, `norbix_get_database_schemas`,
+`norbix_save_marketplace_integration`, `norbix_test_marketplace_integration`,
+`norbix_invoke_marketplace_function`, `norbix_get_marketplace_function_runs`,
+`norbix_get_database_schemas`,
 `norbix_find_documents`, `norbix_find_one_document`, `norbix_insert_document`,
 `norbix_update_document`, `norbix_get_taxonomy_terms`, `norbix_get_roles`, `norbix_get_policies`,
 `norbix_get_logs`, `norbix_list_service_api_keys`.
@@ -203,6 +205,16 @@ envelope itself (`CodeFunctionEventDto`: `specVersion`, `event`, `source`,
 `context.runAs.accessToken`, `data.{database,user,file,payment,ai,task,payload}`,
 `config`) is in `norbix_describe_endpoint("getCodeFunctionEventSample")`.
 
+**Marketplace** (`@norbix.ai/ts` 4.21.0): `norbix_save_marketplace_integration`
+enables a listing as a connection (empty `integration.viewId` → the answer's `id`
+is the minted `int_…`), `norbix_test_marketplace_integration` runs its validation
+steps (`steps[]`; functions can be added once every `requiredForFunctions` step
+succeeded), `norbix_invoke_marketplace_function` calls a function by hand
+(`functionViewId`, `payload`), and `norbix_get_marketplace_function_runs` lists
+the last runs of a trigger or task. Listings, functions (`saveMarketplaceFunction`
+with `arguments` and `inputs`) and the rest of the 23 routes are reached with
+`norbix_search_endpoints("marketplace")`.
+
 ## Database tools
 
 Six shortcuts cover the everyday database work. Everything else in the

package/dist/manifest/dtos.hub.json

@@ -212,6 +212,16 @@
     "name": "resolver",
     "type": "TokenMappingResolverType",
     "optional": false
+   },
+   {
+    "name": "secretKeys",
+    "type": "string[]",
+    "optional": true
+   },
+   {
+    "name": "secretFormat",
+    "type": "SecretValueFormat",
+    "optional": true
    }
   ]
  },
@@ -3312,6 +3322,11 @@
     "name": "payload",
     "type": "{ [index: string]: string }",
     "optional": true
+   },
+   {
+    "name": "runAsUserId",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -5623,6 +5638,41 @@
    }
   ]
  },
+ "MarketplaceValidationStepResultDto": {
+  "base": null,
+  "fields": [
+   {
+    "name": "key",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "label",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "requiredForFunctions",
+    "type": "boolean",
+    "optional": false
+   },
+   {
+    "name": "succeeded",
+    "type": "boolean",
+    "optional": false
+   },
+   {
+    "name": "skipped",
+    "type": "boolean",
+    "optional": false
+   },
+   {
+    "name": "message",
+    "type": "string",
+    "optional": true
+   }
+  ]
+ },
  "MarketplaceIntegrationDto": {
   "base": "IntegrationDto",
   "fields": [
@@ -5655,36 +5705,41 @@
     "name": "config",
     "type": "IReadOnlyDictionary<string, string>",
     "optional": false
+   },
+   {
+    "name": "lastValidationSteps",
+    "type": "MarketplaceValidationStepResultDto[]",
+    "optional": true
    }
   ]
  },
- "MarketplaceTokenMappingDto": {
+ "MarketplaceFunctionParameterDto": {
   "base": null,
   "fields": [
    {
-    "name": "token",
+    "name": "name",
     "type": "string",
     "optional": false
    },
    {
-    "name": "resolver",
-    "type": "MarketplaceTokenResolverKind",
+    "name": "type",
+    "type": "string",
     "optional": false
    },
    {
-    "name": "value",
+    "name": "description",
     "type": "string",
     "optional": true
    },
    {
-    "name": "secretKeys",
-    "type": "string[]",
-    "optional": true
+    "name": "isRequired",
+    "type": "boolean",
+    "optional": false
    },
    {
-    "name": "format",
-    "type": "MarketplaceSecretValueFormat",
-    "optional": false
+    "name": "defaultValue",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -5724,11 +5779,21 @@
    {
     "name": "requestTemplate",
     "type": "string",
+    "optional": true
+   },
+   {
+    "name": "arguments",
+    "type": "{ [index: string]: string } = {}",
+    "optional": false
+   },
+   {
+    "name": "inputs",
+    "type": "MarketplaceFunctionParameterDto[] = []",
     "optional": false
    },
    {
     "name": "mappedTokens",
-    "type": "MarketplaceTokenMappingDto[] = []",
+    "type": "TokenMappingDto[] = []",
     "optional": false
    }
   ]
@@ -5788,33 +5853,23 @@
    }
   ]
  },
- "MarketplaceFunctionParameterDto": {
+ "MarketplaceInstallFormDto": {
   "base": null,
   "fields": [
    {
-    "name": "name",
+    "name": "dataSchema",
     "type": "string",
     "optional": false
    },
    {
-    "name": "type",
+    "name": "uiSchema",
     "type": "string",
     "optional": false
    },
    {
-    "name": "description",
-    "type": "string",
-    "optional": true
-   },
-   {
-    "name": "isRequired",
-    "type": "boolean",
+    "name": "secretKeys",
+    "type": "string[] = []",
     "optional": false
-   },
-   {
-    "name": "defaultValue",
-    "type": "string",
-    "optional": true
    }
   ]
  },
@@ -5888,6 +5943,36 @@
    }
   ]
  },
+ "MarketplaceValidationStepDto": {
+  "base": null,
+  "fields": [
+   {
+    "name": "key",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "label",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "description",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "requiredForFunctions",
+    "type": "boolean",
+    "optional": false
+   },
+   {
+    "name": "probe",
+    "type": "MarketplaceHttpRequestSpecDto",
+    "optional": true
+   }
+  ]
+ },
  "MarketplaceFunctionDefinitionDto": {
   "base": null,
   "fields": [
@@ -5916,6 +6001,16 @@
     "type": "string",
     "optional": true
    },
+   {
+    "name": "formKind",
+    "type": "MarketplaceFormKind",
+    "optional": false
+   },
+   {
+    "name": "inputs",
+    "type": "IReadOnlyList<MarketplaceFunctionParameterDto>",
+    "optional": false
+   },
    {
     "name": "parameters",
     "type": "IReadOnlyList<MarketplaceFunctionParameterDto>",
@@ -5938,7 +6033,7 @@
    },
    {
     "name": "defaultTokenMappings",
-    "type": "MarketplaceTokenMappingDto[] = []",
+    "type": "TokenMappingDto[] = []",
     "optional": false
    }
   ]
@@ -5991,6 +6086,16 @@
     "type": "string",
     "optional": true
    },
+   {
+    "name": "videoUrl",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "availability",
+    "type": "MarketplaceAvailability",
+    "optional": false
+   },
    {
     "name": "isOfficial",
     "type": "boolean",
@@ -6016,6 +6121,16 @@
     "type": "IReadOnlyList<MarketplaceFieldDefinitionDto>",
     "optional": false
    },
+   {
+    "name": "installForm",
+    "type": "MarketplaceInstallFormDto",
+    "optional": true
+   },
+   {
+    "name": "validationSteps",
+    "type": "IReadOnlyList<MarketplaceValidationStepDto>",
+    "optional": false
+   },
    {
     "name": "functions",
     "type": "IReadOnlyList<MarketplaceFunctionDefinitionDto>",
@@ -7348,6 +7463,31 @@
    }
   ]
  },
+ "MarketplaceFunctionCallDto": {
+  "base": null,
+  "fields": [
+   {
+    "name": "functionId",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "functionKey",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "integrationId",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "payload",
+    "type": "{ [index: string]: Object } = {}",
+    "optional": false
+   }
+  ]
+ },
  "CodeFunctionDataDto": {
   "base": null,
   "fields": [
@@ -7385,6 +7525,11 @@
     "name": "payload",
     "type": "{ [index: string]: Object }",
     "optional": true
+   },
+   {
+    "name": "marketplace",
+    "type": "MarketplaceFunctionCallDto",
+    "optional": true
    }
   ]
  },
@@ -7482,6 +7627,26 @@
    }
   ]
  },
+ "MarketplaceFunctionSchedulerTaskRequest": {
+  "base": "SchedulerTaskRequest",
+  "fields": [
+   {
+    "name": "type",
+    "type": "SchedulerTaskType",
+    "optional": false
+   },
+   {
+    "name": "functionId",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "payload",
+    "type": "{ [index: string]: string }",
+    "optional": true
+   }
+  ]
+ },
  "ICultureBasedRequest": {
   "base": null,
   "fields": [
@@ -9573,11 +9738,6 @@
     "name": "isEnabled",
     "type": "boolean",
     "optional": false
-   },
-   {
-    "name": "defaultIntegrationViewId",
-    "type": "string",
-    "optional": true
    }
   ]
  },
@@ -10949,6 +11109,16 @@
     "type": "string",
     "optional": true
    },
+   {
+    "name": "lastHeartbeatOutcome",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "lastHeartbeatError",
+    "type": "string",
+    "optional": true
+   },
    {
     "name": "message",
     "type": "string",
@@ -13491,6 +13661,16 @@
     "name": "functionCount",
     "type": "number",
     "optional": false
+   },
+   {
+    "name": "availability",
+    "type": "MarketplaceAvailability",
+    "optional": false
+   },
+   {
+    "name": "videoUrl",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -13594,6 +13774,61 @@
    }
   ]
  },
+ "MarketplaceFunctionRunDto": {
+  "base": null,
+  "fields": [
+   {
+    "name": "firedAt",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "event",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "source",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "functionId",
+    "type": "string",
+    "optional": false
+   },
+   {
+    "name": "runAsUserId",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "succeeded",
+    "type": "boolean",
+    "optional": false
+   },
+   {
+    "name": "durationMs",
+    "type": "number",
+    "optional": true
+   },
+   {
+    "name": "error",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "vendorRequestId",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "input",
+    "type": "string",
+    "optional": true
+   }
+  ]
+ },
  "CodeIntegrationListProjection": {
   "base": "IntegrationListProjection",
   "fields": [
@@ -13716,6 +13951,11 @@
     "name": "requestId",
     "type": "string",
     "optional": true
+   },
+   {
+    "name": "input",
+    "type": "string",
+    "optional": true
    }
   ]
  },
@@ -17356,6 +17596,16 @@
    }
   ]
  },
+ "GetLicenseKeyResponse": {
+  "base": "ResponseBase",
+  "fields": [
+   {
+    "name": "key",
+    "type": "string",
+    "optional": true
+   }
+  ]
+ },
  "CreateAiServiceUserResponse": {
   "base": "ResponseBase",
   "fields": [
@@ -18592,6 +18842,11 @@
     "name": "items",
     "type": "IReadOnlyList<IntegrationTestResultItemDto>",
     "optional": true
+   },
+   {
+    "name": "steps",
+    "type": "IReadOnlyList<MarketplaceValidationStepResultDto>",
+    "optional": true
    }
   ]
  },
@@ -18629,6 +18884,16 @@
    }
   ]
  },
+ "GetMarketplaceFunctionRunsResponse": {
+  "base": "ResponseBase",
+  "fields": [
+   {
+    "name": "runs",
+    "type": "MarketplaceFunctionRunDto[] = []",
+    "optional": false
+   }
+  ]
+ },
  "InvokeMarketplaceFunctionResponse": {
   "base": "ResponseBase",
   "fields": [
@@ -18662,11 +18927,6 @@
  "GetCodeIntegrationsResponse": {
   "base": "ResponseBase",
   "fields": [
-   {
-    "name": "defaultIntegrationId",
-    "type": "string",
-    "optional": true
-   },
    {
     "name": "list",
     "type": "PaginatedResponse<CodeIntegrationListProjection>",
@@ -20293,16 +20553,6 @@
    }
   ]
  },
- "SetCodeIntegrationAsDefault": {
-  "base": "CodeMashRequestBase",
-  "fields": [
-   {
-    "name": "id",
-    "type": "string",
-    "optional": false
-   }
-  ]
- },
  "DeleteCodeIntegrationRequest": {
   "base": "CodeMashRequestBase",
   "fields": [
@@ -21620,11 +21870,6 @@
     "type": "ConfirmCodeIntegrationHumanDeliveryRequest",
     "optional": true
    },
-   {
-    "name": "typegen_208_SetCodeIntegrationAsDefault",
-    "type": "SetCodeIntegrationAsDefault",
-    "optional": true
-   },
    {
     "name": "typegen_209_DeleteCodeIntegrationRequest",
     "type": "DeleteCodeIntegrationRequest",
@@ -21959,6 +22204,11 @@
     "name": "typegen_283_CodeFunctionSchedulerTaskRequest",
     "type": "CodeFunctionSchedulerTaskRequest",
     "optional": true
+   },
+   {
+    "name": "typegen_284_MarketplaceFunctionSchedulerTaskRequest",
+    "type": "MarketplaceFunctionSchedulerTaskRequest",
+    "optional": true
    }
   ]
  },
@@ -23212,6 +23462,16 @@
   "base": "RequestBase",
   "fields": []
  },
+ "GetLicenseKey": {
+  "base": "RequestBase",
+  "fields": [
+   {
+    "name": "id",
+    "type": "string",
+    "optional": true
+   }
+  ]
+ },
  "CreateAiServiceUserRequest": {
   "base": "RequestBase",
   "fields": [
@@ -26412,7 +26672,7 @@
    },
    {
     "name": "tokenMappings",
-    "type": "MarketplaceTokenMappingDto[] = []",
+    "type": "TokenMappingDto[] = []",
     "optional": false
    }
   ]
@@ -26427,6 +26687,26 @@
    }
   ]
  },
+ "GetMarketplaceFunctionRuns": {
+  "base": "CodeMashRequestBase",
+  "fields": [
+   {
+    "name": "triggerId",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "taskId",
+    "type": "string",
+    "optional": true
+   },
+   {
+    "name": "limit",
+    "type": "number",
+    "optional": true
+   }
+  ]
+ },
  "GetCodeFunctions": {
   "base": "CodeMashListPaginationRequestBase",
   "fields": [
@@ -29539,7 +29819,19 @@
    "Template",
    "EmailFooters",
    "Old",
-   "New"
+   "New",
+   "RequestInput",
+   "IntegrationConfig",
+   "IntegrationSecret"
+  ]
+ },
+ "SecretValueFormat": {
+  "enum": true,
+  "values": [
+   "Raw",
+   "Bearer",
+   "Basic",
+   "Prefixed"
   ]
  },
  "CollectionEmailCampaignRecipientField": {
@@ -29898,7 +30190,8 @@
    "PushCampaign",
    "SmsCampaign",
    "CodeFunctionalCall",
-   "WebhookCall"
+   "WebhookCall",
+   "MarketplaceFunctionCall"
   ]
  },
  "MarketplaceTransport": {
@@ -29931,25 +30224,12 @@
    "Calendar"
   ]
  },
- "MarketplaceTokenResolverKind": {
-  "enum": true,
-  "values": [
-   "Static",
-   "Request",
-   "Project",
-   "Initiator",
-   "Custom",
-   "IntegrationConfig",
-   "IntegrationSecret"
-  ]
- },
- "MarketplaceSecretValueFormat": {
+ "MarketplaceAvailability": {
   "enum": true,
   "values": [
-   "Raw",
-   "Bearer",
-   "Basic",
-   "Prefixed"
+   "Development",
+   "Staging",
+   "Production"
   ]
  },
  "MarketplaceFieldType": {
@@ -29973,6 +30253,17 @@
    "Path"
   ]
  },
+ "MarketplaceFormKind": {
+  "enum": true,
+  "values": [
+   "Generic",
+   "DatabaseQuery",
+   "DatabaseWrite",
+   "Message",
+   "Prompt",
+   "Web"
+  ]
+ },
  "CodeFunctionSource": {
   "enum": true,
   "values": [

package/dist/manifest/endpoints.json

@@ -1730,19 +1730,6 @@
   "pathParams": [],
   "scope": "project"
  },
- {
-  "surface": "hub",
-  "group": "code",
-  "method": "setCodeIntegrationAsDefault",
-  "requestDto": "SetCodeIntegrationAsDefault",
-  "responseDto": "EmptyResponse",
-  "path": "/{version}/code/integrations/{Id}/default",
-  "verb": "PUT",
-  "pathParams": [
-   "Id"
-  ],
-  "scope": "project"
- },
  {
   "surface": "hub",
   "group": "code",
@@ -2068,6 +2055,17 @@
   ],
   "scope": "project"
  },
+ {
+  "surface": "hub",
+  "group": "code",
+  "method": "getMarketplaceFunctionRuns",
+  "requestDto": "GetMarketplaceFunctionRuns",
+  "responseDto": "GetMarketplaceFunctionRunsResponse",
+  "path": "/{version}/code/marketplace/functions/runs",
+  "verb": "GET",
+  "pathParams": [],
+  "scope": "project"
+ },
  {
   "surface": "hub",
   "group": "code",

package/dist/server.js

@@ -73,9 +73,12 @@ export const curated = [
     { name: 'norbix_get_code_function_qualifiers', surface: 'hub', group: 'code', method: 'getCodeFunctionQualifiers', description: 'List the aliases and versions of one cloud function (functionId from norbix_get_code_functions).' },
     { name: 'norbix_invoke_code_function', surface: 'hub', group: 'code', method: 'invokeCodeFunction', description: 'Call a cloud function by hand with a manual.invoke envelope: functionRef { integrationId, functionId, qualifier? }, payload (JSON object → data.payload), invocationType Sync (wait for the result) or Async, runAsUserId (the service user the function acts as; omitted = you). Sync answers with statusCode, durationMs, output, requestId, logs.' },
     { name: 'norbix_get_code_function_event_sample', surface: 'hub', group: 'code', method: 'getCodeFunctionEventSample', description: 'A sample event envelope with example data for a source (Database | Membership | Files | Payments | Ai | Scheduler | Manual), an event name and, for Database, a schemaId — the fixture for a local run of a function.' },
-    { name: 'norbix_get_code_function_runs', surface: 'hub', group: 'code', method: 'getCodeFunctionRuns', description: 'The last cloud-function runs of a trigger (triggerId) or a scheduler task (taskId), newest first: firedAt, event, succeeded, statusCode, durationMs, error, requestId. limit 1-50, default 20.' },
+    { name: 'norbix_get_code_function_runs', surface: 'hub', group: 'code', method: 'getCodeFunctionRuns', description: 'The last cloud-function runs of a trigger (triggerId) or a scheduler task (taskId), newest first: firedAt, event, succeeded, statusCode, durationMs, error, requestId; a run through the Fake provider also input — the envelope the function received as JSON text, context.runAs.accessToken masked, cut at 64 KB. limit 1-50, default 20.' },
     { 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_save_marketplace_integration', surface: 'hub', group: 'code', method: 'saveMarketplaceIntegration', description: 'Enable a marketplace listing as a connection: integration { listingViewId (ml_…), integrationName, isEnabled, config { key: value } } and secrets { key: value }. Leave integration.viewId empty for a new connection — the answer\'s id is the minted int_…; set it to save an existing one again (empty secrets keep the stored ones). getMarketplaceListing shows the listing\'s config and secret fields.' },
+    { name: 'norbix_test_marketplace_integration', surface: 'hub', group: 'code', method: 'testMarketplaceIntegration', description: 'Validate a marketplace connection (integrationViewId): runs the listing\'s steps in order; steps[] has key, label, requiredForFunctions, succeeded, skipped, message. Functions can be added only when every requiredForFunctions step succeeded (else saveMarketplaceFunction fails with CM-ERRORS-MARKETPLACE-013).' },
+    { name: 'norbix_invoke_marketplace_function', surface: 'hub', group: 'code', method: 'invokeMarketplaceFunction', description: 'Call a marketplace function by hand as the caller: functionViewId (func_…) and payload (JSON object; each declared input is read from it as @Model.Request.<name>, a missing required input is refused). Answers isSuccess, output, vendorRequestId.' },
+    { name: 'norbix_get_marketplace_function_runs', surface: 'hub', group: 'code', method: 'getMarketplaceFunctionRuns', description: 'The last marketplace-function runs of a trigger (triggerId) or a scheduler task (taskId), newest first: firedAt, event, source, functionId, runAsUserId, succeeded, durationMs, error, vendorRequestId; a run through the Fake vendor also input — what the vendor received, secrets masked. limit 1-50, default 20.' },
     { name: 'norbix_get_database_schemas', surface: 'hub', group: 'database', method: 'getDatabaseSchemas', description: 'List database collection schemas of the project.' },
     { 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.' },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norbix.ai/mcp",
-  "version": "0.6.0",
+  "version": "0.8.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.19.0",
+    "@norbix.ai/ts": "^4.21.0",
     "express": "^4.21.2",
     "zod": "^3.24.0"
   },