chain-insights 0.24.1 → 0.25.0

package/README.md

@@ -22,7 +22,7 @@ as-is on macOS; on Windows use WSL.
 ```bash
 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 aml-address-risk --address 0xYourAddressHere --network robinhood
 cia networks                       # network status + dataset overview
 cia network robinhood              # details for one network
 ```
@@ -31,6 +31,20 @@ 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`).
 
+CLI results are human-readable by default. Add `--json` when another tool or
+script needs indented JSON:
+
+```bash
+cia mcp call --json graph_query \
+  network=robinhood \
+  "query=USE topology MATCH (a:Address) RETURN a.address AS address LIMIT 10"
+cia aml-address-risk --json --address 0xYourAddressHere --network robinhood
+```
+
+The AML address-risk contract uses the latest version when `version` is
+omitted. Pin the current contract with `--version v1` on the AML command, or
+with `version=v1` when using `cia mcp call aml_address_risk`.
+
 ## Purpose And Ownership
 
 One public npm package (`chain-insights`) providing the `cia` CLI and a
@@ -210,6 +224,13 @@ cia update --check
 
 Run a first screen from any directory:
 
+```bash
+cia aml-address-risk \
+  --address 0xYourAddressHere --network robinhood
+```
+
+The same screen is available through the generic MCP caller:
+
 ```bash
 cia mcp call aml_address_risk \
   network=robinhood address=0xYourAddressHere

package/dist/cli.cjs

@@ -6,6 +6,85 @@ let node_url = require("node:url");
 let node_path = require("node:path");
 node_path = require_rolldown_runtime.__toESM(node_path, 1);
 //#region src/mcp/print-result.ts
