@otskit/mcp 0.4.3 → 0.6.0

package/README.md

@@ -58,6 +58,8 @@ Each command writes the MCP entry into the agent's config file, makes a `.bak` b
 | `inspect_timestamp` | Inspect a stored proof file without network calls |
 | `list_pending` | List stamps with status, retry count, and filters |
 | `watch` | Open a terminal window monitoring pending stamps in real-time |
+| `hash_file` | Compute the SHA-256 of a local file and return it as a 64-char hex string (no network calls) |
+| `stamp_file` | Compute SHA-256 of a local file and stamp it on Bitcoin in one step |
 
 ## Data directory
 

package/dist/index.js

@@ -20,7 +20,7 @@ Commands:
 }
 switch (command) {
   case "serve": {
-    const { runServer } = await import("./server-IDRHOKL7.js");
+    const { runServer } = await import("./server-NNUGQ5WQ.js");
     await runServer();
     break;
   }

package/dist/{server-IDRHOKL7.js → server-NNUGQ5WQ.js}

@@ -71,6 +71,29 @@ function openWatchWindow(intervalMinutes = 5) {
   return { opened: true, interval_minutes: minutes, ...errorMsg ? { error: errorMsg } : {} };
 }
 
+// src/tools/stamp-file.ts
+import { readFileSync as readFileSync2 } from "fs";
+import { OpSHA256 } from "@otskit/core";
+async function stampFile(input, db, config) {
+  const data = new Uint8Array(readFileSync2(input.path));
+  const hash = Buffer.from(new OpSHA256().hash(data)).toString("hex");
+  return createTimestamp({ hash }, db, config);
+}
+
+// src/tools/hash-file.ts
+import { hashFile } from "@otskit/client";
+async function hashFileTool(input) {
+  try {
+    const buf = await hashFile(input.path);
+    return { hash: buf.toString("hex") };
+  } catch (e) {
+    if (e?.code === "ENOENT") {
+      return { error: "file_not_found", details: `File not found: ${input.path}` };
+    }
+    throw e;
+  }
+}
+
 // src/tool-definitions.ts
 var TOOL_DEFINITIONS = [
   {
@@ -152,6 +175,36 @@ var TOOL_DEFINITIONS = [
       openWorldHint: false
     }
   },
+  {
+    name: "hash_file",
+    description: "Computes the SHA-256 hash of a local file and returns it as a 64-character hex string. No network calls \u2014 pure local operation.",
+    inputSchema: {
+      type: "object",
+      properties: { path: { type: "string", description: "Absolute path to the file" } },
+      required: ["path"]
+    },
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
+    }
+  },
+  {
+    name: "stamp_file",
+    description: "Stamps a file against public OpenTimestamps calendars. Computes SHA-256 of the file and stamps it on Bitcoin. IMPORTANT: the digest is sent to external calendar servers (alice.btc, bob.btc, finney, catallaxy).",
+    inputSchema: {
+      type: "object",
+      properties: { path: { type: "string", description: "Absolute path to the file to stamp" } },
+      required: ["path"]
+    },
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
+    }
+  },
   {
     name: "watch",
     description: "Opens a new terminal window that monitors pending stamps in real-time, polling at the given interval. The window stays open so the user can watch progress.",
@@ -201,6 +254,12 @@ async function runServer() {
         case "list_pending":
           result = listPending(args, db, config);
           break;
+        case "hash_file":
+          result = await hashFileTool(args);
+          break;
+        case "stamp_file":
+          result = await stampFile(args, db, config);
+          break;
         case "watch":
           result = openWatchWindow(args?.interval_minutes);
           break;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@otskit/mcp",
   "mcpName": "io.github.AlexAlves87/otskit-mcp",
-  "version": "0.4.3",
+  "version": "0.6.0",
   "license": "MIT",
   "description": "OpenTimestamps MCP server — stamp, upgrade, verify via AI agents",
   "repository": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@otskit/client": "^0.1.1",
+    "@otskit/client": "^0.2.0",
     "@otskit/core": "^0.1.0",
     "better-sqlite3": "^12.10.0"
   },