@kadoa/mcp 0.4.0 → 0.4.1-rc.2

package/dist/index.js

@@ -50355,7 +50355,9 @@ function registerTools(server, ctx) {
     return channels;
   }
   server.registerTool("create_workflow", {
-    description: "Create a data extraction workflow using agentic navigation. Supports one-time or scheduled runs. " + "If entity and schema are provided, they guide the extraction; otherwise the AI agent auto-detects the schema from the page. " + "The workflow runs asynchronously and may take several minutes. Do NOT poll or sleep-wait for completion. " + `Return the workflow ID to the user and let them check back later with get_workflow or fetch_data.
+    description: "IMPORTANT: One workflow = one source. A single workflow can extract many different fields, tables, and sections from the same URL(s) using a rich schema. " + `Do NOT create separate workflows for different data points on the same page — instead, define one workflow with a multi-field schema covering everything needed.
+
+` + "Create a data extraction workflow using agentic navigation. Supports one-time or scheduled runs. " + "If entity and schema are provided, they guide the extraction; otherwise the AI agent auto-detects the schema from the page. " + "The workflow runs asynchronously and may take several minutes. Do NOT poll or sleep-wait for completion. " + `Return the workflow ID to the user and let them check back later with get_workflow or fetch_data.
 
 ` + "NOTE: This tool is for one-time or scheduled extraction ONLY. " + "For continuous real-time monitoring (watching a page for changes and alerting), use the create_realtime_monitor tool instead.",
     inputSchema: strictSchema({
@@ -51334,6 +51336,58 @@ var init_tools = __esm(() => {
   };
 });
 
+// package.json
+var package_default;
+var init_package = __esm(() => {
+  package_default = {
+    name: "@kadoa/mcp",
+    version: "0.4.1-rc.2",
+    description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
+    type: "module",
+    main: "dist/index.js",
+    publishConfig: {
+      access: "public"
+    },
+    files: [
+      "dist",
+      "README.md"
+    ],
+    scripts: {
+      lint: "bunx biome check",
+      "lint:fix": "bunx biome check --write",
+      dev: "bun src/index.ts",
+      build: "bun build src/index.ts --outdir=dist --target=node --external express --external ioredis",
+      "check-types": "tsc --noEmit",
+      test: "BUN_TEST=1 bun test",
+      "test:unit": "BUN_TEST=1 bun test tests/unit --timeout=120000",
+      "test:e2e": "BUN_TEST=1 bun test tests/e2e --timeout=600000",
+      "test:eval": "BUN_TEST=1 bun test tests/evals --timeout=300000",
+      prepublishOnly: "bun run check-types && bun run test:unit && bun run build"
+    },
+    dependencies: {
+      "@kadoa/node-sdk": "^0.26.0",
+      "@modelcontextprotocol/sdk": "^1.26.0",
+      express: "^5.2.1",
+      ioredis: "^5.6.1",
+      zod: "^4.3.6"
+    },
+    devDependencies: {
+      "@anthropic-ai/sdk": "^0.78.0",
+      "@types/node": "^25.0.3",
+      "bun-types": "^1.3.3",
+      typescript: "^5.9.3"
+    },
+    keywords: [
+      "kadoa",
+      "mcp",
+      "model-context-protocol",
+      "web-scraping",
+      "data-extraction"
+    ],
+    license: "MIT"
+  };
+});
+
 // node_modules/@modelcontextprotocol/sdk/dist/esm/server/middleware/hostHeaderValidation.js
 function hostHeaderValidation(allowedHostnames) {
   return (req, res, next) => {
@@ -56527,7 +56581,20 @@ function createServer(auth) {
     teamId: auth.teamId,
     persist: auth.persist
   };
-  const server = new McpServer({ name: "kadoa", version: "0.3.2" });
+  const server = new McpServer({ name: "kadoa", version: package_default.version }, {
+    instructions: [
+      "IMPORTANT: One workflow = one source. A single workflow can extract many different fields, tables, and sections from the same URL(s) using a rich schema.",
+      "Do NOT create multiple workflows for different data points on the same page \u2014 instead, define one workflow with a multi-field schema covering everything needed.",
+      "",
+      "Workflow lifecycle: create_workflow \u2192 get_workflow (check status) \u2192 fetch_data (get results). Workflows run asynchronously \u2014 never poll or sleep-wait.",
+      "",
+      "Use create_realtime_monitor only when the user wants continuous change detection with alerts. For one-time or scheduled extraction, use create_workflow.",
+      "",
+      "Schema tips: Use descriptive field names and examples. Group related data under one entity.",
+      "The AI agent uses the schema + prompt to understand what to extract \u2014 a detailed prompt with a comprehensive schema produces better results than multiple simple workflows."
+    ].join(`
+`)
+  });
   registerTools(server, ctx);
   server.server.onerror = (error48) => console.error("[MCP Error]", error48);
   return server;
@@ -56536,6 +56603,7 @@ var init_src = __esm(async () => {
   init_mcp();
   init_client();
   init_tools();
+  init_package();
   if (!process.env.VITEST && !process.env.BUN_TEST) {
     const { startHttpServer: startHttpServer2 } = await init_http2().then(() => exports_http);
     await startHttpServer2();

package/package.json

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