@chaprola/mcp-server 1.1.0 → 1.3.0

package/dist/index.js

@@ -489,6 +489,46 @@ server.tool("chaprola_merge", "Merge two sorted data files into one. Both must s
     const res = await authedFetch("/merge", { userid: username, project, file_a, file_b, output, key });
     return textResult(res);
 }));
+// --- Schema: Format + Alter ---
+server.tool("chaprola_format", "Inspect a data file's schema — returns field names, positions, lengths, types, and PHI flags", {
+    project: z.string().describe("Project name"),
+    name: z.string().describe("Data file name (without .F extension)"),
+}, async ({ project, name }) => withBaaCheck(async () => {
+    const { username } = getCredentials();
+    const res = await authedFetch("/format", { userid: username, project, name });
+    return textResult(res);
+}));
+server.tool("chaprola_alter", "Modify a data file's schema: widen/narrow/rename fields, add new fields, drop fields. Transforms existing data to match the new schema.", {
+    project: z.string().describe("Project name"),
+    name: z.string().describe("Data file name (without extension)"),
+    alter: z.array(z.object({
+        field: z.string().describe("Field name to modify"),
+        width: z.number().optional().describe("New width (widen or narrow)"),
+        rename: z.string().optional().describe("New field name"),
+        type: z.enum(["text", "numeric"]).optional().describe("Change field type"),
+    })).optional().describe("Fields to alter"),
+    add: z.array(z.object({
+        name: z.string().describe("New field name"),
+        width: z.number().describe("Field width"),
+        type: z.enum(["text", "numeric"]).optional().describe("Field type (default: text)"),
+        after: z.string().optional().describe("Insert after this field (default: end)"),
+    })).optional().describe("Fields to add"),
+    drop: z.array(z.string()).optional().describe("Field names to drop"),
+    output: z.string().optional().describe("Output file name (default: in-place)"),
+}, async ({ project, name, alter, add, drop, output }) => withBaaCheck(async () => {
+    const { username } = getCredentials();
+    const body = { userid: username, project, name };
+    if (alter)
+        body.alter = alter;
+    if (add)
+        body.add = add;
+    if (drop)
+        body.drop = drop;
+    if (output)
+        body.output = output;
+    const res = await authedFetch("/alter", body);
+    return textResult(res);
+}));
 // --- Optimize (HULDRA) ---
 server.tool("chaprola_optimize", "Run HULDRA nonlinear optimization using a compiled .PR as the objective evaluator", {
     project: z.string().describe("Project name"),
@@ -625,6 +665,43 @@ server.tool("chaprola_schedule_delete", "Delete a scheduled job by name", {
     const res = await authedFetch("/schedule/delete", { 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.", {
+    project: z.string().describe("Project name"),
+    file: z.string().describe("Data file name (without extension)"),
+    record: z.record(z.string()).describe("Field name → value pairs. Unspecified fields default to blanks."),
+}, async ({ project, file, record }) => withBaaCheck(async () => {
+    const { username } = getCredentials();
+    const res = await authedFetch("/insert-record", { userid: username, project, file, record });
+    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.", {
+    project: z.string().describe("Project name"),
+    file: z.string().describe("Data file name (without extension)"),
+    where: z.record(z.string()).describe("Field name → value pairs to identify exactly one record"),
+    set: z.record(z.string()).describe("Field name → new value pairs to update"),
+}, async ({ project, file, where: whereClause, set }) => withBaaCheck(async () => {
+    const { username } = getCredentials();
+    const res = await authedFetch("/update-record", { userid: username, project, file, where: whereClause, set });
+    return textResult(res);
+}));
+server.tool("chaprola_delete_record", "Delete a single record matched by a where clause. Marks the record as ignored (.IGN). Physically removed on consolidation.", {
+    project: z.string().describe("Project name"),
+    file: z.string().describe("Data file name (without extension)"),
+    where: z.record(z.string()).describe("Field name → value pairs to identify exactly one record"),
+}, async ({ project, file, where: whereClause }) => withBaaCheck(async () => {
+    const { username } = getCredentials();
+    const res = await authedFetch("/delete-record", { userid: username, project, file, where: whereClause });
+    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)"),
+}, async ({ project, file }) => withBaaCheck(async () => {
+    const { username } = getCredentials();
+    const res = await authedFetch("/consolidate", { userid: username, project, file });
+    return textResult(res);
+}));
 // --- Start server ---
 async function main() {
     const transport = new StdioServerTransport();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@chaprola/mcp-server",
-  "version": "1.1.0",
-  "description": "MCP server for Chaprola — agent-first data platform. Gives AI agents 40 tools for structured data storage, querying, web search, URL fetching, scheduled jobs, and execution via plain HTTP.",
+  "version": "1.3.0",
+  "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",
   "bin": {