chain-insights 0.54.3 → 0.55.1

package/dist/mcp-proxy.cjs

@@ -102,7 +102,7 @@ const ROUTING_TWO_FIT = "A transaction is a chain question: read it on `USE chai
 /** The key that each layer hands to the next. Each key keeps its name. */
 const ROUTING_HANDOFF = "The layers hand each other keys, and each key keeps its name. Topology gives the pair and the first and last seen time. Facts gives the `tx_id` and the `block_height`. Chain takes an `address`, a `tx_id`, a `block_height` or a `block_hash`, and gives the `block_date` of a transaction or a block.";
 /** A whole-chain question is a time-bounded topology search; a server without search mode refuses it once. */
-const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, it does not serve searches yet: say so in one line and ask for an address.";
+const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, or stops it with `query_timeout`, it cannot search the whole chain now: say so in one line and ask for an address. A narrower window times out the same way, so do not send it again.";
 /** What a refusal carries, and which part of it decides the move. */
 const MOVE_INTRO = "A refused, killed, busy or failed query comes back with `error_detail`: `code`, `rule`, `class`, `fix` and `example`. The `class` decides your next move.";
 /** The move for each class of the refusal envelope. */
@@ -375,6 +375,117 @@ function flowsRecipeReturn(from, to, link = "f") {
 	return `${from}.address AS from_address, ${to}.address AS to_address, ${link}.amount_usd_sum AS amount_usd_sum, ${link}.tx_count AS tx_count, ${link}.first_seen_timestamp AS first_seen_timestamp, ${link}.last_seen_timestamp AS last_seen_timestamp, ${from}.labels AS from_labels, ${to}.labels AS to_labels, ${from}.is_exchange AS from_is_exchange, ${to}.is_exchange AS to_is_exchange`;
 }
 //#endregion
+//#region src/mcp/remote-connect.ts
+/**
+* Connects a client to a fresh transport. The SDK leaves a transport attached
+* when `connect` fails after `start` (an initialize answered 429), and the
+* next `connect` then throws "Already connected to a transport", so every try
+* closes first. Seen in round 83 of the 2026-10-10 test loop.
+*/
+async function connectFresh(client, transport) {
+	if (typeof client.close === "function") await client.close().catch(() => void 0);
+	await client.connect(transport);
+}
+const BUSY = /* @__PURE__ */ new Set([
+	429,
+	502,
+	503,
+	504
+]);
+const NOT_STREAMABLE = /* @__PURE__ */ new Set([404, 405]);
+/** The HTTP status an SDK transport error carries, from its `code` or its text. */
+function httpStatusOf(err) {
+	if (err && typeof err === "object") {
+		const code = err.code;
+		if (typeof code === "number" && code >= 100 && code < 600) return code;
+		const message = err.message;
+		if (typeof message === "string") {
+			const m = /\b(4\d\d|5\d\d)\b/.exec(message);
+			if (m) return Number(m[1]);
+		}
+	}
+	return null;
+}
+/** Milliseconds to wait before the next try: Retry-After when the error names one, else 1 s doubling. */
+function busyDelayMs(err, attempt) {
+	const retryAfter = err?.retryAfter;
+	if (typeof retryAfter === "number" && retryAfter > 0) return Math.min(retryAfter * 1e3, 3e4);
+	return Math.min(1e3 * 2 ** (attempt - 1), 8e3);
+}
+function describeRemoteFailure(endpoint, err, status) {
+	if (status !== null && BUSY.has(status)) return `Chain Insights Graph is at capacity at ${endpoint} (HTTP ${status}, class capacity): wait at least 5 seconds, then send the same query once.`;
+	return `Chain Insights Graph unreachable at ${endpoint}: ${err instanceof Error ? err.message : String(err)}`;
+}
+async function connectRemote(options) {
+	const attempts = Math.max(1, options.attempts ?? 5);
+	const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const log = options.log ?? (() => void 0);
+	let lastErr = null;
+	let lastStatus = null;
+	for (let attempt = 1; attempt <= attempts; attempt++) try {
+		await options.connectStreamable();
+		await log("remote.connect", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt
+		});
+		return {
+			connected: true,
+			transport: "streamable_http",
+			retryable: false,
+			attempts: attempt
+		};
+	} catch (err) {
+		lastErr = err;
+		lastStatus = httpStatusOf(err);
+		await log("remote.connect_failed", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt,
+			status: lastStatus
+		});
+		if (lastStatus !== null && BUSY.has(lastStatus) && attempt < attempts) {
+			await sleep(busyDelayMs(err, attempt));
+			continue;
+		}
+		break;
+	}
+	if (!(lastStatus !== null && BUSY.has(lastStatus))) try {
+		await options.connectSse();
+		await log("remote.connect", {
+			transport: "sse",
+			endpoint: options.endpoint
+		});
+		return {
+			connected: true,
+			transport: "sse",
+			retryable: false,
+			attempts
+		};
+	} catch (err2) {
+		await log("remote.connect_failed", {
+			transport: "sse",
+			endpoint: options.endpoint,
+			status: httpStatusOf(err2)
+		});
+		const named = lastStatus !== null && NOT_STREAMABLE.has(lastStatus) ? err2 : lastErr;
+		return {
+			connected: false,
+			transport: null,
+			retryable: false,
+			attempts,
+			message: describeRemoteFailure(options.endpoint, named, null)
+		};
+	}
+	return {
+		connected: false,
+		transport: null,
+		retryable: true,
+		attempts,
+		message: describeRemoteFailure(options.endpoint, lastErr, lastStatus)
+	};
+}
+//#endregion
 //#region src/mcp/proxy.ts
 const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
 	"meta_network_capabilities",
