chain-insights 0.24.0 → 0.24.2

package/README.md

@@ -23,11 +23,11 @@ as-is on macOS; on Windows use WSL.
 npx chain-insights@latest --help   # run without installing
 npm install -g chain-insights      # or install the cia CLI globally
 cia mcp call aml_address_risk network=robinhood address=0xYourAddressHere
-cia networks                       # all supported networks
+cia networks                       # network status + dataset overview
 cia network robinhood              # details for one network
 ```
 
-Sixty seconds gets you the CLI and the live tool catalog.
+Sixty seconds gets you the CLI, a network overview, and the remote tool catalog.
 To call the same tools from an agent, register the MCP proxy:
 `cia setup claude-code` (or `codex` / `hermes`).
 
@@ -327,13 +327,16 @@ Health checks (each is runnable):
 # Configured endpoint
 cia config get graphMcpEndpoint
 
-# Endpoint reachable, networks listed
+# User-facing network overview
+cia networks
+
+# Detailed Chain Insights capability matrix
 cia mcp networks
 
 # Caller allowance / metering status
 cia mcp call meta_usage_status
 
-# Fresh tool discovery
+# Fresh remote tool discovery
 cia mcp tools --refresh
 
 # Installed CLI sanity

package/dist/{capabilities-BPnw6nP_.mjs → capabilities-CY3Ok5ls.mjs}

@@ -7,6 +7,7 @@ var capabilities_exports = /* @__PURE__ */ __exportAll({
 	findNetworkCapability: () => findNetworkCapability,
 	formatNetworkCapabilities: () => formatNetworkCapabilities,
 	formatNetworkCapability: () => formatNetworkCapability,
+	formatNetworkOverview: () => formatNetworkOverview,
 	mirrorGraphNetworkCapabilities: () => mirrorGraphNetworkCapabilities
 });
 const PUBLIC_CHAIN_INSIGHTS_TOOL_STATUS = {
@@ -99,31 +100,54 @@ function datasetLabel(network) {
 	if (dateRange === "") return blockRange;
 	return `${blockRange} / ${dateRange}`;
 }
+function displayName(network) {
+	return network.display_name || network.network;
+}
+function statusLabel(network) {
+	return network.default ? `${network.status} (default)` : network.status;
+}
+function formatTable(headers, rows, minimumWidths) {
+	const widths = headers.map((header, index) => Math.max(minimumWidths[index] ?? 0, header.length, ...rows.map((row) => row[index]?.length ?? 0)));
+	const row = (values) => values.map((value, index) => value.padEnd(widths[index])).join("  ");
+	return [
+		row(headers),
+		widths.map((width) => "-".repeat(width)).join("  "),
+		...rows.map(row)
+	].join("\n");
+}
+function formatNetworkOverview(document) {
+	if (document.networks.length === 0) return "No supported networks advertised.";
+	return formatTable([
+		"Network",
+		"Status",
+		"Dataset"
+	], document.networks.map((network) => [
+		displayName(network),
+		statusLabel(network),
+		datasetLabel(network)
+	]), [
+		14,
+		10,
+		38
+	]);
+}
 function formatNetworkCapabilities(document) {
 	if (document.networks.length === 0) return "No supported networks advertised.";
-	const headers = [
+	return formatTable([
 		"Network",
 		"Dataset",
-		"Available tools"
-	];
-	const widths = [
+		"Chain Insights tools"
+	], document.networks.flatMap((network) => {
+		return availableToolLines(network).map((toolLine, index) => [
+			index === 0 ? displayName(network) : "",
+			index === 0 ? datasetLabel(network) : "",
+			toolLine
+		]);
+	}), [
 		14,
 		38,
 		64
-	];
-	const row = (values) => values.map((value, index) => value.padEnd(widths[index])).join("  ");
-	const networkRows = document.networks.flatMap((network) => {
-		return availableToolLines(network).map((toolLine, index) => row([
-			index === 0 ? network.display_name || network.network : "",
-			index === 0 ? datasetLabel(network) : "",
-			toolLine
-		]));
-	});
-	return [
-		row(headers),
-		widths.map((width) => "-".repeat(width)).join("  "),
-		...networkRows
-	].join("\n");
+	]);
 }
 function findNetworkCapability(document, name) {
 	const normalizedName = name.trim().toLowerCase();
@@ -144,4 +168,4 @@ function formatNetworkCapability(network) {
 //#endregion
 export { mirrorGraphNetworkCapabilities as n, capabilities_exports as t };
 
-//# sourceMappingURL=capabilities-BPnw6nP_.mjs.map
+//# sourceMappingURL=capabilities-CY3Ok5ls.mjs.map

package/dist/capabilities-CY3Ok5ls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities-CY3Ok5ls.mjs","names":[],"sources":["../src/mcp/capabilities.ts"],"sourcesContent":["import type { InvestigatorConfig } from '../config/schema.js'\nimport { applyMcpAuthHeaders, resolveGraphMcpEndpoint } from './client.js'\n\nexport interface NetworkTopologyLayer {\n  enabled: boolean\n  coverage?: {\n    from_block?: number\n    to_block?: number\n    from_timestamp?: string\n    to_timestamp?: string\n    chain_tip_block?: number\n    blocks_behind_tip?: number\n  }\n}\n\nexport interface NetworkLayerCapability {\n  enabled: boolean\n  live?: NetworkTopologyLayer\n  archive?: NetworkTopologyLayer\n}\n\nexport interface NetworkCapability {\n  network: string\n  display_name?: string\n  status: string\n  default?: boolean\n  layers: Record<string, NetworkLayerCapability>\n  tools: Record<string, string>\n  coverage?: {\n    from_block?: number\n    to_block?: number\n    from_timestamp?: string\n    to_timestamp?: string\n    chain_tip_block?: number\n    blocks_behind_tip?: number\n  }\n  freshness?: {\n    last_processed_at?: string\n    last_successful_sync_at?: string\n    max_data_age_seconds?: number\n    last_processing_duration_seconds?: number\n  }\n}\n\nexport interface NetworkCapabilitiesDocument {\n  schema: 'chain-insights.network-capabilities.v1'\n  networks: NetworkCapability[]\n}\n\nexport const PUBLIC_CHAIN_INSIGHTS_TOOL_STATUS = {\n  aml_address_risk: 'available',\n  graph_query: 'available',\n  graph_query_batch: 'available',\n  meta_network_capabilities: 'available',\n  meta_usage_status: 'available',\n  meta_help: 'available',\n  wallet_balance: 'available',\n} as const\nconst AVAILABLE_TOOLS_PER_LINE = 3\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === 'object' && value !== null && !Array.isArray(value)\n}\n\nfunction advertisedNetwork(raw: unknown): NetworkCapability | null {\n  if (!isRecord(raw) || typeof raw.network !== 'string' || raw.network.trim() === '') {\n    return null\n  }\n  const network = raw.network.trim()\n  const capability: NetworkCapability = {\n    network,\n    display_name:\n      typeof raw.display_name === 'string' && raw.display_name.trim() !== ''\n        ? raw.display_name\n        : network,\n    status: typeof raw.status === 'string' && raw.status.trim() !== '' ? raw.status : 'live',\n    layers: {},\n    tools: { ...PUBLIC_CHAIN_INSIGHTS_TOOL_STATUS },\n  }\n  if (raw.default === true) capability.default = true\n  if (raw.default === false) capability.default = false\n  if (isRecord(raw.coverage)) capability.coverage = raw.coverage as NetworkCapability['coverage']\n  if (isRecord(raw.freshness))\n    capability.freshness = raw.freshness as NetworkCapability['freshness']\n  return capability\n}\n\n/** Repeat GraphRAG's network list. CIA does not add, drop, or invent names. */\nexport function mirrorGraphNetworkCapabilities(document: {\n  networks: unknown[]\n}): NetworkCapabilitiesDocument {\n  return {\n    schema: 'chain-insights.network-capabilities.v1',\n    networks: document.networks\n      .map((network) => advertisedNetwork(network))\n      .filter((network): network is NetworkCapability => network !== null),\n  }\n}\n\nfunction publicNetworkCapabilities(\n  document: NetworkCapabilitiesDocument\n): NetworkCapabilitiesDocument {\n  return mirrorGraphNetworkCapabilities(document)\n}\n\nfunction metadataNetworksUrl(endpoint: string): URL {\n  const url = new URL(endpoint)\n  url.pathname = '/metadata/networks'\n  url.search = ''\n  url.hash = ''\n  return url\n}\n\nexport async function fetchNetworkCapabilities(\n  config: Pick<InvestigatorConfig, 'graphMcpAuthToken' | 'graphMcpMode' | 'graphMcpEndpoint'>\n): Promise<NetworkCapabilitiesDocument> {\n  const endpoint = resolveGraphMcpEndpoint(config)\n  const request = metadataNetworksUrl(endpoint)\n  const headers = new Headers()\n  const token = config.graphMcpAuthToken?.trim()\n  if (token) {\n    applyMcpAuthHeaders(headers, token)\n  }\n  let response: Response\n  try {\n    response = await fetch(request, { headers })\n  } catch (err) {\n    throw new Error(`network capabilities unavailable at ${request}: ${(err as Error).message}`)\n  }\n  if (!response.ok) {\n    throw new Error(`network capabilities unavailable at ${request}: HTTP ${response.status}`)\n  }\n  const parsed = (await response.json()) as NetworkCapabilitiesDocument\n  if (\n    parsed.schema !== 'chain-insights.network-capabilities.v1' ||\n    !Array.isArray(parsed.networks)\n  ) {\n    throw new Error('network capabilities response has unsupported schema')\n  }\n  return publicNetworkCapabilities(parsed)\n}\n\nfunction availableTools(network: NetworkCapability): string[] {\n  const effectiveTools = {\n    ...(network.tools ?? {}),\n    ...PUBLIC_CHAIN_INSIGHTS_TOOL_STATUS,\n  }\n  const tools = Object.entries(effectiveTools)\n    .filter(([, status]) => status === 'available')\n    .map(([name]) => name)\n  return tools.sort()\n}\n\nfunction availableToolLines(network: NetworkCapability): string[] {\n  const tools = availableTools(network)\n  if (tools.length === 0) return ['none']\n  const lines: string[] = []\n  for (let index = 0; index < tools.length; index += AVAILABLE_TOOLS_PER_LINE) {\n    lines.push(tools.slice(index, index + AVAILABLE_TOOLS_PER_LINE).join(', '))\n  }\n  return lines\n}\n\nfunction shortDate(value?: string): string {\n  if (!value) return ''\n  return value.slice(0, 10)\n}\n\nfunction datasetLabel(network: NetworkCapability): string {\n  const coverage = network.coverage\n  if (!coverage) return 'unknown'\n  const blockRange =\n    coverage.from_block !== undefined && coverage.to_block !== undefined\n      ? `${coverage.from_block}..${coverage.to_block}`\n      : 'blocks unknown'\n  const dateRange =\n    coverage.from_timestamp && coverage.to_timestamp\n      ? `${shortDate(coverage.from_timestamp)}..${shortDate(coverage.to_timestamp)}`\n      : ''\n  if (blockRange === 'blocks unknown' && dateRange === '') return 'unknown'\n  if (blockRange === 'blocks unknown') return dateRange\n  if (dateRange === '') return blockRange\n  return `${blockRange} / ${dateRange}`\n}\n\nfunction displayName(network: NetworkCapability): string {\n  return network.display_name || network.network\n}\n\nfunction statusLabel(network: NetworkCapability): string {\n  return network.default ? `${network.status} (default)` : network.status\n}\n\nfunction formatTable(headers: string[], rows: string[][], minimumWidths: number[]): string {\n  const widths = headers.map((header, index) =>\n    Math.max(\n      minimumWidths[index] ?? 0,\n      header.length,\n      ...rows.map((row) => row[index]?.length ?? 0)\n    )\n  )\n  const row = (values: string[]) =>\n    values.map((value, index) => value.padEnd(widths[index]!)).join('  ')\n  return [row(headers), widths.map((width) => '-'.repeat(width)).join('  '), ...rows.map(row)].join(\n    '\\n'\n  )\n}\n\nexport function formatNetworkOverview(document: NetworkCapabilitiesDocument): string {\n  if (document.networks.length === 0) return 'No supported networks advertised.'\n  const rows = document.networks.map((network) => [\n    displayName(network),\n    statusLabel(network),\n    datasetLabel(network),\n  ])\n  return formatTable(['Network', 'Status', 'Dataset'], rows, [14, 10, 38])\n}\n\nexport function formatNetworkCapabilities(document: NetworkCapabilitiesDocument): string {\n  if (document.networks.length === 0) return 'No supported networks advertised.'\n  const networkRows = document.networks.flatMap((network) => {\n    const toolLines = availableToolLines(network)\n    return toolLines.map((toolLine, index) => [\n      index === 0 ? displayName(network) : '',\n      index === 0 ? datasetLabel(network) : '',\n      toolLine,\n    ])\n  })\n  return formatTable(['Network', 'Dataset', 'Chain Insights tools'], networkRows, [14, 38, 64])\n}\n\nexport function findNetworkCapability(\n  document: NetworkCapabilitiesDocument,\n  name: string\n): NetworkCapability | undefined {\n  const normalizedName = name.trim().toLowerCase()\n  if (!normalizedName) return undefined\n  return document.networks.find((network) =>\n    [network.network, network.display_name].some(\n      (candidate) => candidate?.trim().toLowerCase() === normalizedName\n    )\n  )\n}\n\nexport function formatNetworkCapability(network: NetworkCapability): string {\n  const rows = [\n    ['Network', network.display_name || network.network],\n    ['Identifier', network.network],\n    ['Status', network.default ? `${network.status} (default)` : network.status],\n    ['Dataset', datasetLabel(network)],\n    ['Available tools', availableTools(network).join(', ') || 'none'],\n  ]\n  const labelWidth = Math.max(...rows.map(([label]) => label.length))\n  return rows.map(([label, value]) => `${label.padEnd(labelWidth)}  ${value}`).join('\\n')\n}\n"],"mappings":"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"}

package/dist/{capabilities-EMRzwPBU.cjs → capabilities-CjpGnrVg.cjs}

@@ -7,6 +7,7 @@ var capabilities_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll(
 	findNetworkCapability: () => findNetworkCapability,
 	formatNetworkCapabilities: () => formatNetworkCapabilities,
 	formatNetworkCapability: () => formatNetworkCapability,
+	formatNetworkOverview: () => formatNetworkOverview,
 	mirrorGraphNetworkCapabilities: () => mirrorGraphNetworkCapabilities
 });
 const PUBLIC_CHAIN_INSIGHTS_TOOL_STATUS = {
@@ -99,31 +100,54 @@ function datasetLabel(network) {
 	if (dateRange === "") return blockRange;
 	return `${blockRange} / ${dateRange}`;
 }
+function displayName(network) {
+	return network.display_name || network.network;
+}
+function statusLabel(network) {
+	return network.default ? `${network.status} (default)` : network.status;
+}
+function formatTable(headers, rows, minimumWidths) {
+	const widths = headers.map((header, index) => Math.max(minimumWidths[index] ?? 0, header.length, ...rows.map((row) => row[index]?.length ?? 0)));
+	const row = (values) => values.map((value, index) => value.padEnd(widths[index])).join("  ");
+	return [
+		row(headers),
+		widths.map((width) => "-".repeat(width)).join("  "),
+		...rows.map(row)
+	].join("\n");
+}
+function formatNetworkOverview(document) {
+	if (document.networks.length === 0) return "No supported networks advertised.";
+	return formatTable([
+		"Network",
+		"Status",
+		"Dataset"
+	], document.networks.map((network) => [
+		displayName(network),
+		statusLabel(network),
+		datasetLabel(network)
+	]), [
+		14,
+		10,
+		38
+	]);
+}
 function formatNetworkCapabilities(document) {
 	if (document.networks.length === 0) return "No supported networks advertised.";
-	const headers = [
+	return formatTable([
 		"Network",
 		"Dataset",
-		"Available tools"
-	];
-	const widths = [
+		"Chain Insights tools"
+	], document.networks.flatMap((network) => {
+		return availableToolLines(network).map((toolLine, index) => [
+			index === 0 ? displayName(network) : "",
+			index === 0 ? datasetLabel(network) : "",
+			toolLine
+		]);
+	}), [
 		14,
 		38,
 		64
-	];
-	const row = (values) => values.map((value, index) => value.padEnd(widths[index])).join("  ");
-	const networkRows = document.networks.flatMap((network) => {
-		return availableToolLines(network).map((toolLine, index) => row([
-			index === 0 ? network.display_name || network.network : "",
-			index === 0 ? datasetLabel(network) : "",
-			toolLine
-		]));
-	});
-	return [
-		row(headers),
-		widths.map((width) => "-".repeat(width)).join("  "),
-		...networkRows
-	].join("\n");
+	]);
 }
 function findNetworkCapability(document, name) {
 	const normalizedName = name.trim().toLowerCase();

package/dist/cli.cjs

@@ -23,7 +23,10 @@ function printMcpTextContent(result) {
 const __dirname$1 = node_path.default.dirname((0, node_url.fileURLToPath)(require("url").pathToFileURL(__filename).href));
 const installerPath = node_path.default.resolve(__dirname$1, "..", "bin", "install.cjs");
 const program = new commander.Command();
-program.name("cia").description("AML investigation toolkit for blockchain analysis").version(require_version.PACKAGE_INFO.version).option("--claude", "Install Claude Code skills globally to ~/.claude/skills/").option("--codex", "Install Codex skills globally to ~/.codex/skills/ and register MCP").option("--hermes", "Install Hermes skills globally to ~/.hermes/skills/chain-insights/ and register MCP");
+function createCliCommand(name) {
+	return new commander.Command(name).showHelpAfterError();
+}
+program.name("cia").description("AML investigation toolkit for blockchain analysis").version(require_version.PACKAGE_INFO.version).showHelpAfterError().option("--claude", "Install Claude Code skills globally to ~/.claude/skills/").option("--codex", "Install Codex skills globally to ~/.codex/skills/ and register MCP").option("--hermes", "Install Hermes skills globally to ~/.hermes/skills/chain-insights/ and register MCP");
 const rawArgs = process.argv.slice(2);
 const installerFlags = rawArgs.filter((a) => a === "--claude" || a === "--codex" || a === "--hermes");
 const wantsHelpOrVersion = rawArgs.some((a) => a === "--help" || a === "-h" || a === "--version" || a === "-V");
@@ -71,14 +74,21 @@ async function withGraphMcpClient(name, fn) {
 }
 async function printNetworkCapabilities(opts) {
 	const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
-	const { fetchNetworkCapabilities, formatNetworkCapabilities } = await Promise.resolve().then(() => require("./capabilities-EMRzwPBU.cjs")).then((n) => n.capabilities_exports);
+	const { fetchNetworkCapabilities, formatNetworkCapabilities } = await Promise.resolve().then(() => require("./capabilities-CjpGnrVg.cjs")).then((n) => n.capabilities_exports);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	if (opts.json) console.log(JSON.stringify(document, null, 2));
 	else console.log(formatNetworkCapabilities(document));
 }
+async function printNetworkOverview(opts) {
+	const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
+	const { fetchNetworkCapabilities, formatNetworkOverview } = await Promise.resolve().then(() => require("./capabilities-CjpGnrVg.cjs")).then((n) => n.capabilities_exports);
+	const document = await fetchNetworkCapabilities(await loadConfig());
+	if (opts.json) console.log(JSON.stringify(document, null, 2));
+	else console.log(formatNetworkOverview(document));
+}
 async function printNetworkCapability(name, opts) {
 	const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
-	const { fetchNetworkCapabilities, findNetworkCapability, formatNetworkCapability } = await Promise.resolve().then(() => require("./capabilities-EMRzwPBU.cjs")).then((n) => n.capabilities_exports);
+	const { fetchNetworkCapabilities, findNetworkCapability, formatNetworkCapability } = await Promise.resolve().then(() => require("./capabilities-CjpGnrVg.cjs")).then((n) => n.capabilities_exports);
 	const document = await fetchNetworkCapabilities(await loadConfig());
 	const network = findNetworkCapability(document, name);
 	if (!network) {
@@ -89,9 +99,27 @@ async function printNetworkCapability(name, opts) {
 	if (opts.json) console.log(JSON.stringify(network, null, 2));
 	else console.log(formatNetworkCapability(network));
 }
-program.command("networks").description("List supported graph networks, capability layers, and available tools").option("--json", "Print raw capability JSON").action(async (opts) => {
+function addAmlAddressRiskCommand(parent, networksCommand) {
+	parent.addCommand(createCliCommand("aml-address-risk").description("Screen an address for AML risk, exchange behavior, and optional comparison with another address").requiredOption("--address <address>", "Full blockchain address to screen").requiredOption("--network <network>", `Network to query. Run \`${networksCommand}\` for supported networks.`).option("--compare-address <address>", "Optional second address to compare against the screened address").action(async (opts) => {
+		try {
+			await withGraphMcpClient("chain-insights-cli-aml-address-risk", async (client) => {
+				const { addressRisk } = await Promise.resolve().then(() => require("./public-tools-Bou25cki.cjs"));
+				const result = await addressRisk(client, {
+					address: opts.address,
+					network: opts.network,
+					compareAddress: opts.compareAddress
+				});
+				console.log(result.summaryText);
+			});
+		} catch (err) {
+			console.error(err.message);
+			process.exit(1);
+		}
+	}));
+}
+program.command("networks").description("Show supported network status and dataset overview").option("--json", "Print raw capability JSON").action(async (opts) => {
 	try {
-		await printNetworkCapabilities(opts);
+		await printNetworkOverview(opts);
 	} catch (err) {
 		console.error(err.message);
 		process.exit(1);
@@ -138,7 +166,7 @@ program.command("update").description("Check npmjs for a newer Chain Insights re
 		process.exit(1);
 	}
 });
-program.command("debug").description("Configure Chain Insights Graph debug mode").addCommand(new commander.Command("on").description("Enable Chain Insights Graph debug mode without x402 payments").requiredOption("--token <token>", "Debug bearer token").option("--endpoint <url>", "Chain Insights Graph endpoint").action(async (opts) => {
+program.command("debug").description("Configure Chain Insights Graph debug mode").addCommand(createCliCommand("on").description("Enable Chain Insights Graph debug mode without x402 payments").requiredOption("--token <token>", "Debug bearer token").option("--endpoint <url>", "Chain Insights Graph endpoint").action(async (opts) => {
 	try {
 		const { saveConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 		await saveConfig({
@@ -153,7 +181,7 @@ program.command("debug").description("Configure Chain Insights Graph debug mode"
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("off").description("Disable Chain Insights Graph debug mode and use paid x402 calls").action(async () => {
+})).addCommand(createCliCommand("off").description("Disable Chain Insights Graph debug mode and use paid x402 calls").action(async () => {
 	try {
 		const { saveConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 		await saveConfig({
@@ -166,7 +194,7 @@ program.command("debug").description("Configure Chain Insights Graph debug mode"
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("status").description("Show Chain Insights Graph payment/debug mode").action(async () => {
+})).addCommand(createCliCommand("status").description("Show Chain Insights Graph payment/debug mode").action(async () => {
 	try {
 		const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 		const config = await loadConfig();
@@ -179,7 +207,7 @@ program.command("debug").description("Configure Chain Insights Graph debug mode"
 		process.exit(1);
 	}
 }));
-program.command("access-key").description("Configure Chain Insights Graph test access key mode").addCommand(new commander.Command("set").description("Use a Chain Insights Graph test access key without x402 payments").argument("<key>", "Test access key").option("--endpoint <url>", "Chain Insights Graph endpoint").action(async (key, opts) => {
+program.command("access-key").description("Configure Chain Insights Graph test access key mode").addCommand(createCliCommand("set").description("Use a Chain Insights Graph test access key without x402 payments").argument("<key>", "Test access key").option("--endpoint <url>", "Chain Insights Graph endpoint").action(async (key, opts) => {
 	try {
 		const normalizedKey = key.trim();
 		if (!normalizedKey) throw new Error("Test access key is required");
@@ -196,7 +224,7 @@ program.command("access-key").description("Configure Chain Insights Graph test a
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("clear").description("Remove the Chain Insights Graph test access key and use paid x402 calls").action(async () => {
+})).addCommand(createCliCommand("clear").description("Remove the Chain Insights Graph test access key and use paid x402 calls").action(async () => {
 	try {
 		const { saveConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 		await saveConfig({
@@ -209,7 +237,7 @@ program.command("access-key").description("Configure Chain Insights Graph test a
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("status").description("Show Chain Insights Graph test access key status").action(async () => {
+})).addCommand(createCliCommand("status").description("Show Chain Insights Graph test access key status").action(async () => {
 	try {
 		const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 		const config = await loadConfig();
@@ -221,14 +249,14 @@ program.command("access-key").description("Configure Chain Insights Graph test a
 		process.exit(1);
 	}
 }));
-program.command("setup").description("Configure external MCP clients").addCommand(new commander.Command("claude-code").alias("claude").description("Install Claude Code skills and register the MCP proxy").action(() => {
+program.command("setup").description("Configure external MCP clients").addCommand(createCliCommand("claude-code").alias("claude").description("Install Claude Code skills and register the MCP proxy").action(() => {
 	runInstaller("--claude");
-})).addCommand(new commander.Command("codex").description("Install Codex skills and register the MCP proxy").action(() => {
+})).addCommand(createCliCommand("codex").description("Install Codex skills and register the MCP proxy").action(() => {
 	runInstaller("--codex");
-})).addCommand(new commander.Command("hermes").description("Install Hermes skills and register the MCP proxy").action(() => {
+})).addCommand(createCliCommand("hermes").description("Install Hermes skills and register the MCP proxy").action(() => {
 	runInstaller("--hermes");
 }));
-program.command("config").description("Read or write configuration values").addCommand(new commander.Command("get").argument("<key>", "Config key to read").action(async (key) => {
+program.command("config").description("Read or write configuration values").addCommand(createCliCommand("get").description("Read one Chain Insights configuration value").argument("<key>", "Config key to read").action(async (key) => {
 	const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 	const { CONFIG_KEYS } = await Promise.resolve().then(() => require("./schema-CtFWYoJz.cjs")).then((n) => n.schema_exports);
 	if (!CONFIG_KEYS.includes(key)) {
@@ -237,7 +265,7 @@ program.command("config").description("Read or write configuration values").addC
 	}
 	const value = (await loadConfig())[key];
 	console.log(value ?? "");
-})).addCommand(new commander.Command("set").argument("<key>", "Config key to write").argument("<value>", "Value to set").action(async (key, value) => {
+})).addCommand(createCliCommand("set").description("Write one Chain Insights configuration value").argument("<key>", "Config key to write").argument("<value>", "Value to set").action(async (key, value) => {
 	if (key === "walletPrivateKey") {
 		try {
 			const { setWalletPrivateKey } = await Promise.resolve().then(() => require("./wallet-B3hAr70M.cjs")).then((n) => n.wallet_exports);
@@ -264,7 +292,7 @@ program.command("config").description("Read or write configuration values").addC
 	const displayed = key.toLowerCase().includes("token") ? "[redacted]" : coerced;
 	console.log(`Set ${key} = ${displayed}`);
 }));
-program.command("wallet").description("Manage the local Base USDC payment wallet").addCommand(new commander.Command("create").description("Generate a new local Base payment wallet").action(async () => {
+program.command("wallet").description("Manage the local Base USDC payment wallet").addCommand(createCliCommand("create").description("Generate a new local Base payment wallet").action(async () => {
 	try {
 		const { isWalletConfigured, setWalletPrivateKey, walletPath } = await Promise.resolve().then(() => require("./wallet-B3hAr70M.cjs")).then((n) => n.wallet_exports);
 		const { createInterface } = await import("node:readline/promises");
@@ -293,7 +321,7 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("import").description("Import a Base payment wallet").argument("<private-key>", "0x-prefixed EVM private key").option("--force", "Replace an existing wallet (the previous key is backed up next to wallet.json)").action(async (privateKey, opts) => {
+})).addCommand(createCliCommand("import").description("Import a Base payment wallet").argument("<private-key>", "0x-prefixed EVM private key").option("--force", "Replace an existing wallet (the previous key is backed up next to wallet.json)").action(async (privateKey, opts) => {
 	try {
 		const { setWalletPrivateKey, isWalletConfigured } = await Promise.resolve().then(() => require("./wallet-B3hAr70M.cjs")).then((n) => n.wallet_exports);
 		const replacing = opts.force === true && await isWalletConfigured();
@@ -307,7 +335,7 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("address").description("Print the local payment wallet address").action(async () => {
+})).addCommand(createCliCommand("address").description("Print the local payment wallet address").action(async () => {
 	try {
 		const { getWalletAccount } = await Promise.resolve().then(() => require("./tools-BHfphgy9.cjs")).then((n) => n.tools_exports);
 		const account = await getWalletAccount();
@@ -316,7 +344,7 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("balance").description("Show the local payment wallet Base USDC balance").action(async () => {
+})).addCommand(createCliCommand("balance").description("Show the local payment wallet Base USDC balance").action(async () => {
 	try {
 		const { getWalletBalanceText } = await Promise.resolve().then(() => require("./tools-BHfphgy9.cjs")).then((n) => n.tools_exports);
 		console.log(await getWalletBalanceText());
@@ -324,7 +352,7 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("ready").description("Check and prepare the wallet for paid Chain Insights Graph calls").option("--check-only", "Only check readiness; do not submit the one-time payment setup").addOption(new commander.Option("--no-approve", "Deprecated alias for --check-only").hideHelp()).option("--payment-usdc <amount>", "USDC setup cap to prepare for paid calls", "1").addOption(new commander.Option("--approval-usdc <amount>", "Deprecated alias for --payment-usdc").hideHelp()).option("--json", "Print machine-readable readiness metadata").action(async (opts) => {
+})).addCommand(createCliCommand("ready").description("Check and prepare the wallet for paid Chain Insights Graph calls").option("--check-only", "Only check readiness; do not submit the one-time payment setup").addOption(new commander.Option("--no-approve", "Deprecated alias for --check-only").hideHelp()).option("--payment-usdc <amount>", "USDC setup cap to prepare for paid calls", "1").addOption(new commander.Option("--approval-usdc <amount>", "Deprecated alias for --payment-usdc").hideHelp()).option("--json", "Print machine-readable readiness metadata").action(async (opts) => {
 	try {
 		const { formatWalletReadiness, parsePaymentApprovalUnits, prepareWalletForPaidCalls } = await Promise.resolve().then(() => require("./tools-BHfphgy9.cjs")).then((n) => n.tools_exports);
 		const result = await prepareWalletForPaidCalls({
@@ -340,7 +368,7 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("topup").description("Open a local browser page to top up the payment wallet").option("--no-open", "Print the top-up URL without opening a browser").option("--json", "Print machine-readable top-up metadata").action(async (opts) => {
+})).addCommand(createCliCommand("topup").description("Open a local browser page to top up the payment wallet").option("--no-open", "Print the top-up URL without opening a browser").option("--json", "Print machine-readable top-up metadata").action(async (opts) => {
 	try {
 		const { buildTopupInfo, getWalletAccount } = await Promise.resolve().then(() => require("./tools-BHfphgy9.cjs")).then((n) => n.tools_exports);
 		const { startTopupServer } = await Promise.resolve().then(() => require("./topup-server-YN3iHrHW.cjs")).then((n) => n.topup_server_exports);
@@ -364,18 +392,19 @@ program.command("wallet").description("Manage the local Base USDC payment wallet
 		process.exit(1);
 	}
 }));
-program.command("mcp").description("Interact with the Chain Insights MCP endpoint").allowExcessArguments(false).addCommand(new commander.Command("networks").description("List supported graph networks, capability layers, dataset coverage, and available tools").option("--json", "Print raw capability JSON").action(async (opts) => {
+addAmlAddressRiskCommand(program, "cia networks");
+const mcpCommand = program.command("mcp").description("Interact with the Chain Insights MCP endpoint").allowExcessArguments(false).addCommand(createCliCommand("networks").description("List the detailed Chain Insights capability matrix and tool support").option("--json", "Print raw capability JSON").action(async (opts) => {
 	try {
 		await printNetworkCapabilities(opts);
 	} catch (err) {
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("tools").description("List available MCP tools (cached 24h)").option("--refresh", "Force refresh schema cache").action(async (opts) => {
+})).addCommand(createCliCommand("tools").description("List remote GraphRAG MCP tools (cached for 24 hours)").option("--refresh", "Force refresh schema cache").action(async (opts) => {
 	try {
 		const { loadSchema, saveSchema } = await Promise.resolve().then(() => require("./schema-cache-n7Gbhvsj.cjs"));
-		const { formatToolsTable } = await Promise.resolve().then(() => require("./format-9NLBykEL.cjs"));
-		const { visibleRemoteTools } = await Promise.resolve().then(() => require("./tool-visibility-C8F9Yoxy.cjs")).then((n) => n.tool_visibility_exports);
+		const { formatToolsTable } = await Promise.resolve().then(() => require("./format-BjZuYDr8.cjs"));
+		const { visibleRemoteTools } = await Promise.resolve().then(() => require("./tool-visibility-DA4pOuJt.cjs")).then((n) => n.tool_visibility_exports);
 		const { loadConfig } = await Promise.resolve().then(() => require("./config-B542AM4w.cjs")).then((n) => n.config_exports);
 		const { createConfiguredGraphMcpFetch, resolveGraphMcpEndpoint } = await Promise.resolve().then(() => require("./client-Ypw9BNbn.cjs")).then((n) => n.client_exports);
 		const config = await loadConfig();
@@ -402,25 +431,12 @@ program.command("mcp").description("Interact with the Chain Insights MCP endpoin
 		console.error(err.message);
 		process.exit(1);
 	}
-})).addCommand(new commander.Command("aml-address-risk").description("Screen an address for AML risk, exchange behavior, and optional comparison with another address").requiredOption("--address <address>", "Full blockchain address to screen").requiredOption("--network <network>", "Network to query. Run `cia mcp networks` for supported networks.").option("--compare-address <address>", "Optional second address to compare against the screened address").action(async (opts) => {
-	try {
-		await withGraphMcpClient("chain-insights-cli-aml-address-risk", async (client) => {
-			const { addressRisk } = await Promise.resolve().then(() => require("./public-tools-Bou25cki.cjs"));
-			const result = await addressRisk(client, {
-				address: opts.address,
-				network: opts.network,
-				compareAddress: opts.compareAddress
-			});
-			console.log(result.summaryText);
-		});
-	} catch (err) {
-		console.error(err.message);
-		process.exit(1);
-	}
-})).addCommand(new commander.Command("call").description("Call an MCP tool directly (debug)").argument("<tool>", "Tool name to call").argument("[args...]", "Key=value arguments (e.g. address=0x1234... network=robinhood)").action(async (tool, rawArgs) => {
+}));
+addAmlAddressRiskCommand(mcpCommand, "cia mcp networks");
+mcpCommand.addCommand(createCliCommand("call").description("Call an MCP tool directly (debug)").argument("<tool>", "Tool name to call").argument("[args...]", "Key=value arguments (e.g. address=0x1234... network=robinhood)").action(async (tool, rawArgs) => {
 	try {
 		const { parseMcpCallArgs } = await Promise.resolve().then(() => require("./call-args-DAiQSDmD.cjs"));
-		const { assertPublicMcpToolName, validatePublicMcpToolArguments } = await Promise.resolve().then(() => require("./tool-visibility-C8F9Yoxy.cjs")).then((n) => n.tool_visibility_exports);
+		const { assertPublicMcpToolName, validatePublicMcpToolArguments } = await Promise.resolve().then(() => require("./tool-visibility-DA4pOuJt.cjs")).then((n) => n.tool_visibility_exports);
 		const args = parseMcpCallArgs(rawArgs);
 		assertPublicMcpToolName(tool);
 		validatePublicMcpToolArguments(tool, args);
@@ -468,7 +484,8 @@ program.command("mcp").description("Interact with the Chain Insights MCP endpoin
 			}));
 		});
 	} catch (err) {
-		console.error(err.message);
+		const { formatMcpCallError } = await Promise.resolve().then(() => require("./tool-visibility-DA4pOuJt.cjs")).then((n) => n.tool_visibility_exports);
+		console.error(formatMcpCallError(tool, err));
 		process.exit(1);
 	}
 }));