@chaprola/mcp-server 1.9.0 → 1.11.0

package/dist/index.js

@@ -582,23 +582,26 @@ server.tool("chaprola_download", "Get a presigned S3 URL to download any file yo
     return textResult(res);
 }));
 // --- Query ---
-server.tool("chaprola_query", "SQL-free data query with WHERE, SELECT, aggregation, ORDER BY, JOIN, pivot, and Mercury scoring", {
+server.tool("chaprola_query", "SQL-free data query with WHERE, SELECT, aggregation, ORDER BY, JOIN, pivot, DISTINCT, transforms, and Mercury scoring", {
     project: z.string().describe("Project name"),
     file: z.string().describe("Data file to query"),
-    where: z.string().optional().describe("JSON object of filter conditions, e.g. {\"field\": \"status\", \"op\": \"eq\", \"value\": \"active\"}. Ops: eq, ne, gt, ge, lt, le, between, contains, starts_with"),
+    where: z.string().optional().describe("JSON array of filter conditions, e.g. [{\"field\": \"status\", \"op\": \"eq\", \"value\": \"active\"}]. Ops: eq, ne, gt, ge, lt, le, between, contains, starts_with, in, not_in, date_within, date_before, date_after. For in/not_in, value is a JSON array. For date_within, value is relative like \"30d\", \"6h\", \"15m\"."),
     select: z.array(z.string()).optional().describe("Fields to include in output"),
     aggregate: z.string().optional().describe("JSON array of aggregation specs, e.g. [{\"field\": \"amount\", \"func\": \"sum\"}]. Funcs: count, sum, avg, min, max, stddev"),
-    order_by: z.string().optional().describe("JSON array of sort specs, e.g. [{\"field\": \"name\", \"dir\": \"asc\"}]"),
+    order_by: z.string().optional().describe("JSON sort spec — single object or array for multi-column sort, e.g. [{\"field\": \"dept\", \"dir\": \"asc\"}, {\"field\": \"salary\", \"dir\": \"desc\"}]"),
+    distinct: z.boolean().optional().describe("Return only unique rows based on selected fields. Cannot combine with aggregate or pivot."),
+    transform: z.string().optional().describe("JSON array of transforms applied before WHERE, e.g. [{\"field\": \"email\", \"func\": \"lower\"}]. Funcs: upper, lower, trim, substring (start, length), replace (old, new), length, date_trunc (unit: year/month/day/hour), date_extract (part: year/month/day/hour/minute/weekday)"),
     limit: z.number().optional().describe("Max results to return"),
     offset: z.number().optional().describe("Skip this many results"),
     join: z.string().optional().describe("JSON object of join config, e.g. {\"file\": \"other\", \"on\": \"id\", \"type\": \"inner\"}"),
     pivot: z.string().optional().describe("JSON object of pivot config, e.g. {\"row\": \"category\", \"column\": \"month\", \"values\": \"sales\"}"),
     mercury: z.string().optional().describe("JSON object of mercury scoring config, e.g. {\"fields\": [{\"field\": \"score\", \"target\": 100, \"weight\": 1.0}]}"),
     userid: z.string().optional().describe("Project owner's username. Required when accessing a shared project where you are a writer. Defaults to the authenticated user."),
-}, async ({ project, file, where: whereStr, select, aggregate: aggregateStr, order_by: orderByStr, limit, offset, join: joinStr, pivot: pivotStr, mercury: mercuryStr, userid }) => withBaaCheck(async () => {
+}, async ({ project, file, where: whereStr, select, aggregate: aggregateStr, order_by: orderByStr, distinct, transform: transformStr, limit, offset, join: joinStr, pivot: pivotStr, mercury: mercuryStr, userid }) => withBaaCheck(async () => {
     const where = typeof whereStr === 'string' ? JSON.parse(whereStr) : whereStr;
     const aggregate = typeof aggregateStr === 'string' ? JSON.parse(aggregateStr) : aggregateStr;
     const order_by = typeof orderByStr === 'string' ? JSON.parse(orderByStr) : orderByStr;
+    const transform = transformStr ? (typeof transformStr === 'string' ? JSON.parse(transformStr) : transformStr) : undefined;
     const join = typeof joinStr === 'string' ? JSON.parse(joinStr) : joinStr;
     const pivot = typeof pivotStr === 'string' ? JSON.parse(pivotStr) : pivotStr;
     const mercury = typeof mercuryStr === 'string' ? JSON.parse(mercuryStr) : mercuryStr;
@@ -612,6 +615,10 @@ server.tool("chaprola_query", "SQL-free data query with WHERE, SELECT, aggregati
         body.aggregate = aggregate;
     if (order_by)
         body.order_by = order_by;
+    if (distinct)
+        body.distinct = distinct;
+    if (transform)
+        body.transform = transform;
     if (limit !== undefined)
         body.limit = limit;
     if (offset !== undefined)
@@ -868,15 +875,22 @@ server.tool("chaprola_schedule_delete", "Delete a scheduled job by name", {
     return textResult(res);
 }));
 // --- Record CRUD ---
-server.tool("chaprola_insert_record", "Insert a new record into a data file's merge file (.MRG). The record appears at the end of the file until consolidation.", {
+server.tool("chaprola_insert_record", "Insert one or more records into a data file. For single insert, use record. For batch insert (up to 1000), use records. All records are validated before any writes — invalid batch = no partial writes.", {
     project: z.string().describe("Project name"),
     file: z.string().describe("Data file name (without extension)"),
-    record: z.string().describe("JSON object of the record to insert, e.g. {\"name\": \"foo\", \"status\": \"active\"}. Unspecified fields default to blanks."),
+    record: z.string().optional().describe("JSON object of a single record to insert, e.g. {\"name\": \"foo\", \"status\": \"active\"}. Use this OR records, not both."),
+    records: z.string().optional().describe("JSON array of records for batch insert (max 1000), e.g. [{\"name\": \"foo\"}, {\"name\": \"bar\"}]. Use this OR record, not both."),
     userid: z.string().optional().describe("Project owner's username. Required when accessing a shared project where you are a writer. Defaults to the authenticated user."),
-}, async ({ project, file, record: recordStr, userid }) => withBaaCheck(async () => {
-    const record = typeof recordStr === 'string' ? JSON.parse(recordStr) : recordStr;
+}, async ({ project, file, record: recordStr, records: recordsStr, userid }) => withBaaCheck(async () => {
+    const record = recordStr ? (typeof recordStr === 'string' ? JSON.parse(recordStr) : recordStr) : undefined;
+    const records = recordsStr ? (typeof recordsStr === 'string' ? JSON.parse(recordsStr) : recordsStr) : undefined;
     const { username } = getCredentials();
-    const res = await authedFetch("/insert-record", { userid: userid || username, project, file, record });
+    const body = { userid: userid || username, project, file };
+    if (record)
+        body.record = record;
+    if (records)
+        body.records = records;
+    const res = await authedFetch("/insert-record", body);
     return textResult(res);
 }));
 server.tool("chaprola_update_record", "Update fields in a single record matched by a where clause. If no sort-key changes, updates in place; otherwise marks old record ignored and appends to merge file.", {
@@ -903,6 +917,25 @@ server.tool("chaprola_delete_record", "Delete a single record matched by a where
     const res = await authedFetch("/delete-record", { userid: userid || username, project, file, where: whereClause });
     return textResult(res);
 }));
+server.tool("chaprola_upsert_record", "Insert or update a record by key field. If a record with the matching key value exists, update it in place. If not, insert it. Supports batch: pass records array to upsert multiple records in one call.", {
+    project: z.string().describe("Project name"),
+    file: z.string().describe("Data file name (without extension)"),
+    key: z.string().describe("Field name to match on, e.g. \"contact_id\". Must exist in the format file."),
+    record: z.string().optional().describe("JSON object of a single record to upsert, e.g. {\"contact_id\": \"c-42\", \"name\": \"Alice\"}. Must contain the key field. Use this OR records, not both."),
+    records: z.string().optional().describe("JSON array of records for batch upsert (max 1000). Each must contain the key field. Use this OR record, not both."),
+    userid: z.string().optional().describe("Project owner's username. Required when accessing a shared project where you are a writer. Defaults to the authenticated user."),
+}, async ({ project, file, key, record: recordStr, records: recordsStr, userid }) => withBaaCheck(async () => {
+    const record = recordStr ? (typeof recordStr === 'string' ? JSON.parse(recordStr) : recordStr) : undefined;
+    const records = recordsStr ? (typeof recordsStr === 'string' ? JSON.parse(recordsStr) : recordsStr) : undefined;
+    const { username } = getCredentials();
+    const body = { userid: userid || username, project, file, key };
+    if (record)
+        body.record = record;
+    if (records)
+        body.records = records;
+    const res = await authedFetch("/upsert-record", body);
+    return textResult(res);
+}));
 server.tool("chaprola_consolidate", "Merge a .MRG file into its parent .DA, producing a clean sorted data file. Deletes .MRG and .IGN after success. Aborts if .MRG was modified during the operation.", {
     project: z.string().describe("Project name"),
     file: z.string().describe("Data file name (without extension)"),

package/package.json

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