@kadoa/mcp 0.5.13 → 0.5.15

package/README.md

@@ -24,16 +24,17 @@ claude mcp add kadoa --transport http https://mcp.kadoa.com/mcp
 2. Enter the URL: `https://mcp.kadoa.com/mcp`
 3. Sign in with your Kadoa account via OAuth
 
-### Claude organization shared workspace
+### Claude service connector
 
-A Kadoa workspace admin can generate organization connector credentials under **Workspace settings → Claude connector**. The generated OAuth client is fixed to that workspace's service account.
+A Kadoa workspace admin can generate service connector credentials under **Workspace settings → MCP connector**. The generated OAuth client is fixed to that workspace's service account.
 
 1. In Kadoa, select **Generate credentials** and copy the MCP URL, OAuth Client ID, and OAuth Client Secret. The secret is shown once.
 2. In Claude organization **Admin settings → Connectors**, select **Add custom connector**.
-3. Enter `https://mcp.kadoa.com/mcp` and paste the generated OAuth Client ID/Secret under Advanced settings.
-4. Organization members find the custom connector under **Settings → Connectors** and select **Connect**.
+3. Enter `https://service.mcp.kadoa.com/mcp` and paste the generated OAuth Client ID/Secret under Advanced settings.
+4. In the connector's tool settings, allow only the tools that organization members should use.
+5. Organization members find the custom connector under **Settings → Connectors** and select **Connect**.
 
-Members do not need Kadoa accounts. All actions are attributed to the shared Kadoa service account, and team switching is unavailable. To rotate access, rotate the secret in Kadoa, replace it in Claude, and reconnect. Revoking the connector stops access immediately.
+The service connector uses a separate hostname from the personal connector at `https://mcp.kadoa.com/mcp`, so Claude users can configure both. Members do not need Kadoa accounts. All actions are attributed to the shared Kadoa service account, and team switching is unavailable. To rotate access, rotate the secret in Kadoa, replace it in Claude, and reconnect. Revoking the connector stops access immediately.
 
 Do not paste a Kadoa workspace API key into Claude.
 
@@ -65,6 +66,7 @@ Point your client to `https://mcp.kadoa.com/mcp` with OAuth authentication.
 | `list_workflows` | List all workflows with status |
 | `get_workflow` | Get detailed workflow information |
 | `get_workflow_history` | Get the workflow's configuration revision history (audit log) — who changed it, when, from which channel, and a `changedFields` summary per revision |
+| `list_workflow_runs` | List a workflow's execution run history (status, start/finish, record count, errors); filter by outcome and paginate |
 | `run_workflow` | Execute a workflow |
 | `fetch_data` | Get extracted data from a workflow |
 | `delete_workflow` | Delete a workflow |

package/dist/index.js

@@ -48467,7 +48467,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
         options: localVarRequestOptions
       };
     },
-    v4WorkflowsWorkflowIdHistoryGet: async (workflowId, options = {}) => {
+    v4WorkflowsWorkflowIdHistoryGet: async (workflowId, page, limit, status, options = {}) => {
       assertParamExists("v4WorkflowsWorkflowIdHistoryGet", "workflowId", workflowId);
       const localVarPath = `/v4/workflows/{workflowId}/history`.replace(`{${"workflowId"}}`, encodeURIComponent(String(workflowId)));
       const localVarUrlObj = new URL$1(localVarPath, DUMMY_BASE_URL);
@@ -48479,6 +48479,15 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       const localVarHeaderParameter = {};
       const localVarQueryParameter = {};
       await setApiKeyToObject(localVarHeaderParameter, "x-api-key", configuration);
+      if (page !== undefined) {
+        localVarQueryParameter["page"] = page;
+      }
+      if (limit !== undefined) {
+        localVarQueryParameter["limit"] = limit;
+      }
+      if (status !== undefined) {
+        localVarQueryParameter["status"] = status;
+      }
       localVarHeaderParameter["Accept"] = "application/json";
       setSearchParams(localVarUrlObj, localVarQueryParameter);
       let headersFromBaseOptions = baseOptions && baseOptions.headers ? baseOptions.headers : {};
@@ -48842,8 +48851,8 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
       const localVarOperationServerBasePath = operationServerMap["WorkflowsApi.v4WorkflowsWorkflowIdGet"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
     },
-    async v4WorkflowsWorkflowIdHistoryGet(workflowId, options) {
-      const localVarAxiosArgs = await localVarAxiosParamCreator.v4WorkflowsWorkflowIdHistoryGet(workflowId, options);
+    async v4WorkflowsWorkflowIdHistoryGet(workflowId, page, limit, status, options) {
+      const localVarAxiosArgs = await localVarAxiosParamCreator.v4WorkflowsWorkflowIdHistoryGet(workflowId, page, limit, status, options);
       const localVarOperationServerIndex = configuration?.serverIndex ?? 0;
       const localVarOperationServerBasePath = operationServerMap["WorkflowsApi.v4WorkflowsWorkflowIdHistoryGet"]?.[localVarOperationServerIndex]?.url;
       return (axios2, basePath) => createRequestFunction(localVarAxiosArgs, axios_default, BASE_PATH, configuration)(axios2, localVarOperationServerBasePath || basePath);
@@ -49308,7 +49317,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
   async executeExtraction(options) {
     this.validateOptions(options);
     const config2 = {
-      ...merge3(DEFAULT_OPTIONS, options)
+      ...merge3(merge3({}, DEFAULT_OPTIONS), options)
     };
     const isRealTime = config2.interval === "REAL_TIME";
     if (isRealTime) {
@@ -49591,7 +49600,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     assert2(startedJob.jobId, "Job ID is not set");
     debug4("Job started: %O", startedJob);
     this._jobId = startedJob.jobId;
-    const finishedJob = await this.workflowsCoreService.waitForJobCompletion(this._workflowId, startedJob.jobId);
+    const finishedJob = await this.workflowsCoreService.waitForJobCompletion(this._workflowId, startedJob.jobId, { timeoutMs: 30 * 60 * 1000 });
     debug4("Job finished: %O", finishedJob);
     return this;
   }
@@ -50019,7 +50028,7 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     }));
     return channels;
   }
-}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.35.0", SDK_NAME = "kadoa-node-sdk", SDK_LANGUAGE = "node", debug6, isDrainControlMessage = (message) => message.type === "control.draining", isRealtimeEvent = (message) => message.type !== "heartbeat" && message.type !== "control.draining", _Realtime = class _Realtime2 {
+}, PUBLIC_API_URI, WSS_API_URI, REALTIME_API_URI, SDK_VERSION = "0.36.0", SDK_NAME = "kadoa-node-sdk", SDK_LANGUAGE = "node", debug6, isDrainControlMessage = (message) => message.type === "control.draining", isRealtimeEvent = (message) => message.type !== "heartbeat" && message.type !== "control.draining", _Realtime = class _Realtime2 {
   constructor(config2) {
     this.drainingSockets = /* @__PURE__ */ new Set;
     this.lastHeartbeat = Date.now();
@@ -50941,6 +50950,15 @@ var import_debug, __require2, ChangeDifferenceType, KadoaErrorCode, _KadoaSdkExc
     });
     return response.data;
   }
