@sheafhq/mcp-tools 0.1.0 → 0.1.2

package/dist/cli.js

@@ -3,13 +3,21 @@
 // (Claude Desktop, Cline, custom runtime) and speaks JSON-RPC over stdio.
 //
 // Environment variables (all optional):
-//   SHEAF_RECORDER_URL   where to query (default: production recorder)
+//   SHEAF_RECORDER_URL   explicit recorder override. If unset, tries
+//                        https://api.sheafhq.io and falls back to
+//                        https://sheaf-recorder.goldencalf.workers.dev.
 //   SHEAF_BASE_RPC       Base mainnet RPC for anchor verification
 //                        (default: https://mainnet.base.org)
 import { runServer } from "./server.js";
+const DEFAULT_URLS = [
+    "https://api.sheafhq.io",
+    "https://sheaf-recorder.goldencalf.workers.dev",
+];
+const recorderUrls = process.env.SHEAF_RECORDER_URL
+    ? [process.env.SHEAF_RECORDER_URL]
+    : DEFAULT_URLS;
 const ctx = {
-    recorderUrl: process.env.SHEAF_RECORDER_URL ??
-        "https://sheaf-recorder.goldencalf.workers.dev",
+    recorderUrls,
     baseRpc: process.env.SHEAF_BASE_RPC ?? "https://mainnet.base.org",
 };
 runServer(ctx);

package/dist/tools.d.ts

@@ -1,5 +1,7 @@
 export type ToolContext = {
-    recorderUrl: string;
+    /** Primary + fallback recorder base URLs. First entry is reported as
+     *  `source_url` in responses. Fallback only kicks in on fetch error. */
+    recorderUrls: string[];
     baseRpc: string;
 };
 export declare function chainHead(ctx: ToolContext, args: {

package/dist/tools.js

@@ -5,12 +5,24 @@
 // All three tools are READ-only against the Sheaf recorder. No wallet, no
 // settlement, no mutation. Safe to expose to any agent.
 import { verify } from "@sheafhq/verify";
+async function fetchWithFallback(ctx, path, init) {
+    let lastErr;
+    for (const base of ctx.recorderUrls) {
+        try {
+            const response = await fetch(base + path, init);
+            return { response, sourceUrl: base + path };
+        }
+        catch (err) {
+            lastErr = err;
+        }
+    }
+    throw lastErr ?? new Error("no recorder URLs configured");
+}
 export async function chainHead(ctx, args) {
     if (!args.chain_id || typeof args.chain_id !== "string") {
         throw new Error("chain_id (string) is required");
     }
-    const url = `${ctx.recorderUrl}/chains/${encodeURIComponent(args.chain_id)}/head`;
-    const r = await fetch(url);
+    const { response: r, sourceUrl } = await fetchWithFallback(ctx, `/chains/${encodeURIComponent(args.chain_id)}/head`);
     if (r.status === 404) {
         return {
             chain_id: args.chain_id,
@@ -29,7 +41,7 @@ export async function chainHead(ctx, args) {
         event_count: body.event_count,
         created_at_unix: body.created_at,
         updated_at_unix: body.updated_at,
-        source_url: url,
+        source_url: sourceUrl,
     };
 }
 export async function getProofFor(ctx, args) {
@@ -40,8 +52,7 @@ export async function getProofFor(ctx, args) {
         throw new Error("seq (non-negative integer) is required");
     }
     // First find out which epoch the event is in.
-    const evUrl = `${ctx.recorderUrl}/events/${encodeURIComponent(args.chain_id)}/${args.seq}`;
-    const evRes = await fetch(evUrl);
+    const { response: evRes } = await fetchWithFallback(ctx, `/events/${encodeURIComponent(args.chain_id)}/${args.seq}`);
     if (evRes.status === 404) {
         throw new Error(`no event at ${args.chain_id}/${args.seq}`);
     }
@@ -58,8 +69,7 @@ export async function getProofFor(ctx, args) {
             note: "Event is signed and chained but not yet included in an on-chain anchor. Call again after the next epoch anchor to get a Merkle inclusion proof.",
         };
     }
-    const proofUrl = `${ctx.recorderUrl}/epoch/${ev.epoch_id}/proof/${encodeURIComponent(args.chain_id)}/${args.seq}`;
-    const proofRes = await fetch(proofUrl);
+    const { response: proofRes, sourceUrl } = await fetchWithFallback(ctx, `/epoch/${ev.epoch_id}/proof/${encodeURIComponent(args.chain_id)}/${args.seq}`);
     if (!proofRes.ok) {
         throw new Error(`recorder returned HTTP ${proofRes.status} on proof fetch`);
     }
@@ -75,7 +85,7 @@ export async function getProofFor(ctx, args) {
         siblings: proof.siblings,
         anchor: proof.anchor,
         verification_note: proof.verification_note,
-        source_url: proofUrl,
+        source_url: sourceUrl,
     };
 }
 export async function verifyBundle(ctx, args) {
@@ -111,7 +121,7 @@ export async function verifyBundle(ctx, args) {
     // verification is self-contained; fall back to /.well-known if missing.
     let recorderKey = b.issuer?.public_key_base64 ?? "";
     if (!recorderKey) {
-        const r = await fetch(`${ctx.recorderUrl}/.well-known/sheaf-public-key`);
+        const { response: r } = await fetchWithFallback(ctx, `/.well-known/sheaf-public-key`);
         if (!r.ok) {
             throw new Error(`could not fetch recorder public key: HTTP ${r.status}`);
         }
@@ -136,7 +146,7 @@ export async function verifyBundle(ctx, args) {
         checks: result.checks,
         reason: result.reason,
         anchor_block: result.anchor_block,
-        recorder: ctx.recorderUrl,
+        recorder: ctx.recorderUrls[0],
         anchorer_checked: anchorer,
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sheafhq/mcp-tools",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "MCP server exposing Sheaf read tools (chain_head, get_proof_for, verify_bundle). Lets any MCP-compatible agent query the Sheaf recorder and verify receipts offline. Pairs with @sheafhq/mcp-recorder (transparent event capture) but ships as a separate, opt-in tool surface so the recorder stays purely transparent.",
   "type": "module",
   "main": "./dist/cli.js",