@chaprola/mcp-server 1.6.0 → 1.6.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chaprola/mcp-server",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "MCP server for Chaprola — agent-first data platform. Gives AI agents 46 tools for structured data storage, record CRUD, querying, schema inspection, web search, URL fetching, scheduled jobs, and execution via plain HTTP.",
   "type": "module",
   "main": "dist/index.js",

package/references/cookbook.md

@@ -167,18 +167,17 @@ PRINT 0
 
 ## GROUP BY with Pivot (via /query)
 
-Chaprola's pivot IS GROUP BY. Set `row` = grouping field, `values` = aggregate functions.
+Chaprola's pivot IS GROUP BY. Schema: `{row, column, value, aggregate}`.
 
 ```bash
-# SQL: SELECT department, COUNT(*), AVG(salary) FROM staff GROUP BY department
+# SQL: SELECT department, AVG(salary) FROM staff GROUP BY department
 POST /query {
   userid, project, file: "STAFF",
   pivot: {
     row: "department",
-    values: [
-      {field: "department", function: "count"},
-      {field: "salary", function: "avg"}
-    ]
+    column: "",
+    value: "salary",
+    aggregate: "avg"
   }
 }
 
@@ -188,26 +187,17 @@ POST /query {
   pivot: {
     row: "department",
     column: "year",
-    values: [{field: "revenue", function: "sum"}],
-    totals: true
-  }
-}
-```
-
-For simple aggregation without a cross-tabulation column, set `column` to empty string:
-```bash
-# Count records per department (no cross-tab)
-POST /query {
-  userid, project, file: "STAFF",
-  pivot: {
-    row: "department",
-    column: "",
-    values: [{field: "department", function: "count"}]
+    value: "revenue",
+    aggregate: "sum"
   }
 }
 ```
 
-Supported aggregate functions: `count`, `sum`, `avg`, `min`, `max`, `stddev`.
+- `row` — grouping field
+- `column` — cross-tab field (use `""` for simple aggregation)
+- `value` — field to aggregate (string or array of strings)
+- `aggregate` — function: `count`, `sum`, `avg`, `min`, `max`, `stddev`
+- Row and column totals included automatically in response
 
 ## PUT Format Codes
 

package/references/ref-pivot.md

@@ -2,31 +2,45 @@
 
 Chaprola's pivot IS GROUP BY. Add `pivot` to `/query`.
 
-## Simple aggregation (no cross-tab)
+## Schema
+```json
+"pivot": {
+  "row": "grouping_field",
+  "column": "cross_tab_field",
+  "value": "measure_field",
+  "aggregate": "sum"
+}
+```
+- `row` — grouping field (like SQL GROUP BY)
+- `column` — cross-tabulation field (use `""` for simple aggregation)
+- `value` — field to aggregate (string, or array of strings for multiple measures)
+- `aggregate` — function name: `count`, `sum`, `avg`, `min`, `max`, `stddev`
+
+## Simple aggregation
 ```json
 POST /query {
   "userid": "...", "project": "...", "file": "STAFF",
   "pivot": {
     "row": "department",
     "column": "",
-    "values": [
-      {"field": "department", "function": "count"},
-      {"field": "salary", "function": "avg"}
-    ]
+    "value": "salary",
+    "aggregate": "avg"
   }
 }
 ```
-SQL equivalent: `SELECT department, COUNT(*), AVG(salary) FROM staff GROUP BY department`
+SQL equivalent: `SELECT department, AVG(salary) FROM staff GROUP BY department`
+
+For COUNT: `"value": "department", "aggregate": "count"`
 
 ## Cross-tabulation
 ```json
 "pivot": {
   "row": "department",
   "column": "year",
-  "values": [{"field": "revenue", "function": "sum"}],
-  "totals": true
+  "value": "revenue",
+  "aggregate": "sum"
 }
 ```
 SQL equivalent: `SELECT department, year, SUM(revenue) FROM sales GROUP BY department, year`
 
-Supported functions: `count`, `sum`, `avg`, `min`, `max`, `stddev`.
+Row and column totals are included automatically in the response.