+  async listWorkflowRuns(id, options) {
+    const response = await this.workflowsApi.v4WorkflowsWorkflowIdHistoryGet({
+      workflowId: id,
+      page: options?.page,
+      limit: options?.limit,
+      status: options?.status
+    });
+    return response.data;
+  }
   async delete(id) {
     await this.workflowsApi.v4WorkflowsWorkflowIdDelete({
       workflowId: id
@@ -51703,7 +51721,7 @@ var init_dist2 = __esm(() => {
       return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdGet(requestParameters.workflowId, options).then((request) => request(this.axios, this.basePath));
     }
     v4WorkflowsWorkflowIdHistoryGet(requestParameters, options) {
-      return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdHistoryGet(requestParameters.workflowId, options).then((request) => request(this.axios, this.basePath));
+      return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdHistoryGet(requestParameters.workflowId, requestParameters.page, requestParameters.limit, requestParameters.status, options).then((request) => request(this.axios, this.basePath));
     }
     v4WorkflowsWorkflowIdJobsJobIdGet(requestParameters, options) {
       return WorkflowsApiFp(this.configuration).v4WorkflowsWorkflowIdJobsJobIdGet(requestParameters.workflowId, requestParameters.jobId, options).then((request) => request(this.axios, this.basePath));
@@ -51799,7 +51817,7 @@ This is the main page content.`
   DEFAULT_OPTIONS = {
     mode: "run",
     pollingInterval: 5000,
-    maxWaitTime: 300000,
+    maxWaitTime: 30 * 60 * 1000,
     location: { type: "auto" },
     bypassPreview: true,
     autoStart: true
@@ -52141,6 +52159,21 @@ function deriveStatusLabel(workflow) {
       return ds ?? "Unknown";
   }
 }
+function mapRunStatus(state) {
+  switch (state) {
+    case "FINISHED":
+      return "success";
+    case "IN_PROGRESS":
+    case "VALIDATING":
+      return "in_progress";
+    case "FAILED":
+    case "FAILED_INSUFFICIENT_FUNDS":
+    case "NOT_SUPPORTED":
+      return "failed";
+    default:
+      return "failed";
+  }
+}
 function workflowDashboardUrl(workflowId) {
   return `${DASHBOARD_BASE_URL}/workflow/${workflowId}`;
 }
@@ -52735,6 +52768,35 @@ function registerTools(server, ctx, capabilities) {
       entries
     });
   }));
+  server.registerTool("list_workflow_runs", {
+    description: "List a workflow's execution run history — each run's status, start/finish time, " + "record count, and errors. Use to answer 'when did this last succeed?' " + "(status='success', limit=1) or 'recent success/failure pattern?'. Distinct from " + "get_workflow_history, which is the config audit log.",
+    inputSchema: {
+      workflowId: exports_external.string().describe("The workflow ID"),
+      status: exports_external.enum(["success", "failed", "in_progress"]).optional().describe("Filter runs by outcome"),
+      page: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Page number, 1-based (default: 1)"),
+      limit: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Runs per page (default: 25)")
+    },
+    annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true }
+  }, withErrorHandling("list_workflow_runs", async (args) => {
+    const response = await ctx.client.workflow.listWorkflowRuns(args.workflowId, {
+      page: args.page,
+      limit: args.limit,
+      status: args.status
+    });
+    return jsonResult({
+      workflowId: response.workflowId,
+      runs: (response.workflowRuns ?? []).map((r) => ({
+        id: r.id,
+        status: mapRunStatus(r.state),
+        startedAt: r.startedAt,
+        finishedAt: r.finishedAt,
+        records: r.records,
+        errors: r.errors
+      })),
+      totalCount: response.totalCount,
+      pagination: response.pagination
+    });
+  }));
   server.registerTool("run_workflow", {
     description: "Run a workflow to extract fresh data. The run is asynchronous and may take several minutes. Do NOT poll or sleep-wait for completion. Return the workflow ID to the user and let them check status with get_workflow or fetch results later with fetch_data.",
     inputSchema: {
@@ -53662,7 +53724,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.13",
+    version: "0.5.15",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",
@@ -53686,7 +53748,7 @@ var init_package = __esm(() => {
       prepublishOnly: "bun run check-types && bun run test:unit && bun run build"
     },
     dependencies: {
-      "@kadoa/node-sdk": "^0.35.0",
+      "@kadoa/node-sdk": "^0.36.0",
       "@modelcontextprotocol/sdk": "^1.26.0",
       express: "^5.2.1",
       "express-rate-limit": "^8.2.1",
@@ -57695,6 +57757,15 @@ var init_bearerAuth = __esm(() => {
   init_errors4();
 });
 
+// src/managed-connector-client.ts
+function isManagedConnectorClientId(clientId) {
+  return MANAGED_CONNECTOR_CLIENT_ID_PREFIXES.some((prefix) => clientId.startsWith(prefix));
+}
+var MANAGED_CONNECTOR_CLIENT_ID_PREFIXES;
+var init_managed_connector_client = __esm(() => {
+  MANAGED_CONNECTOR_CLIENT_ID_PREFIXES = ["kadoa_mcp_", "kadoa_claude_"];
+});
+
 // src/managed-connector-registry.ts
 class ManagedConnectorRegistry {
   baseUrl;
@@ -57894,7 +57965,7 @@ class KadoaOAuthProvider {
     const thisProvider = this;
     return {
       async getClient(clientId) {
-        if (clientId.startsWith("kadoa_claude_")) {
+        if (isManagedConnectorClientId(clientId)) {
           const connector = await thisProvider.getManagedRegistry().get(clientId);
           if (!connector)
             return;
@@ -58834,6 +58905,7 @@ function escapeHtml(str) {
 var TEAM_SELECTION_TTL, ACCESS_TOKEN_TTL;
 var init_auth2 = __esm(() => {
   init_errors4();
+  init_managed_connector_client();
   init_managed_connector_registry();
   TEAM_SELECTION_TTL = 10 * 60 * 1000;
   ACCESS_TOKEN_TTL = 7 * 24 * 3600;
@@ -58954,7 +59026,7 @@ function managedTokenHandler(options) {
   return async (req, res, next) => {
     const body = req.body ?? {};
     const clientId = typeof body.client_id === "string" ? body.client_id : "";
-    if (!clientId.startsWith("kadoa_claude_")) {
+    if (!isManagedConnectorClientId(clientId)) {
       next();
       return;
     }
@@ -59001,6 +59073,7 @@ function managedTokenHandler(options) {
 }
 var init_managed_token_handler = __esm(() => {
   init_errors4();
+  init_managed_connector_client();
   init_managed_connector_registry();
 });
 
@@ -59064,7 +59137,7 @@ async function startHttpServer(options) {
     limit: 50,
     standardHeaders: true,
     legacyHeaders: false,
-    skip: (req) => !String(req.body?.client_id ?? "").startsWith("kadoa_claude_"),
+    skip: (req) => !isManagedConnectorClientId(String(req.body?.client_id ?? "")),
     message: {
       error: "too_many_requests",
       error_description: "Too many managed connector token requests"
@@ -59229,6 +59302,7 @@ var init_http2 = __esm(async () => {
   init_auth2();
   init_redis_store();
   init_client2();
+  init_managed_connector_client();
   init_managed_connector_registry();
   init_managed_token_handler();
   await init_src();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadoa/mcp",
-  "version": "0.5.13",
+  "version": "0.5.15",
   "description": "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
   "type": "module",
   "main": "dist/index.js",
@@ -24,7 +24,7 @@
     "prepublishOnly": "bun run check-types && bun run test:unit && bun run build"
   },
   "dependencies": {
-    "@kadoa/node-sdk": "^0.35.0",
+    "@kadoa/node-sdk": "^0.36.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "express": "^5.2.1",
     "express-rate-limit": "^8.2.1",