@heisee/letsclarify-mcp 1.0.0

package/README.md

@@ -0,0 +1,48 @@
+# @heisee/letsclarify-mcp
+
+MCP server for [LetsClarify](https://letsclarify.ai) — Human-in-the-Loop API for AI agents.
+
+Create structured forms via API, share URLs with humans, get JSON back.
+
+## Setup
+
+```json
+{
+  "mcpServers": {
+    "letsclarify": {
+      "command": "npx",
+      "args": ["-y", "@heisee/letsclarify-mcp"],
+      "env": {
+        "LETSCLARIFY_API_KEY": "lc_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `create_form` | Create a form with schema, title, context, recipients |
+| `get_form_summary` | Quick overview: submitted/pending counts |
+| `get_form_results` | Paginated results with filters and file support |
+| `delete_form` | Permanently delete a form and all its data |
+| `add_recipients` | Add more recipient slots to an existing form |
+
+## Resources
+
+| URI | Description |
+|-----|-------------|
+| `letsclarify://schema-dsl` | Schema DSL reference (field types, validation, file config) |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `LETSCLARIFY_API_KEY` | Yes | API key (starts with `lc_`) |
+| `LETSCLARIFY_BASE_URL` | No | Override base URL (default: `https://letsclarify.ai`) |
+
+## License
+
+MIT

package/build/client.d.ts

@@ -0,0 +1,61 @@
+export interface ApiError {
+    error: string;
+    message?: string;
+    messages?: string[];
+}
+export declare class LetsClarifyClient {
+    private baseUrl;
+    private apiKey;
+    constructor(apiKey: string, baseUrl?: string);
+    private request;
+    createForm(body: {
+        schema: unknown[];
+        title?: string;
+        context_markdown?: string;
+        recipient_count?: number;
+        retention_days?: number;
+        webhook_url?: string;
+        theme_color?: string;
+    }): Promise<{
+        form_token: string;
+        delete_token: string;
+        base_url_template: string;
+        poll_url: string;
+        summary_url: string;
+        delete_url: string;
+        recipients: string[];
+    }>;
+    getFormSummary(formToken: string): Promise<{
+        expired: boolean;
+        known_total: number;
+        submitted_total: number;
+        pending_total: number;
+        updated_at_max: string;
+    }>;
+    getFormResults(formToken: string, params?: {
+        limit?: string;
+        cursor?: string;
+        status?: string;
+        updated_since?: string;
+        include_files?: string;
+    }): Promise<{
+        expired: boolean;
+        next_cursor: string | null;
+        server_time: string;
+        results: Array<{
+            recipient_uuid: string;
+            status: string;
+            submitted_at: string | null;
+            updated_at: string;
+            response_json: Record<string, unknown> | null;
+            files?: unknown;
+        }>;
+    }>;
+    deleteForm(formToken: string, deleteToken: string): Promise<{
+        deleted: boolean;
+    }>;
+    addRecipients(formToken: string, count?: number): Promise<{
+        recipients: string[];
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/build/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM,EAAE,OAAO,SAA2B;YAKhD,OAAO;IAiDf,UAAU,CAAC,IAAI,EAAE;QACrB,MAAM,EAAE,OAAO,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB;oBAEe,MAAM;sBACJ,MAAM;2BACD,MAAM;kBACf,MAAM;qBACH,MAAM;oBACP,MAAM;oBACN,MAAM,EAAE;;IAIlB,cAAc,CAAC,SAAS,EAAE,MAAM;iBAEzB,OAAO;qBACH,MAAM;yBACF,MAAM;uBACR,MAAM;wBACL,MAAM;;IAIpB,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB;iBAGU,OAAO;qBACH,MAAM,GAAG,IAAI;qBACb,MAAM;iBACV,KAAK,CAAC;YACb,cAAc,EAAE,MAAM,CAAC;YACvB,MAAM,EAAE,MAAM,CAAC;YACf,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;YAC5B,UAAU,EAAE,MAAM,CAAC;YACnB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;YAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;SACjB,CAAC;;IAIA,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;iBACtB,OAAO;;IAOlC,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;oBACjB,MAAM,EAAE;;CAM7C"}

package/build/client.js

@@ -0,0 +1,57 @@
+export class LetsClarifyClient {
+    baseUrl;
+    apiKey;
+    constructor(apiKey, baseUrl = "https://letsclarify.ai") {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+    }
+    async request(method, path, options = {}) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        if (options.params) {
+            for (const [key, value] of Object.entries(options.params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, value);
+                }
+            }
+        }
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+            Accept: "application/json",
+            ...options.headers,
+        };
+        if (options.body) {
+            headers["Content-Type"] = "application/json";
+        }
+        const response = await fetch(url.toString(), {
+            method,
+            headers,
+            body: options.body ? JSON.stringify(options.body) : undefined,
+        });
+        const json = await response.json();
+        if (!response.ok) {
+            const err = json;
+            const detail = err.messages
+                ? err.messages.join("; ")
+                : err.message || err.error;
+            throw new Error(`API ${response.status}: ${detail}`);
+        }
+        return json;
+    }
+    // --- Public methods ---
+    async createForm(body) {
+        return this.request("POST", "/api/v1/forms", { body });
+    }
+    async getFormSummary(formToken) {
+        return this.request("GET", `/api/v1/forms/${formToken}/summary`);
+    }
+    async getFormResults(formToken, params) {
+        return this.request("GET", `/api/v1/forms/${formToken}/results`, { params });
+    }
+    async deleteForm(formToken, deleteToken) {
+        return this.request("DELETE", `/api/v1/forms/${formToken}`, { headers: { "X-Delete-Token": deleteToken } });
+    }
+    async addRecipients(formToken, count) {
+        return this.request("POST", `/api/v1/forms/${formToken}/recipients`, { body: count !== undefined ? { count } : {} });
+    }
+}
+//# sourceMappingURL=client.js.map

