chain-insights 0.2.16 → 0.2.18

package/dist/mcp-proxy.cjs

@@ -1,7 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_chunk = require("./chunk-CZWwpsFl.cjs");
-const require_version = require("./version-BNGtdpmH.cjs");
-const require_tool_visibility = require("./tool-visibility-CwgY205r.cjs");
+const require_chunk = require("./chunk-DakpK96I.cjs");
+const require_version = require("./version-CO9Or_YV.cjs");
+const require_client = require("./client-DPc2eyVN.cjs");
+const require_tool_visibility = require("./tool-visibility-iAVQV3t0.cjs");
 let node_url = require("node:url");
 let node_path = require("node:path");
 node_path = require_chunk.__toESM(node_path, 1);
@@ -58,7 +59,7 @@ const KNOWN_PUBLIC_TOOL_DESCRIPTIONS = {
 	address_risk: "Screen one full blockchain address for AML risk, behavior patterns, neighborhood context, exchange exposure, and optional comparison with compare_address. This includes the exchange-behavior analysis formerly covered by money_flows_between_exchanges. Use this as the first tool for a single-address investigation. The tool returns an investigator-ready summary; preserve full addresses exactly.",
 	scam_topology: "Build victim-incident laundering topology from one victim/source address and the earliest known incident timestamp. Traversal uses one explicit activity policy: node_relative_only by default, or global_incident_only when requested. Repeated targets are kept as non-expanding convergence edges. Returns ML-ready scam_labels plus review context and a track_funds-compatible graph report: primary flows, deposits, reverse_leads. Victims, exchange endpoints, and generic labeled context nodes are not automatic scam labels; preserve full addresses exactly.",
 	track_funds: "Trace funds from trusted victim/source addresses through intermediaries to exchange deposit addresses. Use this when the user has a victim/source address or known untrusted/scammer addresses. The tool returns an investigator-ready fund-flow report and recommended next actions.",
-	graph_query: "Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts. Cross-backend correlated joins are limited by current MemGQL behavior; preserve full addresses exactly.",
+	graph_query: "Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment. Cross-layer correlated joins may be limited by the active graph endpoint; preserve full addresses exactly.",
 	graph_query_batch: "Run multiple read-only GQL/Cypher queries through the Chain Insights graph endpoint in one paid batch. Prefer this for related topology/facts reads."
 };
 const NETWORK_DESCRIPTION = "Required network to query. Do not guess; use network_capabilities or ask the user if missing.";
