@rel-time/mcp-server 1.2.9 → 1.2.11

package/README.md

@@ -6,7 +6,7 @@ Official Model Context Protocol (MCP) server for **[Rel-Time](https://rel-time.c
 3. **Anchor SHA-256 hashes to the Bitcoin Timechain & Rel-Time VDF** (`POST /v1/anchor`).
 4. **Generate & overlay 64-ray Sun-Stamps onto PDFs and Images** (`reltime-stamped-<name>.pdf` / `.png`).
 5. **Verify Bitcoin block settlement & Merkle proofs** (`GET /v1/proof/{hash}`).
-6. **Self-provision or Reload all 4 Rel-Time Tiers via Bitcoin Lightning or Stripe Card** (`Universal Anchor $3`, `Agent Launch Pack $5 / 50`, `Autonomous Agents $50 / 500`, and `Rel-Time Superhighway $600 / 5,000`).
+6. **Self-provision or Reload all 4 Rel-Time Tiers via Bitcoin Lightning or Stripe Card** (`Universal Anchor $3`, `Agent Launch Pack $5 / 25`, `Autonomous Agents $50 / 500`, and `Rel-Time Superhighway $399 / 5,000`).
 7. **Run a Superhighway Cryptographic Audit Trail & Local Folder Integrity Check** (`reltime_audit_trail`), generating an interactive HTML Audit Dashboard with Corporate Hardware Passkey (`signer_public_key`) attribution and Bitcoin block verification.
 
 ---
@@ -28,9 +28,9 @@ Add the following to your `.mcp.json`, `claude_desktop_config.json`, or `.cursor
 
 When you start a fresh chat and ask to anchor a file or provision a key, `@rel-time/mcp-server` automatically prompts your agent to ask which tier and payment method (**Bitcoin Lightning** or **Stripe Card**) you want first:
 1. **Universal Anchor (`pack: "universal"`, `$3 / anchor`):** Priority 10-Minute Bitcoin Queue · Standard Mode (Data Integrity + Biometric or Anonymous).
-2. **Agent Launch Pack (`pack: "launch"`, `$5 / 50 Hashes`):** Priority 10-Minute Bitcoin Queue · Standard Mode · Includes 64-Ray Sun-Stamp, 1-Click Stamped Copy (`.PDF`/`.PNG`), and `.JSON` Doomsday Proof.
+2. **Agent Launch Pack (`pack: "launch"`, `$5 / 25 Hashes`, max 3 per key):** Priority 10-Minute Bitcoin Queue · Standard Mode · Includes 64-Ray Sun-Stamp, 1-Click Stamped Copy (`.PDF`/`.PNG`), 4-Plate Certificate, and `.JSON` Doomsday Proof.
 3. **Autonomous Agents (`pack: "standard"`, `$50 / 500 Hashes`):** Dynamic 6-Hour Batch Queue · Supports both Temporal Mode (`T_index` sub-second VDF sequencing) and Standard Mode · Reloadable anytime (`+500` credits / `$50`).
-4. **Rel-Time Superhighway (`pack: "enterprise"`, `$600 / 5,000 Hashes`):** Priority 10-Minute Bitcoin Queue · Temporal Mode (`T_index`) + Standard Mode + Bulk Folder & Superhighway Audit Dashboard.
+4. **Rel-Time Superhighway (`pack: "enterprise"`, `$399 / 5,000 Hashes`):** Priority 10-Minute Bitcoin Queue · Temporal Mode (`T_index`) + Standard Mode + Data Integrity Audit & Instant Tamper Detection.
 
 Once paid via Lightning or Stripe (or if you pass an existing `rel_key_...` key), the MCP server automatically saves your API key to `~/.reltime/api_key.json` (`0600` permissions) — no app restart or `.zshrc` edits required.
 
@@ -48,4 +48,4 @@ Once paid via Lightning or Stripe (or if you pass an existing `rel_key_...` key)
 | `reltime_get_sun_stamp` | **No** | Fetches the deterministic 64-ray SVG Sun-Stamp (`GET /v1/stamp/{hash}`) and returns ready-to-paste Markdown/HTML badge snippets. |
 | `reltime_check_proof` | **No** | Queries `GET /v1/proof/{hash}` for Bitcoin TXID, Block Height, UTC Timestamp, and Merkle inclusion path, and optionally saves/updates the `.json` Doomsday Proof receipt on disk. |
 | `reltime_account_status` | Yes | Checks remaining Hash Credits and tier status (`GET /v1/account`). |
-| `reltime_provision_agent_key` | **No** | Provisions or reloads any of the 4 Rel-Time Tiers (`universal` `$3`, `launch` `$5/50`, `standard` `$50/500`, `enterprise` `$600/5,000`) via **Bitcoin Lightning** or **Stripe Card**. |
+| `reltime_provision_agent_key` | **No** | Provisions or reloads any of the 4 Rel-Time Tiers (`universal` `$3`, `launch` `$5/25`, `standard` `$50/500`, `enterprise` `$399/5,000`) via **Bitcoin Lightning** or **Stripe Card**. |

package/index.js

@@ -56,7 +56,7 @@ let LAST_INVOICE_PACK = null;
 
 const SERVER_INFO = {
   name: "rel-time-mcp-server",
-  version: "1.2.9",
+  version: "1.2.11",
 };
 
 /**
@@ -135,13 +135,13 @@ function buildPackSelectionPrompt(contextMessage) {
       },
       {
         pack: "launch",
-        name: "2. Agent Launch Pack ($5 / 50 Hashes)",
+        name: "2. Agent Launch Pack ($5 / 25 Hashes)",
         price_usd: "$5.00",
-        credits: 50,
+        credits: 25,
         settlement_queue: "Priority 10-Minute Bitcoin Queue",
-        hashing_modes: "Standard Mode only (Data Integrity + Biometric or Anonymous)",
+        hashing_modes: "Standard Mode only (Data Integrity + Biometric or Anonymous · Max 3 packs per key)",
         payment_methods: ["lightning", "stripe"],
-        outputs: "64-Ray Sun-Stamp SVG + 1-Click Stamped Copy (.PDF/.PNG) + .JSON Doomsday Proof",
+        outputs: "64-Ray Sun-Stamp SVG + 1-Click Stamped Copy (.PDF/.PNG) + 4-Plate Certificate + .JSON Doomsday Proof",
       },
       {
         pack: "standard",
@@ -152,21 +152,21 @@ function buildPackSelectionPrompt(contextMessage) {
         hashing_modes: "Temporal Mode (T_index sub-second VDF sequencing) + Standard Mode (Biometric or Anonymous)",
         payment_methods: ["lightning", "stripe"],
         outputs:
-          "64-Ray Sun-Stamp SVG + 1-Click Stamped Copy (.PDF/.PNG) + .JSON Doomsday Proof + Reloadable anytime (+500 credits / $50)",
+          "64-Ray Sun-Stamp SVG + 1-Click Stamped Copy (.PDF/.PNG) + 4-Plate Certificate + .JSON Doomsday Proof + Reloadable anytime (+500 credits / $50)",
       },
       {
         pack: "enterprise",
-        name: "4. Rel-Time Superhighway ($600 / 5,000 Hashes)",
-        price_usd: "$600.00",
+        name: "4. Rel-Time Superhighway ($399 / 5,000 Hashes)",
+        price_usd: "$399.00",
         credits: 5000,
         settlement_queue: "Priority 10-Minute Bitcoin Queue",
-        hashing_modes: "Temporal Mode (T_index) + Standard Mode + Bulk Folder & Superhighway Dashboard",
+        hashing_modes: "Temporal Mode (T_index) + Standard Mode + Data Integrity Audit & Instant Tamper Detection",
         payment_methods: ["lightning", "stripe"],
-        outputs: "64-Ray Sun-Stamp SVG + 1-Click Stamped Copy (.PDF/.PNG) + Certificate, HTML & .JSON Proof",
+        outputs: "64-Ray Sun-Stamp SVG + 1-Click Stamped Copy (.PDF/.PNG) + 4-Plate Certificate + Forensic Audit Report + .JSON Proof",
       },
     ],
     next_step:
-      "Ask the user which tier (`universal` $3, `launch` $5/50, `standard` $50/500, or `enterprise` $600/5,000) and which payment method (`lightning` or `stripe`) they prefer, then call `reltime_provision_agent_key({ action: 'create_invoice', pack, payment_method })`.",
+      "Ask the user which tier (`universal` $3, `launch` $5/25, `standard` $50/500, or `enterprise` $399/5,000) and which payment method (`lightning` or `stripe`) they prefer, then call `reltime_provision_agent_key({ action: 'create_invoice', pack, payment_method })`.",
   };
 }
 
@@ -1527,11 +1527,545 @@ function generateAuditReportHtml(audit) {
 </html>`;
 }
 