@@ -472,7 +583,7 @@ const PICTURE_HELP_LINE = "In hosts that draw views, a graph_query answer with f
 const RULES_FIRST = "Rules first: if the chain-insights-cypher skill is not loaded in this chat, call meta_rules once (send {}) before the first graph_query or graph_query_batch, and follow what it returns. When the skill is loaded, do not call meta_rules.";
 const ANSWER_RULES = [
 	"Answer rules, for every reply to the user:",
-	"1. Write every address in full: 0x plus 40 hex characters, 42 in all, in sentences, lists, tables and summaries. Never shorten one with ... or …. The drawn picture may shorten its labels; your text never does.",
+	"1. Write every address in full: 0x plus 40 hex characters, 42 in all, in sentences, lists, tables and summaries. Never shorten one with ... or …, not even a repeat mention of an address named earlier. The drawn picture may shorten its labels; your text never does.",
 	"2. Do not print the query, its USE line, its LIMIT, the epoch numbers you computed, or a Ref: line, unless the user asks how a number was found.",
 	"3. Tokens are not dollars: a transfer moves tokens worth an amount at the day price. Say \"tokens worth about 183 USD on 2026-10-06\", never \"sent 183 USD\".",
 	"4. Never draw a graph or a chart in text, ASCII or Mermaid: the host draws the picture from the columns. Write a short answer beside it."
@@ -997,37 +1108,35 @@ async function createProxy() {
 		remoteUnavailableMessage = `Chain Insights Graph setup unavailable at ${graphMcpEndpoint}: ${err.message}`;
 		process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 	}
-	if (mcpFetch) try {
-		await remoteClient.connect(new _modelcontextprotocol_sdk_client_streamableHttp_js.StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-		remoteConnected = true;
-		await logger.info("remote.connect", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
-		});
-	} catch {
-		await logger.error("remote.connect_failed", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
+	let remoteRetryable = false;
+	const connectRemoteOnce = async () => {
+		if (!mcpFetch) return;
+		const fetchForRemote = mcpFetch;
+		const result = await connectRemote({
+			endpoint: graphMcpEndpoint,
+			connectStreamable: () => connectFresh(remoteClient, new _modelcontextprotocol_sdk_client_streamableHttp_js.StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote })),
+			connectSse: async () => {
+				const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
+				await connectFresh(remoteClient, new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote }));
+			},
+			log: (event, fields) => event === "remote.connect" ? logger.info(event, fields) : logger.error(event, fields)
 		});
-		try {
-			const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
-			await remoteClient.connect(new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-			remoteConnected = true;
-			await logger.info("remote.connect", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint
-			});
-		} catch (err2) {
-			await logger.error("remote.connect_failed", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint,
-				error: errorForLog(err2)
-			});
-			remoteUnavailableMessage = `Chain Insights Graph unreachable at ${graphMcpEndpoint}: ${err2.message}`;
+		remoteConnected = result.connected;
+		remoteRetryable = result.retryable;
+		if (result.connected) {
+			remoteUnavailableMessage = void 0;
+			installRemoteCypherLogging(remoteClient, logger);
+		} else {
+			remoteUnavailableMessage = result.message;
 			process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 		}
