@kadoa/mcp 0.5.4-rc.1 → 0.5.4-rc.2

package/dist/index.js

@@ -51217,12 +51217,12 @@ function registerTools(server, ctx) {
   const FETCH_DATA_DEFAULT_LIMIT = 50;
   const FETCH_DATA_MAX_LIMIT = 500;
   server.registerTool("fetch_data", {
-    description: "Get a page of extracted data from a workflow. Use for previews, sorted/filtered slices, or 'first N rows' queries. For full datasets (especially >500 rows or anything destined for Excel/pandas), use export_data instead. Data is only available after the workflow run has completed (status is no longer 'Running' or 'Validating'). Do NOT poll or sleep-wait for completion.",
+    description: "Get a PAGE of extracted data from a workflow. Use ONLY for previews, sorted/filtered slices, or explicit 'first N rows' / 'top N' queries (capped at 500 rows per call). Do NOT use this to retrieve a full dataset, 'all rows', or anything the user wants to analyze in Excel / pandas / duckdb — use export_data for those. Data is only available after the workflow run has completed (status is no longer 'Running' or 'Validating'). Do NOT poll or sleep-wait for completion.",
     inputSchema: {
       workflowId: exports_external.string().describe("The workflow ID"),
       limit: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe(`Maximum number of records to return. Default ${FETCH_DATA_DEFAULT_LIMIT}, max ${FETCH_DATA_MAX_LIMIT}.`),
       page: exports_external.preprocess(coerceNumber(), exports_external.number()).optional().describe("Page number for pagination (1-based)"),
-      filters: exports_external.string().optional().describe("JSON-encoded filter array, same shape accepted by the /data endpoint"),
+      filters: exports_external.string().optional().describe('JSON-encoded filter array. Each filter has shape {"field":"<fieldName>","operator":"<OP>","value":"<v>"}. Operators are UPPERCASE: CONTAINS, EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN_OR_EQUAL. Example: [{"field":"title","operator":"CONTAINS","value":"Manager"}].'),
       sortBy: exports_external.string().optional().describe("Field name to sort by"),
       order: exports_external.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc")
     },
@@ -51252,12 +51252,12 @@ function registerTools(server, ctx) {
     return jsonResult(result);
   }));
   server.registerTool("export_data", {
-    description: "Materialize a workflow's full dataset to object storage and return a signed download URL. Use this for full datasets, large workflows (>500 rows), or anything destined for Excel / pandas / duckdb. The URL is self-authenticating: open with `fetch(url)` — no Authorization header needed.",
+    description: "PREFERRED tool for retrieving a workflow's FULL dataset. Materializes the data to object storage and returns a signed download URL. Use this whenever the user wants 'all rows', 'the full dataset', 'everything', an export, or anything destined for Excel / pandas / duckdb / a CSV file — even for small workflows. The URL is self-authenticating (open with `fetch(url)`, no Authorization header). Use fetch_data ONLY when the user explicitly asks for a small preview slice (e.g., 'first 10', 'top N sorted by X').",
     inputSchema: {
       workflowId: exports_external.string().describe("The workflow ID"),
       format: exports_external.enum(["csv", "json"]).optional().describe("Export format. Default 'csv'."),
       runId: exports_external.string().optional().describe("Specific run ID to export. Defaults to the latest completed run."),
-      filters: exports_external.string().optional().describe("JSON-encoded filter array, same shape as /data"),
+      filters: exports_external.string().optional().describe('JSON-encoded filter array. Each filter has shape {"field":"<fieldName>","operator":"<OP>","value":"<v>"}. Operators are UPPERCASE: CONTAINS, EQUALS, NOT_EQUALS, GREATER_THAN, LESS_THAN, GREATER_THAN_OR_EQUAL, LESS_THAN_OR_EQUAL.'),
       sortBy: exports_external.string().optional().describe("Field name to sort by"),
       order: exports_external.enum(["asc", "desc"]).optional().describe("Sort order: asc or desc"),
       rowIds: exports_external.string().optional().describe("Comma-separated list (or JSON array) of row ids to include")
@@ -52002,7 +52002,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@kadoa/mcp",
-    version: "0.5.4-rc.1",
+    version: "0.5.4-rc.2",
     description: "Kadoa MCP Server — manage workflows from Claude Desktop, Cursor, and other MCP clients",
     type: "module",
     main: "dist/index.js",

package/package.json

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