+function inferMimeTypeFromFileName(fileName) {
+  if (!fileName || fileName === "Zero-Knowledge Hash Payload") {
+    return "application/octet-stream (Zero-Knowledge)";
+  }
+  const lower = String(fileName).toLowerCase();
+  if (lower.endsWith(".pdf")) return "application/pdf";
+  if (lower.endsWith(".png")) return "image/png";
+  if (lower.endsWith(".jpg") || lower.endsWith(".jpeg")) return "image/jpeg";
+  if (lower.endsWith(".webp")) return "image/webp";
+  if (lower.endsWith(".svg")) return "image/svg+xml";
+  if (lower.endsWith(".json")) return "application/json";
+  if (lower.endsWith(".csv")) return "text/csv";
+  if (lower.endsWith(".txt") || lower.endsWith(".md")) return "text/plain";
+  if (lower.endsWith(".mp4")) return "video/mp4";
+  if (lower.endsWith(".mp3")) return "audio/mpeg";
+  if (lower.endsWith(".wav")) return "audio/wav";
+  if (lower.endsWith(".zip")) return "application/zip";
+  return "application/octet-stream";
+}
+
+function generateProvenanceCertificateHtml(input = {}) {
+  const fileName = escapeHtml(input.fileName || "Zero-Knowledge Hash Payload");
+  const fileSize = escapeHtml(input.fileSize || "Zero-Knowledge (32-Byte Digest)");
+  const mimeType = escapeHtml(input.mimeType || inferMimeTypeFromFileName(input.fileName));
+
+  const originalHash = escapeHtml(String(input.originalFileHash || input.attestedHash || "").toLowerCase());
+  const attestedHash = escapeHtml(String(input.attestedHash || input.originalFileHash || "").toLowerCase());
+  const signerPubKey = input.signerPublicKey ? escapeHtml(String(input.signerPublicKey)) : null;
+
+  const isStandard = String(input.anchorMode || "standard").toLowerCase() === "standard";
+  const modeLabel = isStandard
+    ? "MODE: STANDARD (DATA INTEGRITY)"
+    : "MODE: TEMPORAL (VDF SEQUENCE)";
+
+  const tIndex = escapeHtml(String(input.tIndex || "PENDING VDF SNAPSHOT"));
+  const formattedTicks =
+    typeof input.vdfTicks === "number"
+      ? `${input.vdfTicks.toLocaleString()} Ticks`
+      : escapeHtml(String(input.vdfTicks || "0 Ticks"));
+
+  const isSettled = input.status === "settled" || Boolean(input.blockHeight);
+  const blockHeightDisplay = input.blockHeight
+    ? `#${Number(input.blockHeight).toLocaleString()}`
+    : "PENDING NEXT BITCOIN BLOCK";
+  const blockTimeDisplay = escapeHtml(
+    input.blockTimeUtc || (isSettled ? "CONFIRMED ON BITCOIN MAINNET" : "PENDING BLOCK HEADER UTC")
+  );
+  const merkleProofDisplay =
+    typeof input.merkleProofCount === "number" && input.merkleProofCount > 0
+      ? `[ ${input.merkleProofCount} SIBLING HASHES ]`
+      : isSettled
+      ? "[ INCLUDED IN MERKLE ROOT ]"
+      : "PENDING";
+  const txidDisplay = escapeHtml(String(input.txid || "PENDING NEXT BITCOIN BLOCK"));
+  const finalityValueClass = isSettled ? "data-value green" : "data-value orange";
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=5.0">
+    <title>Rel-Time Sovereign Provenance Certificate - ${fileName}</title>
+    <style>
+        * { box-sizing: border-box; }
+        :root {
+            --bg-body: #050507;
+            --bg-monument: linear-gradient(180deg, #181a20 0%, #0d0e12 50%, #08090c 100%);
+            --border-monument: #3f3f46;
+            --monument-shadow: inset 0 1px 0 rgba(255,255,255,0.15), 0 30px 70px rgba(0,0,0,0.95);
+            --bg-plate: rgba(0, 0, 0, 0.45);
+            --border-plate: #27272a;
+            --plate-title: #d4d4d8;
+            --text-label: #71717a;
+            --text-value: #f4f4f5;
+            --bg-value: #050507;
+            --border-value: #27272a;
+            --accent-orange: #fb923c;
+            --accent-green: #4ade80;
+            --accent-cyan: #22d3ee;
+            --anchored-box-bg: rgba(251, 146, 60, 0.06);
+            --anchored-box-border: rgba(251, 146, 60, 0.65);
+            --anchored-badge-bg: rgba(251, 146, 60, 0.15);
+            --mode-pill-bg: #18181b;
+            --mode-pill-border: #52525b;
+            --mode-pill-color: #f4f4f5;
+            --theme-btn-bg: #27272a;
+            --theme-btn-border: #52525b;
+            --theme-btn-color: #f4f4f5;
+            --solar-shadow: drop-shadow(0 0 25px rgba(255, 95, 31, 0.45));
+        }
+
+        body.light-mode {
+            --bg-body: #e4e4e7;
+            --bg-monument: #ffffff;
+            --border-monument: #cbd5e1;
+            --monument-shadow: 0 20px 45px rgba(0,0,0,0.08), 0 1px 3px rgba(0,0,0,0.05);
+            --bg-plate: #f8fafc;
+            --border-plate: #e2e8f0;
+            --plate-title: #0f172a;
+            --text-label: #64748b;
+            --text-value: #09090b;
+            --bg-value: #ffffff;
+            --border-value: #cbd5e1;
+            --accent-orange: #ea580c;
+            --accent-green: #15803d;
+            --accent-cyan: #0891b2;
+            --anchored-box-bg: rgba(234, 88, 12, 0.08);
+            --anchored-box-border: rgba(234, 88, 12, 0.75);
+            --anchored-badge-bg: rgba(234, 88, 12, 0.12);
+            --mode-pill-bg: #f1f5f9;
+            --mode-pill-border: #cbd5e1;
+            --mode-pill-color: #0f172a;
+            --theme-btn-bg: #f1f5f9;
+            --theme-btn-border: #cbd5e1;
+            --theme-btn-color: #0f172a;
+            --solar-shadow: drop-shadow(0 0 20px rgba(234, 88, 12, 0.3));
+        }
+
+        body {
+            background-color: var(--bg-body);
+            color: var(--text-value);
+            font-family: 'Fira Code', 'SFMono-Regular', Consolas, Menlo, monospace;
+            margin: 0;
+            padding: 2rem 1rem;
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            transition: background-color 0.3s ease, color 0.3s ease;
+            min-height: 100vh;
+            overflow-x: hidden;
+            width: 100%;
+        }
+
+        .monument {
+            max-width: 960px;
+            width: 100%;
+            background: var(--bg-monument);
+            border: 2px solid var(--border-monument);
+            box-shadow: var(--monument-shadow);
+            border-radius: 6px;
+            padding: 2.5rem;
+            position: relative;
+            transition: all 0.3s ease;
+        }
+
+        .header-bar {
+            display: flex;
+            justify-content: space-between;
+            align-items: flex-start;
+            border-bottom: 2px solid var(--border-plate);
+            padding-bottom: 1.5rem;
+            margin-bottom: 2rem;
+            gap: 1.5rem;
+            flex-wrap: wrap;
+        }
+
+        .brand-group { display: flex; flex-direction: column; }
+        .brand-logo {
+            display: inline-flex;
+            align-items: center;
+            gap: 0.3rem;
+            font-size: 1.5rem;
+            font-weight: 800;
+            letter-spacing: 0.2em;
+            line-height: 1.2;
+        }
+        .logo-bracket { color: var(--accent-orange); font-weight: 900; }
+        .logo-text { color: var(--text-value); letter-spacing: 0.22em; }
+        .brand-sub {
+            margin: 0.45rem 0 0 0;
+            color: var(--text-label);
+            font-size: 0.68rem;
+            letter-spacing: 0.16em;
+            text-transform: uppercase;
+        }
+        .header-actions {
+            display: flex;
+            align-items: center;
+            gap: 0.75rem;
+            flex-wrap: wrap;
+        }
+        .mode-pill {
+            background: var(--mode-pill-bg);
+            border: 1px solid var(--mode-pill-border);
+            color: var(--mode-pill-color);
+            padding: 0.4rem 0.8rem;
+            font-size: 0.7rem;
+            letter-spacing: 0.15em;
+            text-transform: uppercase;
+            font-weight: 600;
+            border-radius: 4px;
+            white-space: nowrap;
+        }
+        .theme-btn {
+            background: var(--theme-btn-bg);
+            border: 1px solid var(--theme-btn-border);
+            color: var(--theme-btn-color);
+            padding: 0.4rem 0.8rem;
+            font-size: 0.7rem;
+            letter-spacing: 0.15em;
+            text-transform: uppercase;
+            font-weight: 700;
+            cursor: pointer;
+            border-radius: 4px;
+            transition: all 0.2s ease;
+            font-family: inherit;
+            display: inline-flex;
+            align-items: center;
+            gap: 0.35rem;
+        }
+        .theme-btn:hover {
+            border-color: var(--accent-orange);
+            color: var(--accent-orange);
+        }
+        .plate {
+            background: var(--bg-plate);
+            border: 1px solid var(--border-plate);
+            box-shadow: inset 0 2px 6px rgba(0,0,0,0.4);
+            padding: 1.5rem;
+            margin-bottom: 1.75rem;
+            border-radius: 4px;
+            transition: all 0.3s ease;
+        }
+        .plate-title {
+            color: var(--plate-title);
+            font-size: 0.75rem;
+            font-weight: bold;
+            letter-spacing: 0.2em;
+            border-bottom: 1px solid var(--border-plate);
+            padding-bottom: 0.6rem;
+            margin-bottom: 1.25rem;
+            text-transform: uppercase;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            flex-wrap: wrap;
+            gap: 0.5rem;
+        }
+        .plate-subtitle {
+            font-size: 0.65rem;
+            color: var(--text-label);
+            letter-spacing: 0.12em;
+        }
+        .data-row { margin-bottom: 1rem; }
+        .data-row:last-child { margin-bottom: 0; }
+        .data-label {
+            color: var(--text-label);
+            font-size: 0.68rem;
+            letter-spacing: 0.14em;
+            text-transform: uppercase;
+            margin-bottom: 0.35rem;
+            display: flex;
+            justify-content: space-between;
+            align-items: center;
+            flex-wrap: wrap;
+            gap: 0.4rem;
+        }
+        .data-value {
+            color: var(--text-value);
+            font-size: 0.82rem;
+            word-break: break-all;
+            background: var(--bg-value);
+            padding: 0.65rem 0.85rem;
+            border: 1px solid var(--border-value);
+            box-shadow: inset 0 1px 3px rgba(0,0,0,0.5);
+            border-radius: 2px;
+            line-height: 1.45;
+        }
+        .data-value.cyan { color: var(--accent-cyan); border-color: rgba(34, 211, 238, 0.3); }
+        .data-value.orange { color: var(--accent-orange); border-color: rgba(251, 146, 60, 0.3); }
+        .data-value.green { color: var(--accent-green); border-color: rgba(74, 222, 128, 0.35); }
+        .anchored-box {
+            color: var(--accent-orange) !important;
+            border: 1px solid var(--anchored-box-border) !important;
+            background: var(--anchored-box-bg) !important;
+            box-shadow: 0 0 18px rgba(251, 146, 60, 0.15), inset 0 1px 3px rgba(0,0,0,0.5) !important;
+            font-weight: 600;
+        }
+        .anchored-badge {
+            background: var(--anchored-badge-bg);
+            color: var(--accent-orange);
+            border: 1px solid var(--anchored-box-border);
+            padding: 0.2rem 0.55rem;
+            font-size: 0.62rem;
+            font-weight: bold;
+            letter-spacing: 0.12em;
+            border-radius: 3px;
+        }
+        .solar-vault {
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            text-align: center;
+            margin-bottom: 1.25rem;
+        }
+        .stamp-box {
+            width: 240px;
+            height: 240px;
+            margin: 0.5rem auto 1rem auto;
+            filter: var(--solar-shadow);
+            max-width: 100%;
+        }
+        .stamp-box svg { width: 100%; height: 100%; }
+        .grid-3 {
+            display: grid;
+            grid-template-columns: repeat(3, 1fr);
+            gap: 1rem;
+            margin-bottom: 1rem;
+        }
+        .grid-3:last-child { margin-bottom: 0; }
+        @media (max-width: 640px) {
+            body { padding: 0.5rem 0.35rem; }
+            .monument { padding: 1.25rem 0.85rem; border-width: 1px; }
+            .header-bar { flex-direction: column; align-items: flex-start; gap: 1rem; }
+            .grid-3 { grid-template-columns: 1fr; gap: 0.75rem; }
+            .stamp-box { width: 210px; height: 210px; }
+        }
+        @media print {
+            body { background: #ffffff !important; color: #000000 !important; padding: 0 !important; }
+            .theme-btn { display: none !important; }
+            .monument { border: 1px solid #cbd5e1 !important; box-shadow: none !important; background: #ffffff !important; padding: 1.5rem !important; max-width: 100% !important; }
+            .plate { background: #f8fafc !important; border: 1px solid #e2e8f0 !important; box-shadow: none !important; }
+            .data-value { background: #ffffff !important; border: 1px solid #cbd5e1 !important; color: #000000 !important; }
+        }
+    </style>
+    <script src="https://cdn.jsdelivr.net/npm/qrcode-generator@1.4.4/qrcode.min.js"></script>
+</head>
+<body>
+    <div class="monument">
+        <div class="header-bar">
+            <div class="brand-group">
+                <div class="brand-logo">
+                    <span class="logo-bracket">[</span>
+                    <span class="logo-text">REL-TIME</span>
+                    <span class="logo-bracket">]</span>
+                </div>
+                <p class="brand-sub">SOVEREIGN CRYPTOGRAPHIC PROVENANCE CERTIFICATE</p>
+            </div>
+            <div class="header-actions">
+                <div class="mode-pill">${modeLabel}</div>
+                <button class="theme-btn" onclick="window.print()" aria-label="Print or Save as PDF">🖨️ PRINT / PDF</button>
+                <button id="theme-toggle" class="theme-btn" onclick="toggleTheme()" aria-label="Toggle light or dark theme">☀️ LIGHT</button>
+            </div>
+        </div>
+
+        <div class="plate">
+            <div class="plate-title">
+                <span>Asset Identification</span>
+                <span class="plate-subtitle">LOCAL ZERO-KNOWLEDGE SHA-256</span>
+            </div>
+            <div class="grid-3">
+                <div class="data-row" style="margin:0;">
+                    <div class="data-label">File Name</div>
+                    <div class="data-value">${fileName}</div>
+                </div>
+                <div class="data-row" style="margin:0;">
+                    <div class="data-label">File Size</div>
+                    <div class="data-value">${fileSize}</div>
+                </div>
+                <div class="data-row" style="margin:0;">
+                    <div class="data-label">MIME Type</div>
+                    <div class="data-value">${mimeType}</div>
+                </div>
+            </div>
+        </div>
+
+        <div class="plate">
+            <div class="plate-title">
+                <span>Plate I — Cryptographic Payload &amp; Ownership</span>
+                <span class="plate-subtitle" style="color:var(--accent-orange);">${
+                  signerPubKey ? "BIOMETRIC PASSKEY ATTESTED" : "ANONYMOUS PURITY"
+                }</span>
+            </div>
+            <div class="data-row">
+                <div class="data-label">[ THE WHAT ] ZERO-KNOWLEDGE FILE HASH (SHA-256)</div>
+                <div class="data-value cyan">${originalHash}</div>
+            </div>
+            <div class="data-row">
+                <div class="data-label">[ THE WHO ] SIGNATORY PUBLIC KEY</div>
+                <div class="data-value cyan">${
+                  signerPubKey || "[ ANONYMOUS — RAW DATA INTEGRITY (NO PASSKEY) ]"
+                }</div>
+            </div>
+            <div class="data-row">
+                <div class="data-label">
+                    <span>ATTESTED IDENTITY HASH &bull; GENERATES THE 64-RAY SUN-STAMP</span>
+                    <span class="anchored-badge">&#9733; ANCHORED TO BITCOIN MERKLE TREE</span>
+                </div>
+                <div class="data-value anchored-box">${attestedHash}</div>
+            </div>
+        </div>
+
+        <div class="plate">
+            <div class="plate-title">
+                <span>Plate II — The Solar Seal &amp; Thermodynamic Clock</span>
+                <span class="plate-subtitle">SEEDED BY ATTESTED IDENTITY HASH</span>
+            </div>
+            <div class="solar-vault">
+                <div class="stamp-box" id="stamp-mount"></div>
+            </div>
+            <div class="data-row">
+                <div class="data-label">
+                    <span>[ THE WHEN ] THERMODYNAMIC PROOF (T_INDEX)</span>
+                    <span class="plate-subtitle">${isStandard ? "STATIC BLOCK SEED" : "VDF CLOCK SNAPSHOT"}</span>
+                </div>
+                <div class="data-value orange">${tIndex}</div>
+            </div>
+            <div class="data-row">
+                <div class="data-label">SOLAR VDF TICKS ELAPSED SINCE LAST BITCOIN BLOCK</div>
+                <div class="data-value orange" style="font-weight:bold;">${
+                  isStandard ? "0 (Bypassed — Standard Mode)" : formattedTicks
+                }</div>
+            </div>
+        </div>
+
+        <div class="plate">
+            <div class="plate-title">
+                <span>Plate III — Bitcoin Timechain Finality</span>
+                <span class="plate-subtitle" style="color:${
+                  isSettled ? "var(--accent-green)" : "var(--accent-orange)"
+                };">${isSettled ? "MAINNET OP_RETURN SETTLEMENT" : "AWAITING BLOCK SETTLEMENT"}</span>
+            </div>
+            <div class="grid-3">
+                <div class="data-row" style="margin:0;">
+                    <div class="data-label">Bitcoin Block Height</div>
+                    <div class="data-value ${isSettled ? "green" : "orange"}">${blockHeightDisplay}</div>
+                </div>
+                <div class="data-row" style="margin:0;">
+                    <div class="data-label">Block Timestamp (UTC)</div>
+                    <div class="data-value ${isSettled ? "green" : "orange"}">${blockTimeDisplay}</div>
+                </div>
+                <div class="data-row" style="margin:0;">
+                    <div class="data-label">Merkle Proof Path</div>
+                    <div class="data-value ${isSettled ? "green" : "orange"}">${merkleProofDisplay}</div>
+                </div>
+            </div>
+            <div class="data-row">
+                <div class="data-label">BITCOIN OP_RETURN TRANSACTION ID (TXID)</div>
+                <div class="${finalityValueClass}">${txidDisplay}</div>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        function toggleTheme() {
+            const body = document.body;
+            const btn = document.getElementById('theme-toggle');
+            const isLight = body.classList.toggle('light-mode');
+            if (btn) btn.innerHTML = isLight ? '🌙 DARK' : '☀️ LIGHT';
+            try { localStorage.setItem('reltime_cert_theme', isLight ? 'light' : 'dark'); } catch(e) {}
+        }
+        try {
+            if (localStorage.getItem('reltime_cert_theme') === 'light') {
+                document.body.classList.add('light-mode');
+                const btn = document.getElementById('theme-toggle');
+                if (btn) btn.innerHTML = '🌙 DARK';
+            }
+        } catch(e) {}
+
+        function generateBWStamp() {
+            const attestedHash = ${JSON.stringify(attestedHash)};
+            const verifyUrl = 'https://rel-time.com/verify?t=' + attestedHash;
+            const qr = qrcode(0, 'L');
+            qr.addData(verifyUrl);
+            qr.make();
+
+            const moduleCount = qr.getModuleCount();
+            const quietZone = 3;
+            const gridSize = 55;
+            const offset = Math.floor((gridSize - moduleCount) / 2);
+            const center = gridSize / 2;
+            const cellSize = 3.85;
+            const maxRadiusPx = 104.0;
+
+            let svgContent = '<svg viewBox="22 22 356 356" width="240" height="240" xmlns="http://www.w3.org/2000/svg">';
+            svgContent += '<a href="' + verifyUrl + '" target="_blank" rel="noopener noreferrer" style="cursor:pointer;">';
+            svgContent += '<circle cx="200" cy="200" r="109" fill="#ffffff" stroke="#000000" stroke-width="2" stroke-opacity="1"/>';
+
+            let qrDots = '';
+            let noiseDots = '';
+
+            for (let r = 0; r < gridSize; r++) {
+                for (let c = 0; c < gridSize; c++) {
+                    const dx = (c - center + 0.5) * cellSize;
+                    const dy = (r - center + 0.5) * cellSize;
+                    const distPx = Math.sqrt(dx * dx + dy * dy);
+                    const qrR = r - offset;
+                    const qrC = c - offset;
+                    const x = 200 + (c - center) * cellSize;
+                    const y = 200 + (r - center) * cellSize;
+
+                    if (qrR >= 0 && qrR < moduleCount && qrC >= 0 && qrC < moduleCount) {
+                        if (qr.isDark(qrR, qrC)) {
+                            qrDots += '<rect x="' + x.toFixed(2) + '" y="' + y.toFixed(2) + '" width="' + (cellSize + 0.22).toFixed(2) + '" height="' + (cellSize + 0.22).toFixed(2) + '" />';
+                        }
+                    } else if (qrR >= -quietZone && qrR < moduleCount + quietZone && qrC >= -quietZone && qrC < moduleCount + quietZone) {
+                    } else if (distPx <= maxRadiusPx) {
+                        const seed = Math.sin(r * 12.9898 + c * 78.233) * 43758.5453;
+                        if ((seed - Math.floor(seed)) > 0.5) {
+                            noiseDots += '<rect x="' + x.toFixed(2) + '" y="' + y.toFixed(2) + '" width="' + (cellSize + 0.2).toFixed(2) + '" height="' + (cellSize + 0.2).toFixed(2) + '" />';
+                        }
+                    }
+                }
+            }
+
+            svgContent += '<g fill="#000000" transform="rotate(14 200 200)">' + qrDots + '</g>';
+            svgContent += '<g fill="#000000" transform="rotate(14 200 200)">' + noiseDots + '</g>';
+
+            const hash = attestedHash;
+            let radials = '<g>';
+            for (let i = 0; i < 64; i++) {
+                const val = parseInt(hash[i] || '0', 16) || 0;
+                const r_length = 15 + (val / 15) * 45;
+                const r_inner = 115;
+                const a = (i * 360 / 64 - 90) * Math.PI / 180;
+                const x1 = 200 + r_inner * Math.cos(a);
+                const y1 = 200 + r_inner * Math.sin(a);
+                const x2 = 200 + (r_inner + r_length) * Math.cos(a);
+                const y2 = 200 + (r_inner + r_length) * Math.sin(a);
+                const dynamicRayColor = (val % 2 === 1) ? '#facc15' : '#ea580c';
+                radials += '<line x1="' + x1.toFixed(2) + '" y1="' + y1.toFixed(2) + '" x2="' + x2.toFixed(2) + '" y2="' + y2.toFixed(2) + '" stroke="' + dynamicRayColor + '" stroke-width="2.5" stroke-linecap="round" />';
+            }
+            radials += '</g></a></svg>';
+            svgContent += radials;
+
+            const mount = document.getElementById('stamp-mount');
+            if (mount) mount.innerHTML = svgContent;
+        }
+        generateBWStamp();
+    </script>
+</body>
+</html>`;
+}
+
 const TOOLS = [
   {
     name: "reltime_anchor_file",
     description:
-      "Zero-knowledge file anchoring + 1-Click Stamped Copy: Computes the SHA-256 hash of a local file ENTIRELY ON THE LOCAL MACHINE (the file never leaves the user's computer), supports both Anonymous and Biometric (Passkey) Anchors, anchors the 64-char hash to the Bitcoin Timechain via Rel-Time, saves the 64-ray Sun-Stamp SVG and JSON Doomsday Proof, and automatically creates a Stamped Copy (`reltime-stamped-<name>.pdf` or `.png`) with the Sun-Stamp overlaid in the bottom-right corner for PDFs and Images.",
+      "Zero-knowledge file anchoring + 1-Click Stamped Copy + 4-Plate Provenance Certificate: Computes the SHA-256 hash of a local file ENTIRELY ON THE LOCAL MACHINE (the file never leaves the user's computer), supports both Anonymous and Biometric (Passkey) Anchors, anchors the 64-char hash to the Bitcoin Timechain via Rel-Time, saves the 64-ray Sun-Stamp SVG, JSON Doomsday Proof, 4-Plate Sovereign Cryptographic Provenance Certificate (`reltime-certificate-<name>.html`), and automatically creates a Stamped Copy (`reltime-stamped-<name>.pdf` or `.png`) with the Sun-Stamp overlaid in the bottom-right corner for PDFs and Images.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1559,6 +2093,16 @@ const TOOLS = [
           description:
             "If true (default), automatically generates `reltime-stamped-<name>.pdf` or `.png` with the crisp 64-ray Sun-Stamp in the bottom-right corner when the file is a PDF or Image.",
         },
+        save_certificate_html: {
+          type: "boolean",
+          description:
+            "If true (default), saves the 4-Plate Sovereign Cryptographic Provenance Certificate (`reltime-certificate-<filename>.html`) in the same folder as the file.",
+        },
+        open_certificate_in_browser: {
+          type: "boolean",
+          description:
+            "If true, opens the generated 4-Plate Sovereign Cryptographic Provenance Certificate HTML in the system browser.",
+        },
         api_key: {
           type: "string",
           description: "Optional override for RELTIME_API_KEY (Autonomous Agent, Universal Anchor, or Enterprise Superhighway key).",
@@ -1655,7 +2199,7 @@ const TOOLS = [
   {
     name: "reltime_check_proof",
     description:
-      "Queries `GET /v1/proof/{hash}` to check the Bitcoin settlement status (Block Height, Block UTC Time, Bitcoin TXID, Merkle Root, and Merkle Inclusion Path) of an anchored hash. Optionally saves or updates the finalized `.json` Doomsday Proof receipt on disk when settled.",
+      "Queries `GET /v1/proof/{hash}` to check the Bitcoin settlement status (Block Height, Block UTC Time, Bitcoin TXID, Merkle Root, and Merkle Inclusion Path) of an anchored hash. Optionally saves or updates the finalized `.json` Doomsday Proof receipt AND/OR generates the 4-Plate Sovereign Cryptographic Provenance Certificate HTML on demand.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1663,10 +2207,29 @@ const TOOLS = [
           type: "string",
           description: "The 64-character client_hash or t_index to verify.",
         },
+        file_path: {
+          type: "string",
+          description:
+            "Optional local file path corresponding to the anchored hash (used to verify local custody/Passkey ownership and populate exact file name, size, and MIME type on the Provenance Certificate).",
+        },
         output_json_path: {
           type: "string",
           description: "Optional local file path to save the settled JSON Doomsday Proof receipt.",
         },
+        save_certificate_html: {
+          type: "boolean",
+          description:
+            "If true, generates and saves the 4-Plate Sovereign Cryptographic Provenance Certificate (`reltime-certificate-<name>.html`) on demand.",
+        },
+        output_certificate_html_path: {
+          type: "string",
+          description: "Optional custom file path to save the 4-Plate Provenance Certificate HTML.",
+        },
+        open_certificate_in_browser: {
+          type: "boolean",
+          description:
+            "If true, generates the 4-Plate Sovereign Cryptographic Provenance Certificate HTML and opens it in the system browser.",
+        },
       },
       required: ["hash"],
     },
@@ -1674,7 +2237,7 @@ const TOOLS = [
   {
     name: "reltime_account_status",
     description:
-      "Checks the remaining Hash Credits, tier, and lifetime usage of the configured Rel-Time API key (`GET /api/v1/account`). If no API key is configured yet, returns the 4 available Rel-Time Tiers (`universal` $3, `launch` $5/50, `standard` $50/500, `enterprise` $600/5,000) and payment options (`lightning` or `stripe`) so you can ask the user which tier they want to provision in chat.",
+      "Checks the remaining Hash Credits, tier, and lifetime usage of the configured Rel-Time API key (`GET /api/v1/account`). If no API key is configured yet, returns the 4 available Rel-Time Tiers (`universal` $3, `launch` $5/25, `standard` $50/500, `enterprise` $399/5,000) and payment options (`lightning` or `stripe`) so you can ask the user which tier they want to provision in chat.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1689,7 +2252,7 @@ const TOOLS = [
   {
     name: "reltime_provision_agent_key",
     description:
-      "Self-onboarding & Top-Up for all 4 Rel-Time Tiers via EITHER Bitcoin Lightning OR Stripe Card Checkout (`POST /v1/agent/invoice` & `POST /v1/agent/claim`). IMPORTANT:\n1. Before calling `create_invoice` for a new key, ask the user which tier AND payment method (`lightning` or `stripe`) they want:\n   - **Universal Anchor (`pack: 'universal'`, $3 / anchor):** Priority 10-Minute Bitcoin Queue · Standard Mode (Biometric or Anonymous) · Supports `quantity` (default 1).\n   - **Agent Launch Pack (`pack: 'launch'`, $5 / 50 Hashes):** Priority 10-Minute Bitcoin Queue · Standard Mode · Includes Sun-Stamp, 1-Click Stamped Copy (.PDF/.PNG), and .JSON Doomsday Proof.\n   - **Autonomous Agents (`pack: 'standard'`, $50 / 500 Hashes):** Dynamic 6-Hour Batch Queue · Supports both Temporal Mode (`T_index` sub-second sequencing) and Standard Mode · Reloadable anytime (+500 credits / $50) with zero key rotation.\n   - **Rel-Time Superhighway (`pack: 'enterprise'`, $600 / 5,000 Hashes):** Priority 10-Minute Bitcoin Queue · Supports Temporal Mode (`T_index`) & Standard Mode + Bulk Folder.\n2. When `create_invoice` returns:\n   - For **Lightning**: ALWAYS present BOTH the scannable QR code image (by calling Read on `qr_code_png_path`) AND the full, un-truncated `ln_invoice` (`bolt11`) string in a copyable code block on the VERY FIRST try!\n   - For **Stripe**: The Stripe Checkout page opens automatically in the user's browser; also present the clickable `checkout_url` link and QR code (`qr_code_png_path`). Once paid, call `claim_invoice` with `invoice_id` (`cs_...`) to activate and save the key.",
+      "Self-onboarding & Top-Up for all 4 Rel-Time Tiers via EITHER Bitcoin Lightning OR Stripe Card Checkout (`POST /v1/agent/invoice` & `POST /v1/agent/claim`). IMPORTANT:\n1. Before calling `create_invoice` for a new key, ask the user which tier AND payment method (`lightning` or `stripe`) they want:\n   - **Universal Anchor (`pack: 'universal'`, $3 / anchor):** Priority 10-Minute Bitcoin Queue · Standard Mode (Biometric or Anonymous) · Supports `quantity` (default 1).\n   - **Agent Launch Pack (`pack: 'launch'`, $5 / 25 Hashes, max 3 per key):** Priority 10-Minute Bitcoin Queue · Standard Mode · Includes Sun-Stamp, 1-Click Stamped Copy (.PDF/.PNG), 4-Plate Certificate, and .JSON Doomsday Proof.\n   - **Autonomous Agents (`pack: 'standard'`, $50 / 500 Hashes):** Dynamic 6-Hour Batch Queue · Supports both Temporal Mode (`T_index` sub-second sequencing) and Standard Mode · Reloadable anytime (+500 credits / $50) with zero key rotation.\n   - **Rel-Time Superhighway (`pack: 'enterprise'`, $399 / 5,000 Hashes):** Priority 10-Minute Bitcoin Queue · Supports Temporal Mode (`T_index`) & Standard Mode + Data Integrity Audit & Instant Tamper Detection.\n2. When `create_invoice` returns:\n   - For **Lightning**: ALWAYS present BOTH the scannable QR code image (by calling Read on `qr_code_png_path`) AND the full, un-truncated `ln_invoice` (`bolt11`) string in a copyable code block on the VERY FIRST try!\n   - For **Stripe**: The Stripe Checkout page opens automatically in the user's browser; also present the clickable `checkout_url` link and QR code (`qr_code_png_path`). Once paid, call `claim_invoice` with `invoice_id` (`cs_...`) to activate and save the key.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1703,7 +2266,7 @@ const TOOLS = [
           type: "string",
           enum: ["universal", "launch", "standard", "enterprise"],
           description:
-            "REQUIRED for 'create_invoice' after asking the user. Which tier the user selected: 'universal' ($3/anchor), 'launch' ($5 / 50 Hashes), 'standard' ($50 / 500 Hashes), or 'enterprise' ($600 / 5,000 Hashes — Superhighway). If omitted on 'create_invoice', returns the 4 tier options so you can ask the user.",
+            "REQUIRED for 'create_invoice' after asking the user. Which tier the user selected: 'universal' ($3/anchor), 'launch' ($5 / 25 Hashes, max 3 per key), 'standard' ($50 / 500 Hashes), or 'enterprise' ($399 / 5,000 Hashes — Superhighway). If omitted on 'create_invoice', returns the 4 tier options so you can ask the user.",
         },
         payment_method: {
           type: "string",
@@ -1738,7 +2301,7 @@ const TOOLS = [
   {
     name: "reltime_audit_trail",
     description:
-      "Superhighway Cryptographic Audit Trail & Local Folder Integrity Verifier (`GET /api/v1/account` + `GET /api/v1/account/history` + local SHA-256 cross-reference). Fetches the account's chronological anchor ledger, aggregates Bitcoin block settlements, VDF `T_index` ticks, and Corporate Hardware Passkey (`signer_public_key`) signatures, optionally verifies a local file or entire folder bit-for-bit against the ledger (`verify_local_path`), and spins up a self-contained interactive HTML Audit Report (`reltime-audit-report-*.html`) in the user's browser.",
+      "SUPERHIGHWAY EXCLUSIVE ($399 / 5,000 Hashes): Data Integrity Audit, Instant Tamper Detection & Forensic Timechain Report (`GET /api/v1/account` + `GET /api/v1/account/history` + local SHA-256 cross-reference). Fetches the account's chronological anchor ledger, aggregates Bitcoin block settlements, VDF `T_index` ticks, and Corporate Hardware Passkey (`signer_public_key`) signatures, verifies a local file or entire folder bit-for-bit against the ledger (`verify_local_path`), and spins up a self-contained interactive HTML Forensic Audit Report (`reltime-audit-report-*.html`) in the user's browser.",
     inputSchema: {
       type: "object",
       properties: {
@@ -1930,6 +2493,39 @@ async function executeTool(name, args = {}) {
       stampedCopyResult = await stampLocalFileOptionA(filePath, svgContent, null, clientHash);
     }
 
+    // 4. Generate 4-Plate Sovereign Cryptographic Provenance Certificate HTML
+    let savedCertificateHtmlPath = null;
+    if (args.save_certificate_html !== false) {
+      const certHtml = generateProvenanceCertificateHtml({
+        fileName: path.basename(filePath),
+        fileSize: formatBytes(fileBuffer.length),
+        mimeType: inferMimeTypeFromFileName(path.basename(filePath)),
+        originalFileHash,
+        attestedHash: clientHash,
+        signerPublicKey: passkeyCreds ? passkeyCreds.public_key_hex : null,
+        anchorMode: data.anchor_mode || anchorMode,
+        tIndex,
+        vdfTicks: data.vdf_ticks || data.solar_ticks || 0,
+        status: data.status || "pending_finality",
+        blockHeight: data.settlement?.bitcoin_block_height || null,
+        blockTimeUtc: data.settlement?.bitcoin_block_time
+          ? new Date(data.settlement.bitcoin_block_time * 1000).toISOString().replace("T", " ").slice(0, 19) + " UTC"
+          : null,
+        merkleProofCount: Array.isArray(data.settlement?.merkle_proof_path)
+          ? data.settlement.merkle_proof_path.length
+          : null,
+        txid: data.settlement?.bitcoin_txid || null,
+      });
+      savedCertificateHtmlPath = path.join(
+        path.dirname(filePath),
+        `reltime-certificate-${path.basename(filePath)}.html`
+      );
+      fs.writeFileSync(savedCertificateHtmlPath, certHtml, "utf8");
+      if (args.open_certificate_in_browser) {
+        openSystemBrowser(savedCertificateHtmlPath);
+      }
+    }
+
     return {
       status: data.status || "pending_finality",
       file_name: path.basename(filePath),
@@ -1945,6 +2541,7 @@ async function executeTool(name, args = {}) {
       sun_stamp_svg_url: stampEndpointUrl,
       saved_sun_stamp_svg_path: savedSvgPath,
       saved_doomsday_proof_json_path: savedProofJsonPath,
+      saved_certificate_html_path: savedCertificateHtmlPath,
       stamped_copy: stampedCopyResult,
       zero_knowledge_guarantee:
         "File was hashed and stamped 100% locally on your machine; 0 bytes of file content were transmitted.",
@@ -2062,6 +2659,81 @@ async function executeTool(name, args = {}) {
       fs.writeFileSync(jsonPath, JSON.stringify(out, null, 2), "utf8");
       out.saved_json_path = jsonPath;
     }
+
+    const wantsCert =
+      Boolean(args.save_certificate_html) ||
+      Boolean(args.output_certificate_html_path) ||
+      Boolean(args.open_certificate_in_browser);
+
+    if (wantsCert && res.ok) {
+      let fileName = "Zero-Knowledge Hash Payload";
+      let fileSize = "Zero-Knowledge (32-Byte Digest)";
+      let mimeType = "application/octet-stream (Zero-Knowledge)";
+      let originalFileHash = data.original_file_hash || data.client_hash || hash;
+      let targetDir = os.tmpdir();
+
+      if (args.file_path) {
+        const resolvedFile = resolveLocalFilePath(args.file_path);
+        if (fs.existsSync(resolvedFile)) {
+          const stat = fs.statSync(resolvedFile);
+          fileName = path.basename(resolvedFile);
+          fileSize = formatBytes(stat.size);
+          mimeType = inferMimeTypeFromFileName(fileName);
+          targetDir = path.dirname(resolvedFile);
+          if (!data.original_file_hash) {
+            originalFileHash = crypto
+              .createHash("sha256")
+              .update(fs.readFileSync(resolvedFile))
+              .digest("hex");
+          }
+        }
+      }
+
+      const savedPasskey = loadSavedPasskey();
+      if (data.signer_public_key) {
+        out.passkey_custody_verified = Boolean(
+          savedPasskey &&
+            savedPasskey.public_key_hex.toLowerCase() === String(data.signer_public_key).toLowerCase()
+        );
+      }
+
+      const certHtml = generateProvenanceCertificateHtml({
+        fileName,
+        fileSize,
+        mimeType,
+        originalFileHash,
+        attestedHash: data.client_hash || hash,
+        signerPublicKey: data.signer_public_key || null,
+        anchorMode: data.anchor_mode || (data.vdf_ticks ? "temporal" : "standard"),
+        tIndex: data.thermodynamic_proof || data.t_index || "PENDING VDF SNAPSHOT",
+        vdfTicks: data.vdf_ticks || 0,
+        status: data.status || "pending_finality",
+        blockHeight: data.settlement?.bitcoin_block_height || null,
+        blockTimeUtc: data.settlement?.bitcoin_block_time
+          ? new Date(data.settlement.bitcoin_block_time * 1000).toISOString().replace("T", " ").slice(0, 19) + " UTC"
+          : null,
+        merkleProofCount: Array.isArray(data.settlement?.merkle_proof_path)
+          ? data.settlement.merkle_proof_path.length
+          : null,
+        txid: data.settlement?.bitcoin_txid || null,
+      });
+
+      const certPath = args.output_certificate_html_path
+        ? path.resolve(args.output_certificate_html_path)
+        : path.join(
+            targetDir,
+            fileName !== "Zero-Knowledge Hash Payload"
+              ? `reltime-certificate-${fileName}.html`
+              : `reltime-certificate-${hash.slice(0, 12)}.html`
+          );
+      fs.writeFileSync(certPath, certHtml, "utf8");
+      out.saved_certificate_html_path = certPath;
+
+      if (args.open_certificate_in_browser) {
+        openSystemBrowser(certPath);
+      }
+    }
+
     return out;
   }
 
@@ -2111,6 +2783,35 @@ async function executeTool(name, args = {}) {
       throw new Error(`Rel-Time Account error (${acctRes.status}): ${await acctRes.text()}`);
     }
     const acctData = await acctRes.json();
+    const tierName = String(acctData.tier || "");
+    const isSuperhighway =
+      tierName.includes("Superhighway") ||
+      tierName.includes("Enterprise") ||
+      key.startsWith("rel_key_enterprise_");
+
+    if (!isSuperhighway) {
+      return {
+        status: "superhighway_upgrade_required",
+        current_tier: tierName || "Standard / Agent",
+        hash_credits: Number(acctData.hash_credits || 0),
+        message:
+          "Data Integrity Audit, Instant Tamper Detection, and Forensic Timechain Reports (`reltime_audit_trail`) are exclusive to the Rel-Time Superhighway ($399 / 5,000 Hashes) tier.",
+        how_to_upgrade:
+          "Ask the user if they would like to upgrade their current key to Rel-Time Superhighway ($399 / 5,000 Hashes) via Bitcoin Lightning (`lightning`) or Stripe Card (`stripe`), then call `reltime_provision_agent_key({ action: 'create_invoice', pack: 'enterprise', payment_method, reload_existing: true })`.",
+      };
+    }
+
+    if (Number(acctData.hash_credits || 0) <= 0) {
+      return {
+        status: "superhighway_renewal_required",
+        current_tier: tierName,
+        hash_credits: 0,
+        message:
+          "Your Rel-Time Superhighway key currently has 0 active Hash Credits remaining. Please renew your Superhighway cycle ($399 / 5,000 Hashes) to run Data Integrity Audits & Forensic Reports.",
+        how_to_renew:
+          "Ask the user if they would like to renew their Superhighway key via Bitcoin Lightning (`lightning`) or Stripe Card (`stripe`), then call `reltime_provision_agent_key({ action: 'create_invoice', pack: 'enterprise', payment_method, reload_existing: true })`.",
+      };
+    }
 
     const maxEntries = Math.min(500, Math.max(1, Number(args.limit) || 100));
     const pageSize = Math.min(100, maxEntries);
@@ -2500,14 +3201,15 @@ async function executeTool(name, args = {}) {
 
       if (!validPacks.includes(normalizedPack) || !validMethods.includes(normalizedMethod)) {
         const missingNote = !validPacks.includes(normalizedPack)
-          ? "Please ask the user which Rel-Time Tier (`universal` $3, `launch` $5/50, `standard` $50/500, or `enterprise` $600/5,000) AND which payment method (`lightning` or `stripe`) they would like to provision:"
+          ? "Please ask the user which Rel-Time Tier (`universal` $3, `launch` $5/25, `standard` $50/500, or `enterprise` $399/5,000) AND which payment method (`lightning` or `stripe`) they would like to provision:"
           : `The user selected pack '${normalizedPack}', but payment_method was not specified. Please ask the user whether they want to pay via Bitcoin Lightning ('lightning') or Stripe Card ('stripe') before calling create_invoice again:`;
         return buildPackSelectionPrompt(missingNote);
       }
 
       const finalPack = normalizedPack === "superhighway" ? "enterprise" : normalizedPack;
       const paymentMethod = normalizedMethod;
-      const targetReloadKey = args.api_key || (args.reload_existing ? loadSavedApiKey() : "");
+      const targetReloadKey =
+        args.api_key || ((args.reload_existing || finalPack === "launch") ? loadSavedApiKey() : "");
 
       LAST_INVOICE_PACK = finalPack;
       const reqBody = {
@@ -2610,7 +3312,8 @@ async function executeTool(name, args = {}) {
         invoice_id: args.invoice_id,
         pack: resolvedPack,
       };
-      const targetReloadKey = args.api_key || (args.reload_existing ? loadSavedApiKey() : "");
+      const targetReloadKey =
+        args.api_key || ((args.reload_existing || resolvedPack === "launch") ? loadSavedApiKey() : "");
       if (targetReloadKey && targetReloadKey.trim()) {
         claimPayload.api_key = targetReloadKey.trim();
       }

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@rel-time/mcp-server",
-  "version": "1.2.9",
+  "version": "1.2.11",
+  "mcpName": "io.github.relsun369-dev/rel-time",
   "description": "Official Model Context Protocol (MCP) server for Rel-Time (rel-time.com) — Zero-Knowledge Bitcoin & VDF Provenance, Local File Hashing, and Sun-Stamp Generation for Claude, Cursor, Windsurf, and Antigravity.",
   "main": "index.js",
   "bin": {
@@ -9,11 +10,20 @@
   },
   "files": [
     "index.js",
-    "README.md"
+    "README.md",
+    "server.json"
   ],
   "scripts": {
     "start": "node index.js"
   },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/relsun369-dev/reltime-mcp.git"
+  },
+  "homepage": "https://rel-time.com",
+  "bugs": {
+    "url": "https://github.com/relsun369-dev/reltime-mcp/issues"
+  },
   "keywords": [
     "mcp",
     "model-context-protocol",

package/server.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
+  "name": "io.github.relsun369-dev/rel-time",
+  "title": "Rel-Time Protocol (Bitcoin & VDF Provenance)",
+  "description": "Zero-knowledge Bitcoin Mainnet & VDF timestamping, Passkey signing, Sun-Stamps, and tamper audits.",
+  "websiteUrl": "https://rel-time.com",
+  "repository": {
+    "url": "https://github.com/relsun369-dev/reltime-mcp",
+    "source": "github"
+  },
+  "version": "1.2.11",
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@rel-time/mcp-server",
+      "version": "1.2.11",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ]
+}