package/build/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { LetsClarifyClient } from "./client.js";
+import { createServer } from "./server.js";
+const apiKey = process.env.LETSCLARIFY_API_KEY;
+if (!apiKey) {
+    console.error("Error: LETSCLARIFY_API_KEY environment variable is required.");
+    process.exit(1);
+}
+const baseUrl = process.env.LETSCLARIFY_BASE_URL || "https://letsclarify.ai";
+const client = new LetsClarifyClient(apiKey, baseUrl);
+const server = createServer(client);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;AAC/C,IAAI,CAAC,MAAM,EAAE,CAAC;IACZ,OAAO,CAAC,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,IAAI,wBAAwB,CAAC;AAC7E,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/build/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LetsClarifyClient } from "./client.js";
+export declare function createServer(client: LetsClarifyClient): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/build/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6FhD,wBAAgB,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,SAAS,CA6BjE"}

package/build/server.js

@@ -0,0 +1,118 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { registerCreateForm } from "./tools/create-form.js";
+import { registerGetFormSummary } from "./tools/get-form-summary.js";
+import { registerGetFormResults } from "./tools/get-form-results.js";
+import { registerDeleteForm } from "./tools/delete-form.js";
+import { registerAddRecipients } from "./tools/add-recipients.js";
+const SCHEMA_DSL_RESOURCE = `# LetsClarify Schema DSL Reference
+
+## Field Types
+
+| Type | Description | Requires \`options\` |
+|---|---|---|
+| \`text\` | Single-line text input | No |
+| \`textarea\` | Multi-line text input | No |
+| \`checkbox\` | Single boolean checkbox | No |
+| \`checkbox_group\` | Multiple checkboxes | Yes |
+| \`radio\` | Radio button group | Yes |
+| \`select\` | Dropdown select | Yes |
+| \`file\` | File upload | No |
+
+## Field Object Structure
+
+\`\`\`json
+{
+  "id": "field_name",        // unique, letters/digits/underscores
+  "type": "text",            // one of the types above
+  "label": "Your Name",     // human-readable label
+  "required": true,          // optional, default false
+  "placeholder": "Enter…",  // optional
+  "description": "Help text" // optional
+}
+\`\`\`
+
+## Options (required for radio, select, checkbox_group)
+
+\`\`\`json
+"options": [
+  { "value": "yes", "label": "Yes" },
+  { "value": "no", "label": "No" }
+]
+\`\`\`
+
+## Validation Rules (optional)
+
+- \`min_length\` / \`max_length\` — for text/textarea
+- \`pattern\` — regex string for text/textarea
+- \`min_items\` / \`max_items\` — for checkbox_group
+
+\`\`\`json
+"validation": { "min_length": 10, "max_length": 500 }
+\`\`\`
+
+## File Config (optional, for file type only)
+
+- \`accept\` — array of MIME types or extensions: \`["image/*", ".pdf"]\`
+- \`max_size_mb\` — max file size in MB (1–10)
+- \`max_files\` — max number of files (1–10)
+
+\`\`\`json
+"file": { "accept": [".pdf", "image/*"], "max_size_mb": 5, "max_files": 3 }
+\`\`\`
+
+## Example Schema
+
+\`\`\`json
+[
+  {
+    "id": "decision",
+    "type": "radio",
+    "label": "Your decision",
+    "required": true,
+    "options": [
+      { "value": "approve", "label": "Approve" },
+      { "value": "reject", "label": "Reject" }
+    ]
+  },
+  {
+    "id": "notes",
+    "type": "textarea",
+    "label": "Additional notes",
+    "validation": { "max_length": 1000 }
+  },
+  {
+    "id": "attachment",
+    "type": "file",
+    "label": "Supporting document",
+    "file": { "accept": [".pdf", ".docx"], "max_size_mb": 10 }
+  }
+]
+\`\`\`
+`;
+export function createServer(client) {
+    const server = new McpServer({
+        name: "letsclarify",
+        version: "1.0.0",
+    });
+    // Register tools
+    registerCreateForm(server, client);
+    registerGetFormSummary(server, client);
+    registerGetFormResults(server, client);
+    registerDeleteForm(server, client);
+    registerAddRecipients(server, client);
+    // Register schema DSL resource
+    server.resource("schema-dsl", "letsclarify://schema-dsl", {
+        description: "Schema DSL reference for LetsClarify form fields — types, validation, file config, and examples.",
+        mimeType: "text/markdown",
+    }, async () => ({
+        contents: [
+            {
+                uri: "letsclarify://schema-dsl",
+                mimeType: "text/markdown",
+                text: SCHEMA_DSL_RESOURCE,
+            },
+        ],
+    }));
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAElE,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoF3B,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,MAAyB;IACpD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IAEH,iBAAiB;IACjB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtC,+BAA+B;IAC/B,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,0BAA0B,EAAE;QACxD,WAAW,EACT,kGAAkG;QACpG,QAAQ,EAAE,eAAe;KAC1B,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,0BAA0B;gBAC/B,QAAQ,EAAE,eAAe;gBACzB,IAAI,EAAE,mBAAmB;aAC1B;SACF;KACF,CAAC,CAAC,CAAC;IAEJ,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/build/tools/add-recipients.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LetsClarifyClient } from "../client.js";
+export declare function registerAddRecipients(server: McpServer, client: LetsClarifyClient): void;
+//# sourceMappingURL=add-recipients.d.ts.map

