@otskit/mcp 0.7.0 → 0.7.1

package/README.md

@@ -11,7 +11,7 @@
 [![Node >=20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![Glama](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP/badges/score.svg)](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP)
-[![OTSkit-MCP MCP server](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP/badges/card.svg)](https://glama.ai/mcp/servers/OTSkit/OTSkit-MCP)
+[![smithery badge](https://smithery.ai/badge/otskit/otskit-mcp)](https://smithery.ai/servers/otskit/otskit-mcp)
 
 OpenTimestamps MCP server - stamp, upgrade, and verify Bitcoin timestamps via AI agents.
 

package/dist/{chunk-ZQUFY5MM.js → chunk-4S4MSBQL.js}

@@ -132,7 +132,7 @@ function reconcileOrphans(db) {
 // src/tools/upgrade-timestamp.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { OpenTimestampsClient, UpgradeError } from "@otskit/client";
-import { DetachedTimestampFile, StreamDeserializationContext } from "@otskit/core";
+import { DetachedTimestampFile } from "@otskit/core";
 
 // src/db/stamps.ts
 function insertStamp(db, params) {
@@ -219,8 +219,7 @@ function collectAttestations(ts) {
 }
 function checkBitcoinConfirmation(bytes) {
   try {
-    const ctx = new StreamDeserializationContext(new Uint8Array(bytes));
-    const dtf = DetachedTimestampFile.deserialize(ctx);
+    const dtf = DetachedTimestampFile.deserialize(new Uint8Array(bytes));
     const attestations = collectAttestations(dtf.timestamp);
     const bitcoinAtts = attestations.filter((a) => a.kind === "bitcoin");
     if (bitcoinAtts.length === 0) return { confirmed: false };
@@ -252,6 +251,20 @@ async function upgradeTimestamp(input, db, config) {
     upgraded = await client.upgrade(proofBefore);
   } catch (e) {
     if (e instanceof UpgradeError) {
+      const { confirmed: confirmed2, block: block2 } = checkBitcoinConfirmation(proofBefore);
+      if (confirmed2 && block2 !== void 0) {
+        const bitcoinTime = now;
+        updateStampStatus(db, input.id, {
+          status: "confirmed",
+          bitcoin_block: block2,
+          bitcoin_time: bitcoinTime,
+          confirmed_at: now,
+          last_attempt_at: now,
+          attempt_count: newAttemptCount
+        });
+        logOperation(db, { stamp_id: input.id, action: "upgrade", result: "success" });
+        return { id: input.id, status: "confirmed", bitcoin_block: block2, bitcoin_time: bitcoinTime, proof_path: record.proof_path };
+      }
       updateStampStatus(db, input.id, { last_attempt_at: now, attempt_count: newAttemptCount, next_retry_at: next });
       logOperation(db, { stamp_id: input.id, action: "upgrade", result: "pending" });
       return { id: input.id, status: "pending", attempt_count: newAttemptCount, last_attempt_at: now, next_retry_at: next };

package/dist/{chunk-V4ONBNWS.js → chunk-KVHJHTFL.js}

@@ -4,7 +4,7 @@ import {
   insertStamp,
   listStamps,
   logOperation
-} from "./chunk-ZQUFY5MM.js";
+} from "./chunk-4S4MSBQL.js";
 import {
   writeAtomic
 } from "./chunk-YFSUDT24.js";

package/dist/{chunk-KSFL3INC.js → chunk-XG7NDZR3.js}

@@ -2,7 +2,7 @@ import {
   getDb,
   loadConfig,
   upgradeTimestamp
-} from "./chunk-ZQUFY5MM.js";
+} from "./chunk-4S4MSBQL.js";
 
 // src/tools/watch.ts
 var DEFAULT_WATCH_INTERVAL_MINUTES = 30;

package/dist/{cli-MR24FO2T.js → cli-WOUUWARK.js}

@@ -2,13 +2,13 @@ import {
   createTimestamp,
   listPending,
   verifyTimestamp
-} from "./chunk-V4ONBNWS.js";
+} from "./chunk-KVHJHTFL.js";
 import {
   backupDb,
   getDb,
   loadConfig,
   upgradeTimestamp
-} from "./chunk-ZQUFY5MM.js";
+} from "./chunk-4S4MSBQL.js";
 import "./chunk-YFSUDT24.js";
 
 // src/cli.ts

package/dist/index.js

@@ -20,7 +20,7 @@ Commands:
 }
 switch (command) {
   case "serve": {
-    const { runServer } = await import("./server-6HE6K337.js");
+    const { runServer } = await import("./server-NDG4QZ56.js");
     await runServer();
     break;
   }
@@ -49,7 +49,7 @@ switch (command) {
     break;
   }
   case "watch": {
-    const { normalizeWatchInterval, watchPending } = await import("./watch-JQ6XJCXF.js");
+    const { normalizeWatchInterval, watchPending } = await import("./watch-TQR2L42L.js");
     const parsed = args[0] ? parseInt(args[0], 10) : NaN;
     const interval = normalizeWatchInterval(isNaN(parsed) ? void 0 : parsed);
     if (args[0] && (isNaN(parsed) || parsed < 15))
@@ -65,7 +65,7 @@ switch (command) {
   case "check-pending":
   case "backup":
   case "scheduler": {
-    const { runCli } = await import("./cli-MR24FO2T.js");
+    const { runCli } = await import("./cli-WOUUWARK.js");
     await runCli(command, args);
     break;
   }

package/dist/{server-6HE6K337.js → server-NDG4QZ56.js}

@@ -2,16 +2,16 @@ import {
   createTimestamp,
   listPending,
   verifyTimestamp
-} from "./chunk-V4ONBNWS.js";
+} from "./chunk-KVHJHTFL.js";
 import {
   normalizeWatchInterval
-} from "./chunk-KSFL3INC.js";
+} from "./chunk-XG7NDZR3.js";
 import {
   getDb,
   getStamp,
   loadConfig,
   upgradeTimestamp
-} from "./chunk-ZQUFY5MM.js";
+} from "./chunk-4S4MSBQL.js";
 import "./chunk-YFSUDT24.js";
 
 // src/server.ts
@@ -101,7 +101,7 @@ async function hashFileTool(input) {
 var TOOL_DEFINITIONS = [
   {
     name: "create_timestamp",
-    description: "Stamps a SHA-256 hash against public OpenTimestamps calendars. IMPORTANT: the digest is sent to external calendar servers (alice.btc, bob.btc, finney, catallaxy).",
+    description: "Creates a verifiable Bitcoin timestamp for a SHA-256 hash using the OpenTimestamps protocol. Submits the hash to four public OTS calendars (alice.btc, bob.btc, finney, catallaxy) and stores a pending proof locally. Returns a stamp ID to track confirmation status. Confirmation typically takes ~60 minutes but can take several hours during network congestion.",
     inputSchema: {
       type: "object",
       properties: { hash: { type: "string", description: "SHA-256 hex digest (64 chars)" } },
@@ -116,7 +116,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "upgrade_timestamp",
-    description: "Checks if a pending stamp has been confirmed in Bitcoin. Use the id returned by create_timestamp.",
+    description: "Attempts to upgrade a pending OpenTimestamps proof by fetching the latest merkle tree from the calendars. If Bitcoin has included the timestamp, the proof becomes confirmed and the bitcoin_block is recorded. Safe to call repeatedly \u2014 if not yet confirmed, it schedules the next retry automatically.",
     inputSchema: {
       type: "object",
       properties: { id: { type: "string", description: "UUID from the stamp record" } },
@@ -131,7 +131,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "verify_timestamp",
-    description: "Verifies a stamp against Bitcoin. Does NOT affirm document authorship or truth \u2014 only proves the hash existed before a given Bitcoin block.",
+    description: "Verifies a timestamp proof against the Bitcoin blockchain via an Esplora API. Proves that a specific hash existed before a given Bitcoin block height. Does NOT affirm document authorship, content truth, or legal validity \u2014 it only provides a cryptographic proof of existence at a point in time.",
     inputSchema: {
       type: "object",
       properties: { id: { type: "string", description: "UUID from the stamp record" } },
@@ -146,7 +146,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "inspect_timestamp",
-    description: "Inspects a stored proof file without network calls. Returns calendar_attestations (promises from OTS servers, NOT Bitcoin confirmation) and bitcoin_attestations (actual Bitcoin blocks). A stamp is only truly confirmed when bitcoin_attestations > 0 and bitcoin_confirmed is true.",
+    description: "Reads a stored proof file from disk without any network calls. Returns proof metadata including size, number of calendar attestations (pending promises from OTS servers) and Bitcoin attestations (actual confirmed blocks). A stamp is only truly confirmed when bitcoin_attestations > 0 and bitcoin_confirmed is true \u2014 calendar_attestations alone do not prove Bitcoin confirmation.",
     inputSchema: {
       type: "object",
       properties: { id: { type: "string", description: "UUID from the stamp record" } },
@@ -161,7 +161,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "list_pending",
-    description: "Lists stamp records with status and retry info.",
+    description: "Lists stamp records from the local database with their current status, retry count, and next scheduled upgrade time. Filter by status (pending, confirmed, failed), page through results, or find stamps older than N hours. Use this to monitor the state of all timestamped hashes.",
     inputSchema: {
       type: "object",
       properties: {
@@ -180,7 +180,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     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.",
+    description: "Computes the SHA-256 hash of a local file and returns it as a 64-character hex string. Purely local \u2014 no network calls, no data stored. Use this to get the hash before calling create_timestamp, or to verify the integrity of a file independently.",
     inputSchema: {
       type: "object",
       properties: { path: { type: "string", description: "Absolute path to the file" } },
@@ -195,7 +195,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     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).",
+    description: "Convenience tool that hashes a local file and stamps it on Bitcoin in one step. Computes the SHA-256 of the file, then submits it to four public OTS calendars. The file contents are never sent externally \u2014 only the hash is. Returns a stamp ID for tracking confirmation.",
     inputSchema: {
       type: "object",
       properties: { path: { type: "string", description: "Absolute path to the file to stamp" } },
@@ -210,7 +210,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     name: "watch",
-    description: "Opens a new terminal window that monitors pending stamps and attempts due upgrades at a safe interval. The window stays open so the user can watch progress.",
+    description: "Opens a new terminal window that continuously monitors pending stamps and attempts due upgrades at each interval. Useful for long-running monitoring sessions after stamping. The window remains open so the user can watch confirmation progress in real time. Minimum interval is 15 minutes to avoid hammering OTS calendars.",
     inputSchema: {
       type: "object",
       properties: {

package/dist/{watch-JQ6XJCXF.js → watch-TQR2L42L.js}

@@ -1,8 +1,8 @@
 import {
   normalizeWatchInterval,
   watchPending
-} from "./chunk-KSFL3INC.js";
-import "./chunk-ZQUFY5MM.js";
+} from "./chunk-XG7NDZR3.js";
+import "./chunk-4S4MSBQL.js";
 import "./chunk-YFSUDT24.js";
 export {
   normalizeWatchInterval,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@otskit/mcp",
   "mcpName": "io.github.AlexAlves87/otskit-mcp",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "license": "MIT",
   "description": "OpenTimestamps MCP server — stamp, upgrade, verify via AI agents",
   "repository": {