@@ -80,12 +81,12 @@ const GRAPH_SCHEMA_HINTS = [
 	"- Risk and ML properties may appear as live hints, but source-of-truth risk rows are RiskScore facts.",
 	"- Common relationships include FLOWS_TO, OPERATED_FROM, SERVED_FROM, REGISTERED_NEURON, BELONGS_TO, SYBIL_CLUSTER, LAYERING_HOP, BURST_ACTIVITY, CYCLE_PARTICIPANT, SMURFING_CLUSTER.",
 	"- FLOWS_TO properties are scoped to the selected topology graph and commonly carry amount_sum, amount_usd_sum, tx_count, first_seen_timestamp, last_seen_timestamp, first_tx_id, last_tx_id. Confirm available fields through runtime schema before relying on them.",
-	"- Start schema discovery with MemGQL-safe property reads: MATCH (n:Address) WHERE n.address IS NOT NULL RETURN n.labels AS labels, n.address AS address LIMIT 20",
+	"- Start schema discovery with endpoint-safe property reads: MATCH (n:Address) WHERE n.address IS NOT NULL RETURN n.labels AS labels, n.address AS address LIMIT 20",
 	"- Relationship discovery: MATCH (:Address)-[r:FLOWS_TO]->(:Address) RETURN r.amount_sum AS amount_sum, r.amount_usd_sum AS amount_usd_sum LIMIT 20",
-	"- graph_query uses Memgraph Zero / MemGQL when available. Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts.",
+	"- graph_query uses the active Chain Insights graph endpoint. Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment.",
 	"- Archive topology labels include Address and TopologySnapshot. Archived money-flow topology is represented as (:Address)-[:FLOWS_TO]->(:Address) relationships with period_granularity, period_start_date, and period_end_date.",
 	"- All graph_query calls are read-only. Never use CREATE, INSERT, MERGE, SET, DELETE, REMOVE, DROP, DETACH, ADD, CONNECT, DISCONNECT, ALTER, TRUNCATE, GRANT, or REVOKE.",
-	"- Warehouse facts live behind facts_*_view StarRocks views and are reached through USE facts graph patterns. Do not query core_*, ml_*, analyzers_*, synthetics_*, or _* tables directly."
+	"- Use USE facts graph patterns for fact and enrichment reads. Do not query internal table namespaces directly."
 ].join("\n");
 const GRAPH_REPORT_HINTS = [
 	"Graph visualization behavior:",
@@ -158,7 +159,7 @@ function knownPublicToolInputSchema(toolName) {
 			case_id: zod.string().optional().describe("Optional Chain Insights case ID. When provided, compact evidence is appended to the case manifest.")
 		};
 		case "graph_query": return {
-			query: zod.string().min(1).describe("Read-only GQL/Cypher query. Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts."),
+			query: zod.string().min(1).describe("Read-only GQL/Cypher query. Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment."),
 			network: zod.string().min(1).describe(NETWORK_DESCRIPTION)
 		};
 		case "graph_query_batch": return {
@@ -414,7 +415,7 @@ function registerLocalPrompts(server, remotePromptNames) {
 	});
 	server.registerPrompt("graph-query", {
 		title: "Federated Graph Query",
-		description: "Run a read-only GQL/Cypher query through Chain Insights Memgraph Zero.",
+		description: "Run a read-only GQL/Cypher query through the Chain Insights graph endpoint.",
 		argsSchema: {
 			query: zod.string().describe("Read-only GQL/Cypher query"),
 			network: zod.string().describe(NETWORK_DESCRIPTION)
@@ -426,11 +427,11 @@ function registerLocalPrompts(server, remotePromptNames) {
 		query,
 		"```",
 		"",
-		"Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts. Return full address properties; never shorten addresses with ellipses."
+		"Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment. Return full address properties; never shorten addresses with ellipses."
 	].join("\n"), "Federated graph query"));
 	server.registerPrompt("graph-query-batch", {
 		title: "Federated Graph Query Batch",
-		description: "Run related read-only GQL/Cypher queries through Chain Insights Memgraph Zero in one paid batch.",
+		description: "Run related read-only GQL/Cypher queries through the Chain Insights graph endpoint in one paid batch.",
 		argsSchema: {
 			queries: zod.string().describe("JSON array of query objects with optional id and required query fields"),
 			network: zod.string().describe(NETWORK_DESCRIPTION),
@@ -444,7 +445,7 @@ function registerLocalPrompts(server, remotePromptNames) {
 		"```",
 		per_query_timeout_seconds ? `per_query_timeout_seconds: ${per_query_timeout_seconds}` : "",
 		"",
-		"Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts. Return full address properties; never shorten addresses with ellipses."
+		"Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment. Return full address properties; never shorten addresses with ellipses."
 	].filter(Boolean).join("\n"), "Federated graph batch query"));
 	server.registerPrompt("balance", {
 		title: "Wallet Balance",
@@ -529,8 +530,8 @@ async function normalizeRemoteToolResult(result, config, toolName = "remote-grap
 	const graphPayload = getRemoteGraphPayload(result);
 	const meta = { ...result._meta ?? {} };
 	if (graphPayload) {
-		const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-DU05YCei.cjs"));
-		const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-DoxJ7fCx.cjs"));
+		const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-B3mkLP8Z.cjs"));
+		const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-B-3ho4bk.cjs"));
 		const report = await writeGraphReport(graphPayload, {
 			serverPort: config.serverPort,
 			slug: toolName || "remote-graph"
@@ -559,10 +560,10 @@ async function normalizeRemoteToolResult(result, config, toolName = "remote-grap
 * All diagnostic output goes to console.error() or process.stderr.write().
 */
 async function createProxy() {
-	const { loadConfig } = await Promise.resolve().then(() => require("./config-Bmdl5hdk.cjs")).then((n) => n.config_exports);
-	const { activeDataDir, findActiveWorkspace } = await Promise.resolve().then(() => require("./active-Dv7Tu-O4.cjs")).then((n) => n.active_exports);
-	const { createConfiguredGraphMcpFetch, resolveGraphMcpEndpoint } = await Promise.resolve().then(() => require("./client-D4fZgIaO.cjs")).then((n) => n.client_exports);
-	const { loadSchema, saveSchema } = await Promise.resolve().then(() => require("./schema-cache-CgWRCN2N.cjs"));
+	const { loadConfig } = await Promise.resolve().then(() => require("./config-BhYbhLDI.cjs")).then((n) => n.config_exports);
+	const { activeDataDir, findActiveWorkspace } = await Promise.resolve().then(() => require("./active-BVr55kvW.cjs")).then((n) => n.active_exports);
+	const { createConfiguredGraphMcpFetch, resolveGraphMcpEndpoint } = await Promise.resolve().then(() => require("./client-DPc2eyVN.cjs")).then((n) => n.client_exports);
+	const { loadSchema, saveSchema } = await Promise.resolve().then(() => require("./schema-cache-CJk1EL3L.cjs"));
 	const loadedConfig = await loadConfig();
 	const activeWorkspace = findActiveWorkspace();
 	const config = {
@@ -672,7 +673,7 @@ async function createProxy() {
 		inputSchema: zod.object({}).passthrough()
 	}, async () => {
 		try {
-			const { getWalletAccount, getWalletBalanceText } = await Promise.resolve().then(() => require("./tools-f_vJUZAF.cjs")).then((n) => n.tools_exports);
+			const { getWalletAccount, getWalletBalanceText } = await Promise.resolve().then(() => require("./tools-DY8h0WbE.cjs")).then((n) => n.tools_exports);
 			return {
 				content: [{
 					type: "text",
@@ -720,13 +721,13 @@ async function createProxy() {
 		}
 	}, async ({ name, tags, description }) => {
 		try {
-			const { CaseStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { CaseStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			const created = await CaseStore.create({
 				name,
 				tags: parseTags(tags),
 				description: description ?? ""
 			});
-			const { casesRoot } = await Promise.resolve().then(() => require("./store-BiUhQOIf.cjs"));
+			const { casesRoot } = await Promise.resolve().then(() => require("./store-DogLawSj.cjs"));
 			return {
 				content: [{
 					type: "text",
@@ -760,7 +761,7 @@ async function createProxy() {
 		}
 	}, async ({ status }) => {
 		try {
-			const { CaseStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { CaseStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			const cases = await CaseStore.list();
 			const filtered = status ? cases.filter((entry) => entry.status === status) : cases;
 			return {
@@ -785,7 +786,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id }) => {
 		try {
-			const { CaseStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { CaseStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			const context = await CaseStore.loadContext(case_id);
 			return {
 				content: [{
@@ -814,7 +815,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id, source, content, query_params }) => {
 		try {
-			const { EvidenceStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { EvidenceStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			const saved = await EvidenceStore.append(case_id, {
 				source,
 				content,
@@ -842,7 +843,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id }) => {
 		try {
-			const { EvidenceStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { EvidenceStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			const result = await EvidenceStore.verifyManifest(case_id);
 			return {
 				content: [{
@@ -877,7 +878,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id, address, finding, entity_type }) => {
 		try {
-			const { DossierStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { DossierStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			await DossierStore.appendFinding(case_id, address, finding, entity_type ?? "unknown");
 			return {
 				content: [{
@@ -905,7 +906,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id }) => {
 		try {
-			const { SessionStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { SessionStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			const session = await SessionStore.start(case_id);
 			return {
 				content: [{
@@ -933,7 +934,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id, findings, next_steps }) => {
 		try {
-			const { SessionStore } = await Promise.resolve().then(() => require("./cases-CDcNU91B.cjs"));
+			const { SessionStore } = await Promise.resolve().then(() => require("./cases-c0iV-XLI.cjs"));
 			await SessionStore.end(case_id, {
 				findings: findings ?? "",
 				nextSteps: next_steps ?? ""
@@ -978,9 +979,9 @@ async function createProxy() {
 				}],
 				isError: true
 			};
-			const { addressRisk } = await Promise.resolve().then(() => require("./public-tools-XSpkz2ky.cjs"));
-			const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-DU05YCei.cjs"));
-			const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-DoxJ7fCx.cjs"));
+			const { addressRisk } = await Promise.resolve().then(() => require("./public-tools-V7ON7goq.cjs"));
+			const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-B3mkLP8Z.cjs"));
+			const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-B-3ho4bk.cjs"));
 			const result = await addressRisk(remoteClient, {
 				address,
 				network,
@@ -1004,6 +1005,13 @@ async function createProxy() {
 				isError: false
 			};
 		} catch (err) {
+			if (err instanceof require_client.PaymentRequiredError) return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
 			return {
 				content: [{
 					type: "text",
@@ -1042,9 +1050,9 @@ async function createProxy() {
 				}],
 				isError: true
 			};
-			const { trackFunds } = await Promise.resolve().then(() => require("./public-tools-XSpkz2ky.cjs"));
-			const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-DU05YCei.cjs"));
-			const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-DoxJ7fCx.cjs"));
+			const { trackFunds } = await Promise.resolve().then(() => require("./public-tools-V7ON7goq.cjs"));
+			const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-B3mkLP8Z.cjs"));
+			const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-B-3ho4bk.cjs"));
 			const result = await trackFunds(remoteClient, config, {
 				trustedAddresses: trusted_addresses,
 				untrustedAddresses: untrusted_addresses,
@@ -1072,6 +1080,13 @@ async function createProxy() {
 				isError: false
 			};
 		} catch (err) {
+			if (err instanceof require_client.PaymentRequiredError) return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
 			return {
 				content: [{
 					type: "text",
@@ -1108,9 +1123,9 @@ async function createProxy() {
 				}],
 				isError: true
 			};
-			const { scamTopology } = await Promise.resolve().then(() => require("./public-tools-XSpkz2ky.cjs"));
-			const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-DU05YCei.cjs"));
-			const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-DoxJ7fCx.cjs"));
+			const { scamTopology } = await Promise.resolve().then(() => require("./public-tools-V7ON7goq.cjs"));
+			const { writeGraphReport } = await Promise.resolve().then(() => require("./graph-reports-B3mkLP8Z.cjs"));
+			const { ensureArtifactServer } = await Promise.resolve().then(() => require("./artifact-server-B-3ho4bk.cjs"));
 			const result = await scamTopology(remoteClient, config, {
 				victimAddress: victim_address,
 				network,
@@ -1137,6 +1152,13 @@ async function createProxy() {
 				isError: false
 			};
 		} catch (err) {
+			if (err instanceof require_client.PaymentRequiredError) return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
 			return {
 				content: [{
 					type: "text",
@@ -1214,10 +1236,25 @@ async function createProxy() {
 				const requestOptions = remoteToolRequestOptions(tool.name);
 				return await normalizeRemoteToolResult(requestOptions ? await remoteClient.callTool(request, void 0, requestOptions) : await remoteClient.callTool(request), config, tool.name);
 			} catch (err) {
+				if (err instanceof require_client.PaymentRequiredError) return {
+					content: [{
+						type: "text",
+						text: err.message
+					}],
+					isError: true
+				};
+				const msg = err.message ?? String(err);
+				if (/\b402\b/.test(msg) || msg.toLowerCase().includes("payment")) return {
+					content: [{
+						type: "text",
+						text: `Payment required for ${tool.name}. This tool costs USDC on Base via x402 micropayments. Next steps: run \`chain-insights wallet topup\` to fund your wallet with USDC on Base, or \`chain-insights access-key set <key>\` if you have been given test access.`
+					}],
+					isError: true
+				};
 				return {
 					content: [{
 						type: "text",
-						text: `MCP call failed: ${err.message}`
+						text: `MCP call failed: ${msg}`
 					}],
 					isError: true
 				};

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;AA2wBA;;;;;;iBAAsB,WAAA,CAAA,GAAe,OAAA"}
+{"version":3,"file":"mcp-proxy.d.cts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;AA4wBA;;;;AAA4C;;iBAAtB,WAAA,CAAA,GAAe,OAAO"}

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

@@ -1 +1 @@
-{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;AA2wBA;;;;;;iBAAsB,WAAA,CAAA,GAAe,OAAA"}
+{"version":3,"file":"mcp-proxy.d.mts","names":[],"sources":["../src/mcp/proxy.ts"],"mappings":";;AA4wBA;;;;AAA4C;;iBAAtB,WAAA,CAAA,GAAe,OAAO"}

package/dist/mcp-proxy.mjs

@@ -1,5 +1,6 @@
-import { n as PACKAGE_VERSION } from "./version-1gP19Lhi.mjs";
-import { t as HIDDEN_REMOTE_TOOL_NAMES } from "./tool-visibility-3Z_KvO9Q.mjs";
+import { n as PACKAGE_VERSION } from "./version-BA3J8hu4.mjs";
+import { t as PaymentRequiredError } from "./client-D4_hd4AP.mjs";
+import { t as HIDDEN_REMOTE_TOOL_NAMES } from "./tool-visibility-BHRFLXuU.mjs";
 import { fileURLToPath } from "node:url";
 import path from "node:path";
 import { readFileSync } from "node:fs";
@@ -54,7 +55,7 @@ const KNOWN_PUBLIC_TOOL_DESCRIPTIONS = {
 	address_risk: "Screen one full blockchain address for AML risk, behavior patterns, neighborhood context, exchange exposure, and optional comparison with compare_address. This includes the exchange-behavior analysis formerly covered by money_flows_between_exchanges. Use this as the first tool for a single-address investigation. The tool returns an investigator-ready summary; preserve full addresses exactly.",
 	scam_topology: "Build victim-incident laundering topology from one victim/source address and the earliest known incident timestamp. Traversal uses one explicit activity policy: node_relative_only by default, or global_incident_only when requested. Repeated targets are kept as non-expanding convergence edges. Returns ML-ready scam_labels plus review context and a track_funds-compatible graph report: primary flows, deposits, reverse_leads. Victims, exchange endpoints, and generic labeled context nodes are not automatic scam labels; preserve full addresses exactly.",
 	track_funds: "Trace funds from trusted victim/source addresses through intermediaries to exchange deposit addresses. Use this when the user has a victim/source address or known untrusted/scammer addresses. The tool returns an investigator-ready fund-flow report and recommended next actions.",
-	graph_query: "Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts. Cross-backend correlated joins are limited by current MemGQL behavior; preserve full addresses exactly.",
+	graph_query: "Run a read-only GQL/Cypher query through the Chain Insights graph endpoint. Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment. Cross-layer correlated joins may be limited by the active graph endpoint; preserve full addresses exactly.",
 	graph_query_batch: "Run multiple read-only GQL/Cypher queries through the Chain Insights graph endpoint in one paid batch. Prefer this for related topology/facts reads."
 };
 const NETWORK_DESCRIPTION = "Required network to query. Do not guess; use network_capabilities or ask the user if missing.";
@@ -76,12 +77,12 @@ const GRAPH_SCHEMA_HINTS = [
 	"- Risk and ML properties may appear as live hints, but source-of-truth risk rows are RiskScore facts.",
 	"- Common relationships include FLOWS_TO, OPERATED_FROM, SERVED_FROM, REGISTERED_NEURON, BELONGS_TO, SYBIL_CLUSTER, LAYERING_HOP, BURST_ACTIVITY, CYCLE_PARTICIPANT, SMURFING_CLUSTER.",
 	"- FLOWS_TO properties are scoped to the selected topology graph and commonly carry amount_sum, amount_usd_sum, tx_count, first_seen_timestamp, last_seen_timestamp, first_tx_id, last_tx_id. Confirm available fields through runtime schema before relying on them.",
-	"- Start schema discovery with MemGQL-safe property reads: MATCH (n:Address) WHERE n.address IS NOT NULL RETURN n.labels AS labels, n.address AS address LIMIT 20",
+	"- Start schema discovery with endpoint-safe property reads: MATCH (n:Address) WHERE n.address IS NOT NULL RETURN n.labels AS labels, n.address AS address LIMIT 20",
 	"- Relationship discovery: MATCH (:Address)-[r:FLOWS_TO]->(:Address) RETURN r.amount_sum AS amount_sum, r.amount_usd_sum AS amount_usd_sum LIMIT 20",
-	"- graph_query uses Memgraph Zero / MemGQL when available. Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts.",
+	"- graph_query uses the active Chain Insights graph endpoint. Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment.",
 	"- Archive topology labels include Address and TopologySnapshot. Archived money-flow topology is represented as (:Address)-[:FLOWS_TO]->(:Address) relationships with period_granularity, period_start_date, and period_end_date.",
 	"- All graph_query calls are read-only. Never use CREATE, INSERT, MERGE, SET, DELETE, REMOVE, DROP, DETACH, ADD, CONNECT, DISCONNECT, ALTER, TRUNCATE, GRANT, or REVOKE.",
-	"- Warehouse facts live behind facts_*_view StarRocks views and are reached through USE facts graph patterns. Do not query core_*, ml_*, analyzers_*, synthetics_*, or _* tables directly."
+	"- Use USE facts graph patterns for fact and enrichment reads. Do not query internal table namespaces directly."
 ].join("\n");
 const GRAPH_REPORT_HINTS = [
 	"Graph visualization behavior:",
@@ -154,7 +155,7 @@ function knownPublicToolInputSchema(toolName) {
 			case_id: z.string().optional().describe("Optional Chain Insights case ID. When provided, compact evidence is appended to the case manifest.")
 		};
 		case "graph_query": return {
-			query: z.string().min(1).describe("Read-only GQL/Cypher query. Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts."),
+			query: z.string().min(1).describe("Read-only GQL/Cypher query. Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment."),
 			network: z.string().min(1).describe(NETWORK_DESCRIPTION)
 		};
 		case "graph_query_batch": return {
@@ -410,7 +411,7 @@ function registerLocalPrompts(server, remotePromptNames) {
 	});
 	server.registerPrompt("graph-query", {
 		title: "Federated Graph Query",
-		description: "Run a read-only GQL/Cypher query through Chain Insights Memgraph Zero.",
+		description: "Run a read-only GQL/Cypher query through the Chain Insights graph endpoint.",
 		argsSchema: {
 			query: z.string().describe("Read-only GQL/Cypher query"),
 			network: z.string().describe(NETWORK_DESCRIPTION)
@@ -422,11 +423,11 @@ function registerLocalPrompts(server, remotePromptNames) {
 		query,
 		"```",
 		"",
-		"Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts. Return full address properties; never shorten addresses with ellipses."
+		"Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment. Return full address properties; never shorten addresses with ellipses."
 	].join("\n"), "Federated graph query"));
 	server.registerPrompt("graph-query-batch", {
 		title: "Federated Graph Query Batch",
-		description: "Run related read-only GQL/Cypher queries through Chain Insights Memgraph Zero in one paid batch.",
+		description: "Run related read-only GQL/Cypher queries through the Chain Insights graph endpoint in one paid batch.",
 		argsSchema: {
 			queries: z.string().describe("JSON array of query objects with optional id and required query fields"),
 			network: z.string().describe(NETWORK_DESCRIPTION),
@@ -440,7 +441,7 @@ function registerLocalPrompts(server, remotePromptNames) {
 		"```",
 		per_query_timeout_seconds ? `per_query_timeout_seconds: ${per_query_timeout_seconds}` : "",
 		"",
-		"Use USE live_topology for Memgraph RAM topology, USE archive_topology for StarRocks historical topology, and USE facts for StarRocks facts. Return full address properties; never shorten addresses with ellipses."
+		"Use USE live_topology for recent topology, USE archive_topology for historical topology, and USE facts for labels, features, risk scores, assets, and enrichment. Return full address properties; never shorten addresses with ellipses."
 	].filter(Boolean).join("\n"), "Federated graph batch query"));
 	server.registerPrompt("balance", {
 		title: "Wallet Balance",
@@ -525,8 +526,8 @@ async function normalizeRemoteToolResult(result, config, toolName = "remote-grap
 	const graphPayload = getRemoteGraphPayload(result);
 	const meta = { ...result._meta ?? {} };
 	if (graphPayload) {
-		const { writeGraphReport } = await import("./graph-reports-C4TBjCkM.mjs");
-		const { ensureArtifactServer } = await import("./artifact-server-Dxz5YbuQ.mjs");
+		const { writeGraphReport } = await import("./graph-reports-BDELxmpi.mjs");
+		const { ensureArtifactServer } = await import("./artifact-server-4DiMvwhC.mjs");
 		const report = await writeGraphReport(graphPayload, {
 			serverPort: config.serverPort,
 			slug: toolName || "remote-graph"
@@ -555,10 +556,10 @@ async function normalizeRemoteToolResult(result, config, toolName = "remote-grap
 * All diagnostic output goes to console.error() or process.stderr.write().
 */
 async function createProxy() {
-	const { loadConfig } = await import("./config-BwrBYmiC.mjs").then((n) => n.t);
-	const { activeDataDir, findActiveWorkspace } = await import("./active-BSrxLKwn.mjs").then((n) => n.n);
-	const { createConfiguredGraphMcpFetch, resolveGraphMcpEndpoint } = await import("./client-D4Bq0rp9.mjs").then((n) => n.t);
-	const { loadSchema, saveSchema } = await import("./schema-cache-9CksD7tX.mjs");
+	const { loadConfig } = await import("./config-9KYXaAv-.mjs").then((n) => n.t);
+	const { activeDataDir, findActiveWorkspace } = await import("./active-ByNgjuAg.mjs").then((n) => n.n);
+	const { createConfiguredGraphMcpFetch, resolveGraphMcpEndpoint } = await import("./client-D4_hd4AP.mjs").then((n) => n.n);
+	const { loadSchema, saveSchema } = await import("./schema-cache-DwDvPy4e.mjs");
 	const loadedConfig = await loadConfig();
 	const activeWorkspace = findActiveWorkspace();
 	const config = {
@@ -668,7 +669,7 @@ async function createProxy() {
 		inputSchema: z.object({}).passthrough()
 	}, async () => {
 		try {
-			const { getWalletAccount, getWalletBalanceText } = await import("./tools-Cp2jAAAb.mjs").then((n) => n.s);
+			const { getWalletAccount, getWalletBalanceText } = await import("./tools-Py6SXg6J.mjs").then((n) => n.s);
 			return {
 				content: [{
 					type: "text",
@@ -716,13 +717,13 @@ async function createProxy() {
 		}
 	}, async ({ name, tags, description }) => {
 		try {
-			const { CaseStore } = await import("./cases-By7INiOa.mjs");
+			const { CaseStore } = await import("./cases-qjPtbnUd.mjs");
 			const created = await CaseStore.create({
 				name,
 				tags: parseTags(tags),
 				description: description ?? ""
 			});
-			const { casesRoot } = await import("./store-BoWE-Gtl.mjs");
+			const { casesRoot } = await import("./store-BT2SCcQr.mjs");
 			return {
 				content: [{
 					type: "text",
@@ -756,7 +757,7 @@ async function createProxy() {
 		}
 	}, async ({ status }) => {
 		try {
-			const { CaseStore } = await import("./cases-By7INiOa.mjs");
+			const { CaseStore } = await import("./cases-qjPtbnUd.mjs");
 			const cases = await CaseStore.list();
 			const filtered = status ? cases.filter((entry) => entry.status === status) : cases;
 			return {
@@ -781,7 +782,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id }) => {
 		try {
-			const { CaseStore } = await import("./cases-By7INiOa.mjs");
+			const { CaseStore } = await import("./cases-qjPtbnUd.mjs");
 			const context = await CaseStore.loadContext(case_id);
 			return {
 				content: [{
@@ -810,7 +811,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id, source, content, query_params }) => {
 		try {
-			const { EvidenceStore } = await import("./cases-By7INiOa.mjs");
+			const { EvidenceStore } = await import("./cases-qjPtbnUd.mjs");
 			const saved = await EvidenceStore.append(case_id, {
 				source,
 				content,
@@ -838,7 +839,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id }) => {
 		try {
-			const { EvidenceStore } = await import("./cases-By7INiOa.mjs");
+			const { EvidenceStore } = await import("./cases-qjPtbnUd.mjs");
 			const result = await EvidenceStore.verifyManifest(case_id);
 			return {
 				content: [{
@@ -873,7 +874,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id, address, finding, entity_type }) => {
 		try {
-			const { DossierStore } = await import("./cases-By7INiOa.mjs");
+			const { DossierStore } = await import("./cases-qjPtbnUd.mjs");
 			await DossierStore.appendFinding(case_id, address, finding, entity_type ?? "unknown");
 			return {
 				content: [{
@@ -901,7 +902,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id }) => {
 		try {
-			const { SessionStore } = await import("./cases-By7INiOa.mjs");
+			const { SessionStore } = await import("./cases-qjPtbnUd.mjs");
 			const session = await SessionStore.start(case_id);
 			return {
 				content: [{
@@ -929,7 +930,7 @@ async function createProxy() {
 		}
 	}, async ({ case_id, findings, next_steps }) => {
 		try {
-			const { SessionStore } = await import("./cases-By7INiOa.mjs");
+			const { SessionStore } = await import("./cases-qjPtbnUd.mjs");
 			await SessionStore.end(case_id, {
 				findings: findings ?? "",
 				nextSteps: next_steps ?? ""
@@ -974,9 +975,9 @@ async function createProxy() {
 				}],
 				isError: true
 			};
-			const { addressRisk } = await import("./public-tools-D4UI-Zb0.mjs");
-			const { writeGraphReport } = await import("./graph-reports-C4TBjCkM.mjs");
-			const { ensureArtifactServer } = await import("./artifact-server-Dxz5YbuQ.mjs");
+			const { addressRisk } = await import("./public-tools-D6Q5MTcO.mjs");
+			const { writeGraphReport } = await import("./graph-reports-BDELxmpi.mjs");
+			const { ensureArtifactServer } = await import("./artifact-server-4DiMvwhC.mjs");
 			const result = await addressRisk(remoteClient, {
 				address,
 				network,
@@ -1000,6 +1001,13 @@ async function createProxy() {
 				isError: false
 			};
 		} catch (err) {
+			if (err instanceof PaymentRequiredError) return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
 			return {
 				content: [{
 					type: "text",
@@ -1038,9 +1046,9 @@ async function createProxy() {
 				}],
 				isError: true
 			};
-			const { trackFunds } = await import("./public-tools-D4UI-Zb0.mjs");
-			const { writeGraphReport } = await import("./graph-reports-C4TBjCkM.mjs");
-			const { ensureArtifactServer } = await import("./artifact-server-Dxz5YbuQ.mjs");
+			const { trackFunds } = await import("./public-tools-D6Q5MTcO.mjs");
+			const { writeGraphReport } = await import("./graph-reports-BDELxmpi.mjs");
+			const { ensureArtifactServer } = await import("./artifact-server-4DiMvwhC.mjs");
 			const result = await trackFunds(remoteClient, config, {
 				trustedAddresses: trusted_addresses,
 				untrustedAddresses: untrusted_addresses,
@@ -1068,6 +1076,13 @@ async function createProxy() {
 				isError: false
 			};
 		} catch (err) {
+			if (err instanceof PaymentRequiredError) return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
 			return {
 				content: [{
 					type: "text",
@@ -1104,9 +1119,9 @@ async function createProxy() {
 				}],
 				isError: true
 			};
-			const { scamTopology } = await import("./public-tools-D4UI-Zb0.mjs");
-			const { writeGraphReport } = await import("./graph-reports-C4TBjCkM.mjs");
-			const { ensureArtifactServer } = await import("./artifact-server-Dxz5YbuQ.mjs");
+			const { scamTopology } = await import("./public-tools-D6Q5MTcO.mjs");
+			const { writeGraphReport } = await import("./graph-reports-BDELxmpi.mjs");
+			const { ensureArtifactServer } = await import("./artifact-server-4DiMvwhC.mjs");
 			const result = await scamTopology(remoteClient, config, {
 				victimAddress: victim_address,
 				network,
@@ -1133,6 +1148,13 @@ async function createProxy() {
 				isError: false
 			};
 		} catch (err) {
+			if (err instanceof PaymentRequiredError) return {
+				content: [{
+					type: "text",
+					text: err.message
+				}],
+				isError: true
+			};
 			return {
 				content: [{
 					type: "text",
@@ -1210,10 +1232,25 @@ async function createProxy() {
 				const requestOptions = remoteToolRequestOptions(tool.name);
 				return await normalizeRemoteToolResult(requestOptions ? await remoteClient.callTool(request, void 0, requestOptions) : await remoteClient.callTool(request), config, tool.name);
 			} catch (err) {
+				if (err instanceof PaymentRequiredError) return {
+					content: [{
+						type: "text",
+						text: err.message
+					}],
+					isError: true
+				};
+				const msg = err.message ?? String(err);
+				if (/\b402\b/.test(msg) || msg.toLowerCase().includes("payment")) return {
+					content: [{
+						type: "text",
+						text: `Payment required for ${tool.name}. This tool costs USDC on Base via x402 micropayments. Next steps: run \`chain-insights wallet topup\` to fund your wallet with USDC on Base, or \`chain-insights access-key set <key>\` if you have been given test access.`
+					}],
+					isError: true
+				};
 				return {
 					content: [{
 						type: "text",
-						text: `MCP call failed: ${err.message}`
+						text: `MCP call failed: ${msg}`
 					}],
 					isError: true
 				};