package/build/tools/add-recipients.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-recipients.d.ts","sourceRoot":"","sources":["../../src/tools/add-recipients.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,QAsBjF"}

package/build/tools/add-recipients.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export function registerAddRecipients(server, client) {
+    server.tool("add_recipients", "Add more recipient slots to an existing form. Returns new UUIDs. Build URLs using the base_url_template from create_form. Cannot be used on expired forms.", {
+        form_token: z.string().describe("The form token returned by create_form"),
+        count: z.number().int().min(1).max(1000).optional().describe("Number of new recipients to add (default: 1)"),
+    }, async (args) => {
+        try {
+            const result = await client.addRecipients(args.form_token, args.count);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=add-recipients.js.map

package/build/tools/add-recipients.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-recipients.js","sourceRoot":"","sources":["../../src/tools/add-recipients.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,MAAyB;IAChF,MAAM,CAAC,IAAI,CACT,gBAAgB,EAChB,4JAA4J,EAC5J;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;KAC7G,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC9G,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/create-form.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LetsClarifyClient } from "../client.js";
+export declare function registerCreateForm(server: McpServer, client: LetsClarifyClient): void;
+//# sourceMappingURL=create-form.d.ts.map

package/build/tools/create-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-form.d.ts","sourceRoot":"","sources":["../../src/tools/create-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAqCjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,QAyD9E"}

package/build/tools/create-form.js

@@ -0,0 +1,79 @@
+import { z } from "zod";
+const FieldValidation = z
+    .object({
+    min_length: z.number().int().nonnegative().optional(),
+    max_length: z.number().int().positive().optional(),
+    pattern: z.string().optional(),
+    min_items: z.number().int().nonnegative().optional(),
+    max_items: z.number().int().positive().optional(),
+})
+    .optional();
+const FileConfig = z
+    .object({
+    accept: z.array(z.string()).optional(),
+    max_size_mb: z.number().min(1).max(10).optional(),
+    max_files: z.number().int().min(1).max(10).optional(),
+})
+    .optional();
+const Option = z.object({
+    value: z.string(),
+    label: z.string(),
+});
+const SchemaField = z.object({
+    id: z.string().describe("Unique field identifier (letters, digits, underscores)"),
+    type: z.enum(["text", "textarea", "checkbox", "checkbox_group", "radio", "select", "file"]),
+    label: z.string().describe("Human-readable field label"),
+    required: z.boolean().optional(),
+    placeholder: z.string().optional(),
+    description: z.string().optional(),
+    options: z.array(Option).optional().describe("Required for radio, select, checkbox_group"),
+    file: FileConfig.describe("Optional config for file fields"),
+    validation: FieldValidation,
+});
+export function registerCreateForm(server, client) {
+    server.tool("create_form", `Create a LetsClarify form. Returns a form_token, delete_token, recipient UUIDs, and URL template.
+Build shareable URLs by replacing {recipient_uuid} in base_url_template with each UUID.
+Use the "letsclarify://schema-dsl" resource for field type reference.`, {
+        schema: z.array(SchemaField).min(1).max(50).describe("Form field definitions (1–50 fields)"),
+        title: z.string().optional().describe("Form title shown to recipients"),
+        context_markdown: z.string().optional().describe("Markdown context shown above the form"),
+        recipient_count: z.number().int().min(1).max(1000).optional().describe("Number of recipient slots (default: 1)"),
+        retention_days: z.number().int().min(1).max(365).optional().describe("Days until auto-deletion (default: 30)"),
+        webhook_url: z.string().optional().describe("HTTPS URL for submission webhooks"),
+        theme_color: z.string().optional().describe("Hex color for form branding, e.g. #1a2b3c"),
+    }, async (args) => {
+        try {
+            const result = await client.createForm({
+                schema: args.schema,
+                title: args.title,
+                context_markdown: args.context_markdown,
+                recipient_count: args.recipient_count,
+                retention_days: args.retention_days,
+                webhook_url: args.webhook_url,
+                theme_color: args.theme_color,
+            });
+            const urls = result.recipients.map((uuid) => result.base_url_template.replace("{recipient_uuid}", uuid));
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            form_token: result.form_token,
+                            delete_token: result.delete_token,
+                            recipient_urls: urls,
+                            poll_url: result.poll_url,
+                            summary_url: result.summary_url,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=create-form.js.map

package/build/tools/create-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-form.js","sourceRoot":"","sources":["../../src/tools/create-form.ts"],"names":[],"mappings":"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"}

package/build/tools/delete-form.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LetsClarifyClient } from "../client.js";
+export declare function registerDeleteForm(server: McpServer, client: LetsClarifyClient): void;
+//# sourceMappingURL=delete-form.d.ts.map

package/build/tools/delete-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-form.d.ts","sourceRoot":"","sources":["../../src/tools/delete-form.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,QAsB9E"}

package/build/tools/delete-form.js

@@ -0,0 +1,21 @@
+import { z } from "zod";
+export function registerDeleteForm(server, client) {
+    server.tool("delete_form", "Permanently delete a form and all its data (recipients, submissions, files). This action is irreversible. Requires the delete_token from the create_form response.", {
+        form_token: z.string().describe("The form token returned by create_form"),
+        delete_token: z.string().describe("The delete token returned by create_form"),
+    }, async (args) => {
+        try {
+            const result = await client.deleteForm(args.form_token, args.delete_token);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=delete-form.js.map

package/build/tools/delete-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-form.js","sourceRoot":"","sources":["../../src/tools/delete-form.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,MAAyB;IAC7E,MAAM,CAAC,IAAI,CACT,aAAa,EACb,oKAAoK,EACpK;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;KAC9E,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC9G,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/get-form-results.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LetsClarifyClient } from "../client.js";
+export declare function registerGetFormResults(server: McpServer, client: LetsClarifyClient): void;
+//# sourceMappingURL=get-form-results.d.ts.map

package/build/tools/get-form-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-results.d.ts","sourceRoot":"","sources":["../../src/tools/get-form-results.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,QAkClF"}

package/build/tools/get-form-results.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export function registerGetFormResults(server, client) {
+    server.tool("get_form_results", "Fetch paginated form results. Returns each recipient's status and submitted answers. Supports filtering by status and updated_since for efficient polling.", {
+        form_token: z.string().describe("The form token returned by create_form"),
+        limit: z.number().int().min(1).max(1000).optional().describe("Max results per page (default: 100)"),
+        cursor: z.string().optional().describe("Pagination cursor from a previous response"),
+        status: z.enum(["submitted", "pending"]).optional().describe("Filter by recipient status"),
+        updated_since: z.string().optional().describe("ISO8601 timestamp — only return results updated at or after this time"),
+        include_files: z.boolean().optional().describe("Include base64-encoded file contents (can be large)"),
+    }, async (args) => {
+        try {
+            const params = {
+                limit: args.limit?.toString(),
+                cursor: args.cursor,
+                status: args.status,
+                updated_since: args.updated_since,
+                include_files: args.include_files ? "1" : undefined,
+            };
+            const result = await client.getFormResults(args.form_token, params);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-form-results.js.map

package/build/tools/get-form-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-results.js","sourceRoot":"","sources":["../../src/tools/get-form-results.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAyB;IACjF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,4JAA4J,EAC5J;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;QACzE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;QACnG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;QACpF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;QAC1F,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uEAAuE,CAAC;QACtH,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KACtG,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAuC;gBACjD,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE;gBAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;aACpD,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC9G,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/get-form-summary.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { LetsClarifyClient } from "../client.js";
+export declare function registerGetFormSummary(server: McpServer, client: LetsClarifyClient): void;
+//# sourceMappingURL=get-form-summary.d.ts.map

package/build/tools/get-form-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-summary.d.ts","sourceRoot":"","sources":["../../src/tools/get-form-summary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,QAqBlF"}

package/build/tools/get-form-summary.js

@@ -0,0 +1,20 @@
+import { z } from "zod";
+export function registerGetFormSummary(server, client) {
+    server.tool("get_form_summary", "Get a quick overview of a form: how many recipients submitted vs. pending, and whether the form is expired.", {
+        form_token: z.string().describe("The form token returned by create_form"),
+    }, async (args) => {
+        try {
+            const result = await client.getFormSummary(args.form_token);
+            return {
+                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                content: [{ type: "text", text: `Error: ${error instanceof Error ? error.message : String(error)}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=get-form-summary.js.map

package/build/tools/get-form-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-form-summary.js","sourceRoot":"","sources":["../../src/tools/get-form-summary.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,MAAyB;IACjF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,6GAA6G,EAC7G;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;KAC1E,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YAC5D,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aAC5E,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;gBAC9G,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@heisee/letsclarify-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for LetsClarify — Human-in-the-Loop API for AI agents",
+  "license": "MIT",
+  "author": "heisee",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/heisee/LetsClarify",
+    "directory": "mcp-server"
+  },
+  "type": "module",
+  "main": "build/index.js",
+  "bin": {
+    "letsclarify-mcp": "build/index.js"
+  },
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "letsclarify",
+    "human-in-the-loop",
+    "ai-agents",
+    "forms"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.21",
+    "typescript": "^5.8.3"
+  }
+}