@kadoa/mcp 0.3.1-rc.0 → 0.3.2

package/README.md

@@ -6,6 +6,12 @@ Use [Kadoa](https://kadoa.com) from ChatGPT, Claude.ai, Claude Code, Cursor, and
 
 A hosted MCP server is available at `https://mcp.kadoa.com/mcp`. Connect from any MCP client — no local install, no API key config. You sign in with your Kadoa account via OAuth.
 
+### Claude Code
+
+```bash
+claude mcp add kadoa --transport http https://mcp.kadoa.com/mcp
+```
+
 ### ChatGPT
 
 1. Go to **Settings → Connectors → Add MCP server**
@@ -144,6 +150,7 @@ Get your API key from [kadoa.com/settings](https://kadoa.com/settings).
 | `delete_workflow` | Delete a workflow |
 | `approve_workflow` | Approve and activate a workflow |
 | `update_workflow` | Update workflow configuration and schema |
+| `whoami` | Show current user details, auth method, and team memberships |
 | `team_list` | List all teams you belong to and see which is active |
 | `team_switch` | Switch the active team by name or ID |
 

package/dist/index.js

@@ -49273,26 +49273,87 @@ function registerTools(server, ctx) {
         "FOUR_WEEKS",
         "MONTHLY",
         "REAL_TIME"
-      ]).optional().describe("How often the workflow runs. Defaults to ONLY_ONCE. Use REAL_TIME for continuous monitoring.")
+      ]).optional().describe("How often the workflow runs. Defaults to ONLY_ONCE. Use REAL_TIME for continuous monitoring."),
+      notifications: exports_external.object({
+        email: exports_external.boolean().optional().describe("Send email notifications to the account email when data changes"),
+        webhook: exports_external.object({
+          url: exports_external.string().url().describe("Webhook endpoint URL"),
+          httpMethod: exports_external.enum(["POST", "GET", "PUT", "PATCH"]).optional().describe("HTTP method (defaults to POST)")
+        }).optional().describe("Send notifications via HTTP webhook"),
+        slack: exports_external.object({
+          webhookUrl: exports_external.string().url().describe("Slack incoming webhook URL")
+        }).optional().describe("Send notifications to a Slack channel"),
+        websocket: exports_external.boolean().optional().describe("Enable WebSocket notifications for programmatic real-time consumption")
+      }).optional().describe("Notification channels to alert when data changes. At least one channel is required for REAL_TIME workflows.")
     },
     annotations: { readOnlyHint: false, destructiveHint: false, idempotentHint: false }
   }, withErrorHandling("create_workflow", async (args) => {
-    const extraction = args.schema ? (builder) => {
-      const entity = builder.entity(args.entity || "Data");
+    const n = args.notifications;
+    const hasNotifications = n && (n.email || n.webhook || n.slack || n.websocket);
+    if (args.interval === "REAL_TIME" && !hasNotifications) {
+      return errorResult("Real-time workflows require at least one notification channel so you get alerted when data changes. " + "Add a notifications object with one or more channels: email, webhook, slack, or websocket.");
+    }
+    const extraction = args.schema ? (builder2) => {
+      const entity = builder2.entity(args.entity || "Data");
       for (const field of args.schema) {
         entity.field(field.name, field.description || field.name, field.dataType || "STRING", { example: field.example });
       }
       return entity;
     } : undefined;
-    const workflow = await ctx.client.extract({
+    let builder = ctx.client.extract({
       urls: args.urls,
       name: args.name || "Untitled Workflow",
       navigationMode: "agentic-navigation",
       userPrompt: args.prompt,
       extraction,
       interval: args.interval
-    }).create();
-    const message = args.interval === "REAL_TIME" ? "Workflow created successfully. This real-time workflow monitors continuously — no manual runs needed. Use fetch_data to retrieve the latest extracted results." : "Workflow created successfully. The AI agent will start extracting data automatically.";
+    });
+    if (hasNotifications) {
+      const channels = {};
+      if (n.email)
+        channels.EMAIL = true;
+      if (n.websocket)
+        channels.WEBSOCKET = true;
+      if (n.webhook) {
+        channels.WEBHOOK = {
+          name: "mcp-webhook",
+          webhookUrl: n.webhook.url,
+          httpMethod: n.webhook.httpMethod || "POST"
+        };
+      }
+      if (n.slack) {
+        channels.SLACK = {
+          name: "mcp-slack",
+          webhookUrl: n.slack.webhookUrl
+        };
+      }
+      builder = builder.withNotifications({
+        events: ["workflow_data_change"],
+        channels
+      });
+    }
+    const workflow = await builder.create();
+    const enabledChannels = [];
+    if (n?.email) {
+      const user = await ctx.client.user.getCurrentUser();
+      enabledChannels.push(`email (${user.email})`);
+    }
+    if (n?.slack)
+      enabledChannels.push(`slack (${n.slack.webhookUrl})`);
+    if (n?.webhook)
+      enabledChannels.push(`webhook (${n.webhook.url})`);
+    if (n?.websocket)
+      enabledChannels.push("websocket");
+    let message = "Workflow created successfully.";
+    if (args.interval === "REAL_TIME") {
+      message += " This real-time workflow monitors continuously — no manual runs needed.";
+    } else {
+      message += " The AI agent will start extracting data automatically.";
+    }
+    if (enabledChannels.length > 0) {
+      message += ` Notifications on data changes via: ${enabledChannels.join(", ")}.`;
+    }
+    message += " Use fetch_data to retrieve the latest extracted results.";
     return jsonResult({
       success: true,
       workflowId: workflow.workflowId,
@@ -53959,7 +54020,7 @@ function renderTeamSelectionPage(teams, selectionToken) {
 function escapeHtml(str) {
   return str.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
-var clients, pendingAuths, pendingTeamSelections, authCodes, accessTokens, refreshTokens, TEAM_SELECTION_TTL, ACCESS_TOKEN_TTL = 3600, kadoaClientsStore;
+var clients, pendingAuths, pendingTeamSelections, authCodes, accessTokens, refreshTokens, TEAM_SELECTION_TTL, ACCESS_TOKEN_TTL, kadoaClientsStore;
 var init_auth2 = __esm(() => {
   clients = new Map;
   pendingAuths = new Map;
@@ -53968,6 +54029,7 @@ var init_auth2 = __esm(() => {
   accessTokens = new Map;
   refreshTokens = new Map;
   TEAM_SELECTION_TTL = 10 * 60 * 1000;
+  ACCESS_TOKEN_TTL = 7 * 24 * 3600;
   kadoaClientsStore = {
     getClient(clientId) {
       return clients.get(clientId);
@@ -54184,7 +54246,7 @@ function createServer(auth) {
       client: createKadoaClient(auth)
     };
   }
-  const server = new McpServer({ name: "kadoa", version: "0.2.0" });
+  const server = new McpServer({ name: "kadoa", version: "0.3.2" });
   registerTools(server, ctx);
   server.server.onerror = (error48) => console.error("[MCP Error]", error48);
   return server;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadoa/mcp",
-  "version": "0.3.1-rc.0",
+  "version": "0.3.2",
   "description": "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
   "type": "module",
   "main": "dist/index.js",