verifiedworkflows-mcp-server 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @verifiedworkflows/mcp-server
+
+MCP server for Verified Workflows — human-in-the-loop review as AI agent tools.
+
+## Quick start
+
+```bash
+export VW_API_KEY="vw_live_xxx"
+npx @verifiedworkflows/mcp-server
+```
+
+## Claude Desktop
+
+Add to `~/.claude/claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "verifiedworkflows": {
+      "command": "npx",
+      "args": ["-y", "@verifiedworkflows/mcp-server"],
+      "env": {
+        "VW_API_KEY": "vw_live_xxx"
+      }
+    }
+  }
+}
+```
+
+## Cursor / Windsurf / Continue
+
+Same config pattern — add the `verifiedworkflows` server to your MCP settings.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `submit_review` | Submit AI output for certified human review |
+| `get_review_status` | Check task status |
+| `get_review_result` | Get verified result with corrections and HMAC signature |
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+
+/**
+ * Verified Workflows MCP Server
+ * ==============================
+ * Exposes human-in-the-loop review as MCP tools.
+ *
+ * Usage:
+ *   export VW_API_KEY="vw_live_xxx"
+ *   npx @verifiedworkflows/mcp-server
+ *
+ * Or in Claude Desktop config:
+ *   "mcpServers": {
+ *     "verifiedworkflows": {
+ *       "command": "npx",
+ *       "args": ["-y", "@verifiedworkflows/mcp-server"],
+ *       "env": { "VW_API_KEY": "vw_live_xxx" }
+ *     }
+ *   }
+ */
+
+const API_KEY = process.env.VW_API_KEY || "";
+const BASE_URL = process.env.VW_BASE_URL || "https://api.verifiedworkflows.com";
+
+const TOOLS = [
+  {
+    name: "submit_review",
+    description:
+      "Submit AI-generated content for certified human review. " +
+      "Use this BEFORE sending AI output to users. Returns a task ID — " +
+      "the verified result arrives via webhook (typically <24h).",
+    inputSchema: {
+      type: "object",
+      required: ["content"],
+      properties: {
+        content: { type: "string", description: "The AI-generated content to review" },
+        review_type: {
+          type: "string",
+          enum: ["text-qa", "medical", "code-review", "translation", "fact-check", "decision-approval", "audio-audit", "data-extraction"],
+          default: "text-qa",
+          description: "Type of review needed",
+        },
+        priority: {
+          type: "string",
+          enum: ["standard", "express"],
+          default: "standard",
+          description: "Standard (24h) or Express (1-4h, 3x cost)",
+        },
+        instructions: { type: "string", default: "", description: "What the reviewer should check" },
+      },
+    },
+  },
+  {
+    name: "get_review_status",
+    description: "Check the status of a submitted review task.",
+    inputSchema: {
+      type: "object",
+      required: ["task_id"],
+      properties: {
+        task_id: { type: "string", description: "Task ID (e.g. tsk_live_f8a29)" },
+      },
+    },
+  },
+  {
+    name: "get_review_result",
+    description:
+      "Get the verified result of a completed review, including corrections, " +
+      "reviewer info, and HMAC signature. Only returns data if completed.",
+    inputSchema: {
+      type: "object",
+      required: ["task_id"],
+      properties: {
+        task_id: { type: "string", description: "Task ID (e.g. tsk_live_f8a29)" },
+      },
+    },
+  },
+];
+
+async function apiCall(method, path, body) {
+  const opts = {
+    method,
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+    },
+  };
+  if (body) opts.body = JSON.stringify(body);
+
+  const resp = await fetch(`${BASE_URL}${path}`, opts);
+  const text = await resp.text();
+
+  if (!resp.ok) {
+    throw new Error(`API error ${resp.status}: ${text}`);
+  }
+
+  return text ? JSON.parse(text) : {};
+}
+
+async function handleTool(name, args) {
+  if (!API_KEY) {
+    return {
+      content: [{
+        type: "text",
+        text: "Error: VW_API_KEY not set. Get your key at https://verifiedworkflows.com and set: export VW_API_KEY=vw_live_xxx",
+      }],
+    };
+  }
+
+  try {
+    if (name === "submit_review") {
+      const { content, review_type = "text-qa", priority = "standard", instructions = "" } = args;
+      const result = await apiCall("POST", "/v1/tasks", {
+        type: review_type,
+        priority,
+        title: content.length > 60 ? content.slice(0, 60) + "..." : content,
+        instructions: instructions || `Review this ${review_type} output for accuracy and safety.`,
+        payload: { content },
+      });
+
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            task_id: result.id,
+            status: result.status || "pending",
+            estimated_turnaround: priority === "express" ? "1-4h" : "24h",
+            message: `Submitted for review. Task ID: ${result.id}.`,
+          }, null, 2),
+        }],
+      };
+    }
+
+    if (name === "get_review_status") {
+      const result = await apiCall("GET", `/v1/tasks/${args.task_id}`);
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            task_id: result.id,
+            status: result.status,
+            age_sec: result.age_sec,
+            type: result.type,
+            has_result: result.result !== null,
+          }, null, 2),
+        }],
+      };
+    }
+
+    if (name === "get_review_result") {
+      const result = await apiCall("GET", `/v1/tasks/${args.task_id}`);
+
+      if (result.status !== "completed") {
+        return {
+          content: [{
+            type: "text",
+            text: `Task ${args.task_id} status: ${result.status}. Not completed yet.`,
+          }],
+        };
+      }
+
+      const review = result.result || {};
+      return {
+        content: [{
+          type: "text",
+          text: JSON.stringify({
+            task_id: result.id,
+            verified_body: review.body,
+            corrections: review.corrections || [],
+            reviewer_id: review.reviewer_id,
+            hmac_signature: review.hmac_signature,
+          }, null, 2),
+        }],
+      };
+    }
+
+    return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+  }
+}
+
+async function main() {
+  process.stderr.write(
+    API_KEY
+      ? "[verifiedworkflows] MCP server started\n"
+      : "[verifiedworkflows] WARNING: VW_API_KEY not set\n"
+  );
+
+  process.stdin.setEncoding("utf8");
+
+  let buffer = "";
+
+  process.stdin.on("data", (chunk) => {
+    buffer += chunk;
+
+    let newlineIdx;
+    while ((newlineIdx = buffer.indexOf("\n")) !== -1) {
+      const line = buffer.slice(0, newlineIdx);
+      buffer = buffer.slice(newlineIdx + 1);
+
+      if (!line.trim()) continue;
+
+      try {
+        const msg = JSON.parse(line);
+        handleLine(msg);
+      } catch (e) {
+        // ignore parse errors
+      }
+    }
+  });
+
+  process.stdin.on("end", () => {
+    process.exit(0);
+  });
+
+  async function handleLine(msg) {
+    const { id, method, params } = msg;
+
+    if (method === "initialize") {
+      send(id, {
+        protocolVersion: "2024-11-05",
+        capabilities: { tools: {} },
+        serverInfo: { name: "verifiedworkflows", version: "0.1.0" },
+      });
+    } else if (method === "notifications/initialized") {
+      // no response needed
+    } else if (method === "tools/list") {
+      send(id, { tools: TOOLS });
+    } else if (method === "tools/call") {
+      const result = await handleTool(params.name, params.arguments || {});
+      send(id, { content: result.content, isError: false });
+    } else if (method === "ping") {
+      send(id, {});
+    }
+  }
+
+  function send(id, result) {
+    process.stdout.write(JSON.stringify({ jsonrpc: "2.0", id, result }) + "\n");
+  }
+}
+
+main().catch((e) => {
+  process.stderr.write(`[verifiedworkflows] Fatal: ${e.message}\n`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "verifiedworkflows-mcp-server",
+  "version": "0.1.0",
+  "description": "MCP server for Verified Workflows — human-in-the-loop review as AI agent tools",
+  "license": "MIT",
+  "homepage": "https://verifiedworkflows.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/verifiedworkflows/mcp-server.git"
+  },
+  "bin": {
+    "verifiedworkflows-mcp": "index.js",
+    "vw-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "human-in-the-loop",
+    "ai-review",
+    "claude",
+    "cursor",
+    "windsurf"
+  ],
+  "author": {
+    "name": "Verified Workflows",
+    "email": "hello@verifiedworkflows.com"
+  }
+}