+function isRecord(value) {
+	return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function displayValue(value) {
+	if (value === null || value === void 0) return "";
+	if (typeof value === "string") return value;
+	if (typeof value === "number" || typeof value === "boolean") return String(value);
+	try {
+		return JSON.stringify(value);
+	} catch {
+		return String(value);
+	}
+}
+function formatTable(rows) {
+	if (rows.length === 0) return [];
+	const columns = [...new Set(rows.flatMap((row) => Object.keys(row)))];
+	const values = rows.map((row) => columns.map((column) => displayValue(row[column])));
+	const widths = columns.map((column, index) => Math.max(column.length, ...values.map((row) => row[index]?.length ?? 0)));
+	const line = (row) => row.map((value, index) => index === row.length - 1 ? value : value.padEnd(widths[index] ?? 0)).join(" | ");
+	return [
+		line(columns),
+		widths.map((width) => "-".repeat(width)).join("-+-"),
+		...values.map(line)
+	];
+}
+function formatGraphResult(value, fallbackTool) {
+	const facts = isRecord(value.facts) ? value.facts : void 0;
+	const query = facts && isRecord(facts.query) ? facts.query : void 0;
+	const queries = facts && Array.isArray(facts.queries) ? facts.queries : void 0;
+	if (!query && !queries) return null;
+	const lines = [`Tool: ${displayValue(value.tool) || fallbackTool || "MCP result"}`];
+	const subject = isRecord(value.subject) ? value.subject : facts && isRecord(facts.subject) ? facts.subject : void 0;
+	if (subject?.network !== void 0) lines.push(`Network: ${displayValue(subject.network)}`);
+	if (query) {
+		const results = Array.isArray(query.results) ? query.results.filter(isRecord) : [];
+		if (query.count !== void 0) lines.push(`Rows: ${displayValue(query.count)}`);
+		else lines.push(`Rows: ${results.length}`);
+		if (query.billable_units !== void 0) lines.push(`Billed units: ${displayValue(query.billable_units)}`);
+		if (query.elapsed_ms !== void 0) lines.push(`Elapsed: ${displayValue(query.elapsed_ms)} ms`);
+		if (query.truncated !== void 0) lines.push(`Truncated: ${displayValue(query.truncated)}`);
+		if (query.error !== void 0) lines.push(`Error: ${displayValue(query.error)}`);
+		if (results.length > 0) lines.push("", "Results:", ...formatTable(results));
+		else lines.push("", "Results: none");
+	}
+	if (queries) {
+		lines.push(`Queries: ${queries.length}`);
+		for (const entry of queries) {
+			if (!isRecord(entry)) continue;
+			const id = displayValue(entry.id) || "query";
+			const results = Array.isArray(entry.results) ? entry.results.filter(isRecord) : [];
+			lines.push("", `[${id}]`);
+			if (entry.error !== void 0) lines.push(`Error: ${displayValue(entry.error)}`);
+			lines.push(`Rows: ${displayValue(entry.count ?? results.length)}`);
+			if (results.length > 0) lines.push(...formatTable(results));
+			else lines.push("Results: none");
+		}
+	}
+	return lines.join("\n");
+}
+/**
+* Formats one MCP text block for terminal output. JSON is indented when the
+* caller requests `--json`; graph query envelopes are rendered as a compact
+* result summary and table by default.
+*/
+function formatMcpTextContent(text, tool, options = {}) {
+	let parsed;
+	try {
+		parsed = JSON.parse(text);
+	} catch {
+		return text;
+	}
+	if (options.json) try {
+		return JSON.stringify(parsed, null, 2);
+	} catch {
+		return text;
+	}
+	if (isRecord(parsed)) return formatGraphResult(parsed, tool) ?? JSON.stringify(parsed, null, 2);
+	return displayValue(parsed);
+}
 /**
 * Prints the text blocks of an MCP tool result to stdout. When the result is
 * flagged `isError`, throws with the tool's error text instead — MCP `callTool`
@@ -13,19 +92,32 @@ node_path = require_rolldown_runtime.__toESM(node_path, 1);
 * surface them as failures (non-zero exit) rather than printing to stdout and
 * exiting 0.
 */
-function printMcpTextContent(result) {
+function printMcpTextContent(result, options = {}) {
 	const texts = (result.content ?? []).filter((item) => item.type === "text").map((item) => item.text ?? "");
 	if (result.isError) throw new Error(texts.join("\n").trim() || "MCP tool returned an error");
-	for (const text of texts) console.log(text);
+	for (const text of texts) console.log(formatMcpTextContent(text, options.tool, options));
 }
 //#endregion
 //#region src/cli.ts
 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");
+function normalizeAmlToolVersionArgv(argv) {
+	const commandIndex = rawArgs.findIndex((arg, index) => arg === "aml-address-risk" && (index === 0 || index === 1 && rawArgs[0] === "mcp"));
+	if (commandIndex === -1) return argv;
+	return argv.map((arg, index) => {
+		if (index - 2 <= commandIndex) return arg;
+		if (arg === "--version") return "--tool-version";
+		if (arg.startsWith("--version=")) return `--tool-version=${arg.slice(10)}`;
+		return arg;
+	});
+}
 const wantsHelpOrVersion = rawArgs.some((a) => a === "--help" || a === "-h" || a === "--version" || a === "-V");
 if (installerFlags.length > 0 && !wantsHelpOrVersion && !rawArgs.some((a) => !a.startsWith("-"))) {
 	try {
@@ -96,6 +188,27 @@ async function printNetworkCapability(name, opts) {
 	if (opts.json) console.log(JSON.stringify(network, null, 2));
 	else console.log(formatNetworkCapability(network));
 }
+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").option("--json", "Print machine-readable JSON output").option("--version <version>", "AML tool contract version. Omit to use the latest version (currently v1)").addOption(new commander.Option("--tool-version <version>", "Internal alias for the AML tool version").hideHelp()).action(async (opts) => {
+		try {
+			const { resolveAmlAddressRiskVersion } = await Promise.resolve().then(() => require("./public-tools-DDGHRazh.cjs"));
+			const requestedVersion = opts.toolVersion ?? opts.version;
+			resolveAmlAddressRiskVersion(requestedVersion);
+			await withGraphMcpClient("chain-insights-cli-aml-address-risk", async (client) => {
+				const { runAmlAddressRisk } = await Promise.resolve().then(() => require("./public-tools-DDGHRazh.cjs"));
+				const result = await runAmlAddressRisk(client, {
+					address: opts.address,
+					network: opts.network,
+					compareAddress: opts.compareAddress
+				}, requestedVersion);
+				console.log(opts.json ? JSON.stringify(result.structuredContent, null, 2) : 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 printNetworkOverview(opts);
@@ -145,7 +258,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({
@@ -160,7 +273,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({
@@ -173,7 +286,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();
@@ -186,7 +299,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");
@@ -203,7 +316,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({
@@ -216,7 +329,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();
@@ -228,14 +341,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)) {
@@ -244,7 +357,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);
@@ -271,7 +384,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");
@@ -300,7 +413,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();
@@ -314,7 +427,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();
@@ -323,7 +436,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());
@@ -331,7 +444,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({
@@ -347,7 +460,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);
@@ -371,18 +484,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 the detailed Chain Insights capability matrix and tool support").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 remote GraphRAG MCP tools (cached for 24 hours)").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-BjZuYDr8.cjs"));
-		const { visibleRemoteTools } = await Promise.resolve().then(() => require("./tool-visibility-C8F9Yoxy.cjs")).then((n) => n.tool_visibility_exports);
+		const { visibleRemoteTools } = await Promise.resolve().then(() => require("./tool-visibility-BBEbpKt4.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();
@@ -409,35 +523,26 @@ 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)").option("--json", "Print machine-readable JSON output").argument("<tool>", "Tool name to call").argument("[args...]", "Key=value arguments (e.g. address=0x1234... network=robinhood)").action(async (tool, rawArgs, opts) => {
 	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-BBEbpKt4.cjs")).then((n) => n.tool_visibility_exports);
 		const args = parseMcpCallArgs(rawArgs);
 		assertPublicMcpToolName(tool);
 		validatePublicMcpToolArguments(tool, args);
+		if (tool === "aml_address_risk") {
+			const { resolveAmlAddressRiskVersion } = await Promise.resolve().then(() => require("./public-tools-DDGHRazh.cjs"));
+			resolveAmlAddressRiskVersion(args["version"] === void 0 ? void 0 : String(args["version"]));
+		}
 		if (tool === "wallet_balance") {
 			const { getWalletBalanceText } = await Promise.resolve().then(() => require("./tools-BHfphgy9.cjs")).then((n) => n.tools_exports);
 			console.log(await getWalletBalanceText());
 			return;
 		}
 		if (tool === "meta_network_capabilities") {
-			await printNetworkCapabilities({ json: true });
+			await printNetworkCapabilities({ json: opts.json });
 			return;
 		}
 		if (tool === "meta_help") {
@@ -450,7 +555,10 @@ program.command("mcp").description("Interact with the Chain Insights MCP endpoin
 					printMcpTextContent(await client.callTool({
 						name: "usage_status",
 						arguments: {}
-					}));
+					}), {
+						tool,
+						json: opts.json
+					});
 				} catch (err) {
 					const { isMissingUsageStatusToolError, primitiveBackendUsageStatus, usageStatusText } = await Promise.resolve().then(() => require("./usage-status-BdwwgYsu.cjs")).then((n) => n.usage_status_exports);
 					if (!isMissingUsageStatusToolError(err)) throw err;
@@ -460,26 +568,30 @@ program.command("mcp").description("Interact with the Chain Insights MCP endpoin
 				return;
 			}
 			if (tool === "aml_address_risk") {
-				const { addressRisk } = await Promise.resolve().then(() => require("./public-tools-Bou25cki.cjs"));
-				const result = await addressRisk(client, {
+				const { runAmlAddressRisk } = await Promise.resolve().then(() => require("./public-tools-DDGHRazh.cjs"));
+				const result = await runAmlAddressRisk(client, {
 					address: String(args["address"] ?? ""),
 					network: String(args["network"] ?? ""),
 					compareAddress: args["compare_address"] === void 0 ? void 0 : String(args["compare_address"])
-				});
-				console.log(result.summaryText);
+				}, args["version"] === void 0 ? void 0 : String(args["version"]));
+				console.log(opts.json ? JSON.stringify(result.structuredContent, null, 2) : result.summaryText);
 				return;
 			}
 			printMcpTextContent(await client.callTool({
 				name: tool,
 				arguments: args
-			}));
+			}), {
+				tool,
+				json: opts.json
+			});
 		});
 	} catch (err) {
-		console.error(err.message);
+		const { formatMcpCallError } = await Promise.resolve().then(() => require("./tool-visibility-BBEbpKt4.cjs")).then((n) => n.tool_visibility_exports);
+		console.error(formatMcpCallError(tool, err));
 		process.exit(1);
 	}
 }));
-program.parseAsync(process.argv).catch((err) => {
+program.parseAsync(normalizeAmlToolVersionArgv(process.argv)).catch((err) => {
 	console.error(err.message);
 	process.exit(1);
 });