-	}
-	if (remoteConnected) installRemoteCypherLogging(remoteClient, logger);
+	};
+	await connectRemoteOnce();
+	/** A graph call on a proxy that lost the endpoint to a busy signal tries to connect again, once. */
+	const ensureRemote = async () => {
+		if (remoteConnected || !remoteRetryable) return;
+		await connectRemoteOnce();
+	};
 	let tools = await loadSchema(graphMcpEndpoint);
 	if (!tools && remoteConnected) {
 		tools = (await remoteClient.listTools()).tools;
@@ -1093,6 +1202,7 @@ async function createProxy() {
 	const schemaDependencies = {
 		endpoint: graphMcpEndpoint,
 		withClient: async (fn) => {
+			await ensureRemote();
 			if (!remoteConnected) throw new require_graph_schema.GraphSchemaError(`${remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`}. Restart the Chain Insights MCP proxy after the endpoint is reachable.`);
 			return fn(remoteClient);
 		},
@@ -1125,6 +1235,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return {
 				content: [{
 					type: "text",
@@ -1173,6 +1284,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return jsonTextResult(require_subscription_status.unavailableSubscriptionStatus(graphMcpEndpoint, remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`));
 			if (!remoteToolNames.has("subscription_status")) return jsonTextResult(require_subscription_status.unavailableSubscriptionStatus(graphMcpEndpoint, "The graph backend exposes primitive graph tools but no subscription_status tool."));
 			const walletAddress = await localSubscriptionWalletAddress();
@@ -1384,6 +1496,7 @@ async function createProxy() {
 		const inputSchema = knownPublicToolInputSchema(tool.name) ?? zod.object({}).passthrough();
 		const handler = async (args) => {
 			try {
+				await ensureRemote();
 				if (!remoteConnected) return {
 					content: [{
 						type: "text",

package/dist/mcp-proxy.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAmEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBAyGG,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}
+{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAoEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBAyGG,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}

package/dist/mcp-proxy.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAmEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBAyGG,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}
+{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;qBAoEa;qBACA;;;;;wBAyBG;YAkBJ;wBAEI,oBAAoB,MAAK,OAAO,aAA2B;KAsCtE,iBAAiB,eAAe,EAAE;qBAgB1B;wBAyGG,2BAA2B,mBAAmB;;;;;;;;wBA+lBxC,eAAe"}

package/dist/mcp-proxy.mjs

@@ -98,7 +98,7 @@ const ROUTING_TWO_FIT = "A transaction is a chain question: read it on `USE chai
 /** The key that each layer hands to the next. Each key keeps its name. */
 const ROUTING_HANDOFF = "The layers hand each other keys, and each key keeps its name. Topology gives the pair and the first and last seen time. Facts gives the `tx_id` and the `block_height`. Chain takes an `address`, a `tx_id`, a `block_height` or a `block_hash`, and gives the `block_date` of a transaction or a block.";
 /** A whole-chain question is a time-bounded topology search; a server without search mode refuses it once. */
-const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, it does not serve searches yet: say so in one line and ask for an address.";
+const ROUTING_NOT_SERVED = "A question about the whole chain (recent activity, the biggest senders, a top list) is a `USE topology` search: bound it by time with `f.last_seen_timestamp >= <epoch ms>` on the `FLOWS_TO` link, then sort and `LIMIT`. A search has 10 s. If the server refuses it with `anchor_missing`, or stops it with `query_timeout`, it cannot search the whole chain now: say so in one line and ask for an address. A narrower window times out the same way, so do not send it again.";
 /** What a refusal carries, and which part of it decides the move. */
 const MOVE_INTRO = "A refused, killed, busy or failed query comes back with `error_detail`: `code`, `rule`, `class`, `fix` and `example`. The `class` decides your next move.";
 /** The move for each class of the refusal envelope. */
@@ -371,6 +371,117 @@ function flowsRecipeReturn(from, to, link = "f") {
 	return `${from}.address AS from_address, ${to}.address AS to_address, ${link}.amount_usd_sum AS amount_usd_sum, ${link}.tx_count AS tx_count, ${link}.first_seen_timestamp AS first_seen_timestamp, ${link}.last_seen_timestamp AS last_seen_timestamp, ${from}.labels AS from_labels, ${to}.labels AS to_labels, ${from}.is_exchange AS from_is_exchange, ${to}.is_exchange AS to_is_exchange`;
 }
 //#endregion
+//#region src/mcp/remote-connect.ts
+/**
+* Connects a client to a fresh transport. The SDK leaves a transport attached
+* when `connect` fails after `start` (an initialize answered 429), and the
+* next `connect` then throws "Already connected to a transport", so every try
+* closes first. Seen in round 83 of the 2026-10-10 test loop.
+*/
+async function connectFresh(client, transport) {
+	if (typeof client.close === "function") await client.close().catch(() => void 0);
+	await client.connect(transport);
+}
+const BUSY = /* @__PURE__ */ new Set([
+	429,
+	502,
+	503,
+	504
+]);
+const NOT_STREAMABLE = /* @__PURE__ */ new Set([404, 405]);
+/** The HTTP status an SDK transport error carries, from its `code` or its text. */
+function httpStatusOf(err) {
+	if (err && typeof err === "object") {
+		const code = err.code;
+		if (typeof code === "number" && code >= 100 && code < 600) return code;
+		const message = err.message;
+		if (typeof message === "string") {
+			const m = /\b(4\d\d|5\d\d)\b/.exec(message);
+			if (m) return Number(m[1]);
+		}
+	}
+	return null;
+}
+/** Milliseconds to wait before the next try: Retry-After when the error names one, else 1 s doubling. */
+function busyDelayMs(err, attempt) {
+	const retryAfter = err?.retryAfter;
+	if (typeof retryAfter === "number" && retryAfter > 0) return Math.min(retryAfter * 1e3, 3e4);
+	return Math.min(1e3 * 2 ** (attempt - 1), 8e3);
+}
+function describeRemoteFailure(endpoint, err, status) {
+	if (status !== null && BUSY.has(status)) return `Chain Insights Graph is at capacity at ${endpoint} (HTTP ${status}, class capacity): wait at least 5 seconds, then send the same query once.`;
+	return `Chain Insights Graph unreachable at ${endpoint}: ${err instanceof Error ? err.message : String(err)}`;
+}
+async function connectRemote(options) {
+	const attempts = Math.max(1, options.attempts ?? 5);
+	const sleep = options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms)));
+	const log = options.log ?? (() => void 0);
+	let lastErr = null;
+	let lastStatus = null;
+	for (let attempt = 1; attempt <= attempts; attempt++) try {
+		await options.connectStreamable();
+		await log("remote.connect", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt
+		});
+		return {
+			connected: true,
+			transport: "streamable_http",
+			retryable: false,
+			attempts: attempt
+		};
+	} catch (err) {
+		lastErr = err;
+		lastStatus = httpStatusOf(err);
+		await log("remote.connect_failed", {
+			transport: "streamable_http",
+			endpoint: options.endpoint,
+			attempt,
+			status: lastStatus
+		});
+		if (lastStatus !== null && BUSY.has(lastStatus) && attempt < attempts) {
+			await sleep(busyDelayMs(err, attempt));
+			continue;
+		}
+		break;
+	}
+	if (!(lastStatus !== null && BUSY.has(lastStatus))) try {
+		await options.connectSse();
+		await log("remote.connect", {
+			transport: "sse",
+			endpoint: options.endpoint
+		});
+		return {
+			connected: true,
+			transport: "sse",
+			retryable: false,
+			attempts
+		};
+	} catch (err2) {
+		await log("remote.connect_failed", {
+			transport: "sse",
+			endpoint: options.endpoint,
+			status: httpStatusOf(err2)
+		});
+		const named = lastStatus !== null && NOT_STREAMABLE.has(lastStatus) ? err2 : lastErr;
+		return {
+			connected: false,
+			transport: null,
+			retryable: false,
+			attempts,
+			message: describeRemoteFailure(options.endpoint, named, null)
+		};
+	}
+	return {
+		connected: false,
+		transport: null,
+		retryable: true,
+		attempts,
+		message: describeRemoteFailure(options.endpoint, lastErr, lastStatus)
+	};
+}
+//#endregion
 //#region src/mcp/proxy.ts
 const LOCAL_TOOL_NAMES = /* @__PURE__ */ new Set([
 	"meta_network_capabilities",
@@ -468,7 +579,7 @@ const PICTURE_HELP_LINE = "In hosts that draw views, a graph_query answer with f
 const RULES_FIRST = "Rules first: if the chain-insights-cypher skill is not loaded in this chat, call meta_rules once (send {}) before the first graph_query or graph_query_batch, and follow what it returns. When the skill is loaded, do not call meta_rules.";
 const ANSWER_RULES = [
 	"Answer rules, for every reply to the user:",
-	"1. Write every address in full: 0x plus 40 hex characters, 42 in all, in sentences, lists, tables and summaries. Never shorten one with ... or …. The drawn picture may shorten its labels; your text never does.",
+	"1. Write every address in full: 0x plus 40 hex characters, 42 in all, in sentences, lists, tables and summaries. Never shorten one with ... or …, not even a repeat mention of an address named earlier. The drawn picture may shorten its labels; your text never does.",
 	"2. Do not print the query, its USE line, its LIMIT, the epoch numbers you computed, or a Ref: line, unless the user asks how a number was found.",
 	"3. Tokens are not dollars: a transfer moves tokens worth an amount at the day price. Say \"tokens worth about 183 USD on 2026-10-06\", never \"sent 183 USD\".",
 	"4. Never draw a graph or a chart in text, ASCII or Mermaid: the host draws the picture from the columns. Write a short answer beside it."
@@ -993,37 +1104,35 @@ async function createProxy() {
 		remoteUnavailableMessage = `Chain Insights Graph setup unavailable at ${graphMcpEndpoint}: ${err.message}`;
 		process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 	}
-	if (mcpFetch) try {
-		await remoteClient.connect(new StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-		remoteConnected = true;
-		await logger.info("remote.connect", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
-		});
-	} catch {
-		await logger.error("remote.connect_failed", {
-			transport: "streamable_http",
-			endpoint: graphMcpEndpoint
+	let remoteRetryable = false;
+	const connectRemoteOnce = async () => {
+		if (!mcpFetch) return;
+		const fetchForRemote = mcpFetch;
+		const result = await connectRemote({
+			endpoint: graphMcpEndpoint,
+			connectStreamable: () => connectFresh(remoteClient, new StreamableHTTPClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote })),
+			connectSse: async () => {
+				const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
+				await connectFresh(remoteClient, new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: fetchForRemote }));
+			},
+			log: (event, fields) => event === "remote.connect" ? logger.info(event, fields) : logger.error(event, fields)
 		});
-		try {
-			const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
-			await remoteClient.connect(new SSEClientTransport(new URL(graphMcpEndpoint), { fetch: mcpFetch }));
-			remoteConnected = true;
-			await logger.info("remote.connect", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint
-			});
-		} catch (err2) {
-			await logger.error("remote.connect_failed", {
-				transport: "sse",
-				endpoint: graphMcpEndpoint,
-				error: errorForLog(err2)
-			});
-			remoteUnavailableMessage = `Chain Insights Graph unreachable at ${graphMcpEndpoint}: ${err2.message}`;
+		remoteConnected = result.connected;
+		remoteRetryable = result.retryable;
+		if (result.connected) {
+			remoteUnavailableMessage = void 0;
+			installRemoteCypherLogging(remoteClient, logger);
+		} else {
+			remoteUnavailableMessage = result.message;
 			process.stderr.write(`Chain Insights MCP graph tools unavailable: ${remoteUnavailableMessage}. Local Chain Insights tools are still available.\n`);
 		}
-	}
-	if (remoteConnected) installRemoteCypherLogging(remoteClient, logger);
+	};
+	await connectRemoteOnce();
+	/** A graph call on a proxy that lost the endpoint to a busy signal tries to connect again, once. */
+	const ensureRemote = async () => {
+		if (remoteConnected || !remoteRetryable) return;
+		await connectRemoteOnce();
+	};
 	let tools = await loadSchema(graphMcpEndpoint);
 	if (!tools && remoteConnected) {
 		tools = (await remoteClient.listTools()).tools;
@@ -1089,6 +1198,7 @@ async function createProxy() {
 	const schemaDependencies = {
 		endpoint: graphMcpEndpoint,
 		withClient: async (fn) => {
+			await ensureRemote();
 			if (!remoteConnected) throw new GraphSchemaError(`${remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`}. Restart the Chain Insights MCP proxy after the endpoint is reachable.`);
 			return fn(remoteClient);
 		},
@@ -1121,6 +1231,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return {
 				content: [{
 					type: "text",
@@ -1169,6 +1280,7 @@ async function createProxy() {
 		}
 	}, async () => {
 		try {
+			await ensureRemote();
 			if (!remoteConnected) return jsonTextResult(unavailableSubscriptionStatus(graphMcpEndpoint, remoteUnavailableMessage ?? `Chain Insights Graph is not connected at ${graphMcpEndpoint}`));
 			if (!remoteToolNames.has("subscription_status")) return jsonTextResult(unavailableSubscriptionStatus(graphMcpEndpoint, "The graph backend exposes primitive graph tools but no subscription_status tool."));
 			const walletAddress = await localSubscriptionWalletAddress();
@@ -1380,6 +1492,7 @@ async function createProxy() {
 		const inputSchema = knownPublicToolInputSchema(tool.name) ?? z.object({}).passthrough();
 		const handler = async (args) => {
 			try {
+				await ensureRemote();
 				if (!remoteConnected) return {
 					content: [{
 						type: "text",