aixischeck-mcp 0.4.0 → 0.5.0

package/README.md

@@ -21,6 +21,15 @@ upload. Generate an HTML one-pager in chat, and it lands in your workspace, rend
   (base_version derived from the request); records what was done with each comment
   (incorporated / partial / skipped / not_addressed). The write-back to Postgres is one
   atomic RPC (concurrency + idempotency guaranteed).
+- **`create_comments`** — `{ doc_id, origin, items[] }`. Bulk-creates review comments,
+  e.g. from a transcript of a reviewer narrating feedback while reading (such as a
+  Granola recording). Each item needs `section_index` (0-based, from `get_doc`'s
+  `sections`) and an EXACT verbatim `selected_text` quote from that section —
+  paraphrased quotes are rejected, not force-matched. `origin` is `'ai-transcribed'`
+  (matched from a human transcript) or `'ai-generated'`. Up to 20 items per call;
+  each item succeeds or fails independently (`created`/`rejected`, with a reason).
+  Every created comment lands **unconfirmed** — the reviewer must confirm it in the
+  AIxisCheck sidebar before it counts as a real review comment.
 
 ## Setup
 

package/dist/index.js

@@ -12,7 +12,7 @@
 //   AIXIS_URL    — Supabase project URL, e.g. https://<ref>.supabase.co
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { buildCreateDocBody, createDocShape, createRevisionRequestShape, edgeErrorMessage, functionUrl, getDocShape, listCommentsShape, listDocsShape, updateDocShape, } from "./lib.js";
+import { buildCreateDocBody, createCommentsShape, createDocShape, createRevisionRequestShape, edgeErrorMessage, functionUrl, getDocShape, listCommentsShape, listDocsShape, updateDocShape, } from "./lib.js";
 const AIXIS_TOKEN = process.env.AIXIS_TOKEN ?? "";
 const AIXIS_URL = process.env.AIXIS_URL ?? "";
 if (!AIXIS_TOKEN || !AIXIS_URL) {
@@ -43,7 +43,7 @@ function errorResult(e) {
     const message = e instanceof Error ? e.message : String(e);
     return { content: [{ type: "text", text: message }], isError: true };
 }
-const server = new McpServer({ name: "aixischeck-mcp", version: "0.4.0" });
+const server = new McpServer({ name: "aixischeck-mcp", version: "0.5.0" });
 server.registerTool("list_workspaces", {
     description: "List the AIxisCheck workspaces you can write to. Returns each workspace's id, name, and your role. Call this first to get a workspace_id for create_doc.",
     inputSchema: {},
@@ -157,5 +157,31 @@ server.registerTool("update_doc", {
         return errorResult(e);
     }
 });
+server.registerTool("create_comments", {
+    description: "Bulk-create review comments on an AIxisCheck doc — e.g. from a transcript of a reviewer narrating feedback while reading (such as a Granola recording). Call get_doc FIRST to read the doc's actual content and section list: each item's selected_text must be an EXACT, verbatim substring of the target section — do not paraphrase. Set origin:'ai-transcribed' when the feedback came from a human transcript, or 'ai-generated' otherwise. Up to 20 items per call. Items that don't match verbatim (or match ambiguously — the same phrase appears more than once in that section) are rejected individually; the rest of the batch still succeeds. Every created comment lands UNCONFIRMED in the sidebar — the reviewer must confirm it there before it counts as a real review comment.",
+    inputSchema: createCommentsShape,
+}, async (args) => {
+    try {
+        const data = await callEdge("mcp-create-comments", "POST", {
+            doc_id: args.doc_id,
+            origin: args.origin,
+            items: args.items,
+        });
+        const created = Array.isArray(data?.created) ? data.created : [];
+        const rejected = Array.isArray(data?.rejected) ? data.rejected : [];
+        const parts = [`Created ${created.length} comment(s).`];
+        if (rejected.length) {
+            const detail = rejected
+                .map((r) => `item ${r.item_index} (${r.reason})`)
+                .join(", ");
+            parts.push(`${rejected.length} rejected: ${detail}. Re-check each quote against the section's actual ` +
+                "text (via get_doc) and retry those items if needed.");
+        }
+        return { content: [{ type: "text", text: parts.join(" ") }] };
+    }
+    catch (e) {
+        return errorResult(e);
+    }
+});
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/dist/lib.js

@@ -47,6 +47,27 @@ export const updateDocShape = {
 export const createRevisionRequestShape = {
     doc_id: z.string().min(1, "doc_id is required"),
 };
+// create_comments (bulk comment import, 2026-07-09): write a batch of
+// AI-matched comments onto a doc's existing sections. section_index is the
+// 0-based index into get_doc's `sections` array (its sections[].id is this
+// same index, stringified) — NOT a free-form id. selected_text must be an
+// EXACT substring of that section's content; the edge function rejects
+// items that don't match verbatim (or match ambiguously) rather than
+// guessing. Every item in one call shares an `origin`, which becomes the
+// created annotation's `source` and determines nothing else server-side —
+// all AI-created comments land unconfirmed regardless of origin.
+export const createCommentsShape = {
+    doc_id: z.string().min(1, "doc_id is required"),
+    origin: z.enum(["ai-transcribed", "ai-generated"]).describe("'ai-transcribed' if these comments were matched from a human transcript (e.g. a Granola recording of the reviewer narrating feedback while reading); 'ai-generated' if there was no human transcript source."),
+    items: z.array(z.object({
+        section_index: z.number().int().min(0).describe("0-based index into the sections array returned by get_doc (sections[].id is this same index, stringified)."),
+        selected_text: z.string().min(1).describe("An EXACT, verbatim substring of that section's content — read the doc with get_doc first; do not paraphrase."),
+        prefix_context: z.string().optional().describe("A few characters immediately before selected_text, to disambiguate if the phrase repeats in the section."),
+        suffix_context: z.string().optional().describe("A few characters immediately after selected_text, to disambiguate if the phrase repeats in the section."),
+        note: z.string().min(1, "note is required"),
+    })).min(1).max(20, "at most 20 comments per call — split larger batches into multiple calls"),
+};
+export const CreateCommentsSchema = z.object(createCommentsShape);
 // Shape the POST body for the mcp-create-doc edge function, applying
 // the doc_type='html' default and normalizing an absent title to ''.
 export function buildCreateDocBody(input) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aixischeck-mcp",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "MCP server for AIxisCheck — create docs in your workspace from Claude Desktop.",
   "license": "MIT",
   "type": "module",