@chaprola/mcp-server 1.0.2 → 1.2.0

package/README.md

@@ -2,7 +2,7 @@
 
 MCP server for [Chaprola](https://chaprola.org) — the agent-first data platform.
 
-Gives AI agents 35 tools for structured data storage, querying, compilation, and execution through the [Model Context Protocol](https://modelcontextprotocol.io).
+Gives AI agents 40 tools for structured data storage, querying, web search, URL fetching, scheduled jobs, and execution through the [Model Context Protocol](https://modelcontextprotocol.io).
 
 ## Quick Start
 
@@ -116,13 +116,18 @@ Or use the `chaprola_register` tool after connecting.
 | `chaprola_email_read` | Read email |
 | `chaprola_email_send` | Send email |
 | `chaprola_email_delete` | Delete email |
+| `chaprola_search` | Web search via Brave API |
+| `chaprola_fetch` | Fetch URL content as markdown/text/JSON |
+| `chaprola_schedule` | Create scheduled recurring job |
+| `chaprola_schedule_list` | List scheduled jobs |
+| `chaprola_schedule_delete` | Delete scheduled job |
 
 ## Resources
 
 The server exposes reference documentation as MCP resources:
 
 - `chaprola://cookbook` — Language cookbook with complete examples
-- `chaprola://endpoints` — All 35 API endpoints
+- `chaprola://endpoints` — All 40 API endpoints
 - `chaprola://auth` — Authentication reference
 - `chaprola://gotchas` — Common mistakes to avoid
 

package/dist/index.js

@@ -121,7 +121,7 @@ server.resource("cookbook", "chaprola://cookbook", { description: "Chaprola lang
 server.resource("gotchas", "chaprola://gotchas", { description: "Common Chaprola mistakes — no parentheses in LET, no commas in PRINT, MOVE length must match field width, DEFINE names must not collide with fields. READ THIS before writing code.", mimeType: "text/markdown" }, async () => ({
     contents: [{ uri: "chaprola://gotchas", mimeType: "text/markdown", text: readRef("gotchas.md") }],
 }));
-server.resource("endpoints", "chaprola://endpoints", { description: "Chaprola API endpoint reference — all 35 endpoints with request/response shapes", mimeType: "text/markdown" }, async () => ({
+server.resource("endpoints", "chaprola://endpoints", { description: "Chaprola API endpoint reference — all 40 endpoints with request/response shapes", mimeType: "text/markdown" }, async () => ({
     contents: [{ uri: "chaprola://endpoints", mimeType: "text/markdown", text: readRef("endpoints.md") }],
 }));
 server.resource("auth", "chaprola://auth", { description: "Chaprola authentication reference — API key model, BAA flow, credential recovery", mimeType: "text/markdown" }, async () => ({
@@ -201,15 +201,12 @@ server.tool("chaprola_baa_text", "Get the current Business Associate Agreement t
     const res = await publicFetch("POST", "/baa-text", {});
     return textResult(res);
 });
-server.tool("chaprola_report", "Run a published program and return output. No auth required — program must be published first", {
+server.tool("chaprola_report", "Run a published program and return output. No auth required — program must be published first via /publish", {
     userid: z.string().describe("Owner of the published program"),
     project: z.string().describe("Project containing the program"),
     name: z.string().describe("Name of the published .PR file"),
-    primary_file: z.string().optional().describe("Data file to load"),
-}, async ({ userid, project, name, primary_file }) => {
+}, async ({ userid, project, name }) => {
     const body = { userid, project, name };
-    if (primary_file)
-        body.primary_file = primary_file;
     const res = await publicFetch("POST", "/report", body);
     return textResult(res);
 });
@@ -311,19 +308,19 @@ server.tool("chaprola_list", "List files in a project with optional wildcard pat
     return textResult(res);
 }));
 // --- Compile ---
-server.tool("chaprola_compile", "Compile Chaprola source (.CS) to bytecode (.PR). READ chaprola://cookbook BEFORE writing source. Key syntax: no PROGRAM keyword (start with commands), no commas, MOVE+PRINT 0 buffer model (not PRINT field), SEEK for primary records, OPEN/READ/WRITE/CLOSE for secondary files, LET supports one operation (no parentheses), field addressing via P.field/S.field requires primary_format/secondary_formats params.", {
+server.tool("chaprola_compile", "Compile Chaprola source (.CS) to bytecode (.PR). READ chaprola://cookbook BEFORE writing source. Key syntax: no PROGRAM keyword (start with commands), no commas, MOVE+PRINT 0 buffer model (not PRINT field), SEEK for primary records, OPEN/READ/WRITE/CLOSE for secondary files, LET supports one operation (no parentheses), field addressing via P.field/S.field requires primary_format/secondary_format params.", {
     project: z.string().describe("Project name"),
     name: z.string().describe("Program name (without extension)"),
     source: z.string().describe("Chaprola source code"),
     primary_format: z.string().optional().describe("Primary data file name (enables P.fieldname addressing)"),
-    secondary_formats: z.array(z.string()).optional().describe("Secondary format file names (enables S.fieldname addressing)"),
-}, async ({ project, name, source, primary_format, secondary_formats }) => withBaaCheck(async () => {
+    secondary_format: z.string().optional().describe("Secondary format file name (enables S.fieldname addressing)"),
+}, async ({ project, name, source, primary_format, secondary_format }) => withBaaCheck(async () => {
     const { username } = getCredentials();
     const body = { userid: username, project, name, source };
     if (primary_format)
         body.primary_format = primary_format;
-    if (secondary_formats)
-        body.secondary_formats = secondary_formats;
+    if (secondary_format)
+        body.secondary_format = secondary_format;
     const res = await authedFetch("/compile", body);
     return textResult(res);
 }));
@@ -492,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"),
@@ -576,6 +613,58 @@ server.tool("chaprola_email_delete", "Delete a specific email from your mailbox"
     const res = await authedFetch("/email/delete", { address: username, message_id });
     return textResult(res);
 }));
+// --- Search ---
+server.tool("chaprola_search", "Search the web via Brave Search API. Returns titles, URLs, and snippets. Optional AI-grounded summary. Rate limit: 10/day per user", {
+    query: z.string().describe("Search query string"),
+    count: z.number().optional().describe("Number of results to return (default 5, max 20)"),
+    summarize: z.boolean().optional().describe("Include AI-grounded summary from Brave Answers API"),
+}, async ({ query, count, summarize }) => withBaaCheck(async () => {
+    const body = { query };
+    if (count !== undefined)
+        body.count = count;
+    if (summarize !== undefined)
+        body.summarize = summarize;
+    const res = await authedFetch("/search", body);
+    return textResult(res);
+}));
+// --- Fetch ---
+server.tool("chaprola_fetch", "Fetch any URL and return clean content. HTML pages converted to markdown. SSRF-protected. Rate limit: 20/day per user", {
+    url: z.string().url().describe("URL to fetch (http:// or https://)"),
+    format: z.enum(["markdown", "text", "html", "json"]).optional().describe("Output format (default: markdown)"),
+    max_length: z.number().optional().describe("Max output characters (default: 50000, max: 200000)"),
+}, async ({ url, format, max_length }) => withBaaCheck(async () => {
+    const body = { url };
+    if (format)
+        body.format = format;
+    if (max_length !== undefined)
+        body.max_length = max_length;
+    const res = await authedFetch("/fetch", body);
+    return textResult(res);
+}));
+// --- Schedule ---
+server.tool("chaprola_schedule", "Create a scheduled job that runs a Chaprola endpoint on a recurring cron. Max 10 schedules/user, 15-min minimum interval", {
+    name: z.string().describe("Unique name for this schedule (alphanumeric + hyphens/underscores)"),
+    cron: z.string().describe("Standard 5-field cron expression (min hour day month weekday). Minimum interval: 15 minutes"),
+    endpoint: z.enum(["/import-download", "/run", "/export-report", "/search", "/fetch", "/query", "/email/send", "/export", "/report", "/list"]).describe("Target endpoint to call"),
+    body: z.record(z.any()).describe("Request body for the target endpoint. userid is injected automatically"),
+    skip_if_unchanged: z.boolean().optional().describe("Skip when response matches previous run (SHA-256 hash). Default: false"),
+}, async ({ name, cron, endpoint, body, skip_if_unchanged }) => withBaaCheck(async () => {
+    const reqBody = { name, cron, endpoint, body };
+    if (skip_if_unchanged !== undefined)
+        reqBody.skip_if_unchanged = skip_if_unchanged;
+    const res = await authedFetch("/schedule", reqBody);
+    return textResult(res);
+}));
+server.tool("chaprola_schedule_list", "List all scheduled jobs for the authenticated user with run history and next execution time", {}, async () => withBaaCheck(async () => {
+    const res = await authedFetch("/schedule/list", {});
+    return textResult(res);
+}));
+server.tool("chaprola_schedule_delete", "Delete a scheduled job by name", {
+    name: z.string().describe("Name of the schedule to delete"),
+}, async ({ name }) => withBaaCheck(async () => {
+    const res = await authedFetch("/schedule/delete", { name });
+    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.0.2",
-  "description": "MCP server for Chaprola — agent-first data platform. Gives AI agents 35 tools for structured data storage, querying, compilation, and execution via plain HTTP.",
+  "version": "1.2.0",
+  "description": "MCP server for Chaprola — agent-first data platform. Gives AI agents 42 tools for structured data storage, querying, schema inspection, web search, URL fetching, scheduled jobs, and execution via plain HTTP.",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/references/cookbook.md

@@ -58,7 +58,7 @@ READ match                   // load matched secondary record
 MOVE S.dept_name U.12 15    // now accessible
 ```
 
-Compile with: `primary_format: "EMPLOYEES", secondary_formats: ["DEPARTMENTS"]`
+Compile with: `primary_format: "EMPLOYEES", secondary_format: "DEPARTMENTS"`
 
 ## Read-Modify-Write (UPDATE)
 

package/references/endpoints.md

@@ -38,7 +38,7 @@ Auth: `Authorization: Bearer chp_your_api_key` on all protected endpoints.
 ### Compile & Run
 | Endpoint | Body | Response |
 |----------|------|----------|
-| `POST /compile` | `{userid, project, name, source, primary_format?, secondary_formats?}` | `{instructions, bytes}` |
+| `POST /compile` | `{userid, project, name, source, primary_format?, secondary_format?}` | `{instructions, bytes}` |
 | `POST /run` | `{userid, project, name, primary_file?, record?, async?, nophi?}` | `{output, registers}` or `{job_id}` |
 | `POST /run/status` | `{userid, project, job_id}` | `{status: "running"/"done", output?}` |
 | `POST /publish` | `{userid, project, name, primary_file?, record?}` | `{report_url}` |

package/references/gotchas.md

@@ -58,8 +58,8 @@ All import/export/compile/run/query/email endpoints return 403 without a signed
 ### Async for large datasets
 `POST /run` with `async: true` for >100K records. API Gateway has a 30-second timeout; async bypasses it. Poll `/run/status` until `status: "done"`.
 
-### secondary_formats is an array
-Pass `secondary_formats: ["DEPARTMENTS"]` (array), not `secondary_format: "DEPARTMENTS"` (string), to `/compile`.
+### secondary_format is a string
+Pass `secondary_format: "DEPARTMENTS"` (a single string), not an array, to `/compile`.
 
 ### Data files expire
 Default 90 days. Set `expires_in_days` on import to override. Expired files are deleted daily at 03:00 UTC.