chainhint-mcp 1.2.0 → 1.3.0

package/dist/index.js

@@ -218,7 +218,7 @@ const server = new McpServer({
 // ── Tool 1: check_wallet_risk ─────────────────────────────────────────────────
 server.tool("check_wallet_risk", "Fast risk check for a crypto wallet address against ChainHint's 54M+ labeled address database (12 chains). Returns risk score 0-100, risk level (clean/low/medium/high/critical/sanctioned), entity name and category, labels, and sanctions hit. Use it to decide allow/warn/block before paying or interacting with a counterparty wallet. Free: 3 checks per day without a key; CHAINHINT_API_KEY (Agency plan) lifts it to 10,000/day. For a deeper report (risk factors, exposure, balance) use lookup_address.", {
     address: z.string().describe("Wallet address to check (EVM 0x..., Bitcoin, or Solana)"),
-    chain: z.string().optional().describe("Blockchain: ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, solana, bitcoin (default: auto-detect from address format)"),
+    chain: z.string().optional().describe("Blockchain: ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, gnosis, bitcoin, solana, tron, ton (default: auto-detect from address format; the response chain is the address family for bitcoin/solana/tron/ton)"),
 }, async ({ address, chain }) => {
     try {
         const params = { address };
@@ -264,6 +264,12 @@ server.tool("check_wallet_risk", "Fast risk check for a crypto wallet address ag
         }
         if (d.labels?.length)
             lines.push(`**Labels:** ${[...new Set(d.labels)].join(", ")}`);
+        if (d.agent) {
+            // Registry fact (agent launchpad / factory / facilitator / wallet), not
+            // a behavioural classification — mirrors the API's honest wording.
+            const cap = d.agent.summary.charAt(0).toUpperCase() + d.agent.summary.slice(1);
+            lines.push(`🤖 **${cap}** — a registry fact, not a behavioural classification.`);
+        }
         if (d.is_contract != null)
             lines.push(`**Type:** ${d.is_contract ? "Smart Contract" : "EOA (wallet)"}`);
         lines.push(`**In ChainHint DB:** ${d.found_in_db ? "yes" : "no"}${d.sources?.length ? ` (sources: ${d.sources.join(", ")})` : ""}`);
@@ -281,7 +287,7 @@ server.tool("check_wallet_risk", "Fast risk check for a crypto wallet address ag
 // ── Tool 2: lookup_address ────────────────────────────────────────────────────
 server.tool("lookup_address", "Detailed lookup of a blockchain address: entity attribution, risk score with the factors behind it, sanctions and GoPlus security flags, counterparty exposure (where funds came from / went to, by category with named entities), balance, token count and transaction count. Free: 10 lookups per day without a key; CHAINHINT_API_KEY lifts it. Supports EVM chains, Bitcoin, Solana, TRON, TON.", {
     address: z.string().describe("Blockchain address to look up"),
-    chain: z.string().optional().describe("Blockchain (ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, solana, bitcoin, tron, ton)"),
+    chain: z.string().optional().describe("Blockchain (ethereum, bsc, polygon, arbitrum, optimism, base, avalanche, gnosis, bitcoin, solana, tron, ton)"),
 }, async ({ address, chain }) => {
     try {
         const params = { address };
@@ -306,6 +312,10 @@ server.tool("lookup_address", "Detailed lookup of a blockchain address: entity a
         else {
             lines.push(`**Entity:** Unknown / unlabeled`);
         }
+        if (d.agent) {
+            const cap = d.agent.summary.charAt(0).toUpperCase() + d.agent.summary.slice(1);
+            lines.push(`🤖 **${cap}** — a registry fact, not a behavioural classification.`);
+        }
         if (d.labels?.length)
             lines.push(`**Labels:** ${[...new Set(d.labels)].join(", ")}`);
         if (d.risk) {
@@ -416,6 +426,11 @@ server.tool("get_trace_status", "Fund-trace summary for a publicly tracked crypt
             lines.push(`**Hops traced:** ${hops} · **Addresses:** ${nodes.length} · **Transfers:** ${edges.length}`);
         }
         const endpoints = inc.endpoints ?? [];
+        // A graph none of whose edges carries amount_usd was never valued (legacy
+        // Bitcoin rows): endpoint.amount_usd then holds the raw asset quantity and
+        // must not be printed as dollars (multi-chain audit 2026-09-03).
+        const graphPriced = edges.length === 0 || edges.some((e) => e.amount_usd != null && Number(e.amount_usd) > 0);
+        const money = (n) => (graphPriced ? usd(n) : "unpriced");
         if (endpoints.length) {
             const byType = new Map();
             for (const e of endpoints) {
@@ -430,11 +445,11 @@ server.tool("get_trace_status", "Fund-trace summary for a publicly tracked crypt
             }
             const totalUsd = [...byType.values()].reduce((s, b) => s + b.usd, 0);
             // Σ endpoint amounts counts every hop's inflow (multi-hop), so it is larger than the loss — name the base.
-            lines.push(``, `### Where the funds went (${endpoints.length} endpoints, ${usd(totalUsd)} observed at endpoints — not the loss figure)`);
+            lines.push(``, `### Where the funds went (${endpoints.length} endpoints, ${graphPriced ? `${usd(totalUsd)} observed at endpoints — not the loss figure` : "this trace carries no USD valuation"})`);
             for (const [t, b] of [...byType.entries()].sort((a, b) => b[1].usd - a[1].usd)) {
                 const top = [...b.entities.entries()].sort((a, b) => b[1] - a[1]).slice(0, 3).map(([n]) => n);
                 const pct = totalUsd > 0 ? ` (${((b.usd / totalUsd) * 100).toFixed(1)}%)` : "";
-                lines.push(`- **${t}**: ${usd(b.usd)}${pct} across ${b.n} address(es)${top.length ? ` — ${top.join(", ")}` : ""}`);
+                lines.push(`- **${t}**: ${money(b.usd)}${graphPriced ? pct : ""} across ${b.n} address(es)${top.length ? ` — ${top.join(", ")}` : ""}`);
             }
             const topEndpoints = [...endpoints]
                 .filter((e) => (e.amount_usd ?? 0) > 0)
@@ -444,7 +459,7 @@ server.tool("get_trace_status", "Fund-trace summary for a publicly tracked crypt
                 lines.push(`**Largest endpoints:**`);
                 for (const e of topEndpoints) {
                     const name = e.entity_name ?? e.entity ?? "unattributed";
-                    lines.push(`- ${truncateAddr(e.address)} — ${name} (${endpointBucket(e.entity_category, e.type, e.entity_name ?? e.entity)}): ${usd(e.amount_usd)}`);
+                    lines.push(`- ${truncateAddr(e.address)} — ${name} (${endpointBucket(e.entity_category, e.type, e.entity_name ?? e.entity)}): ${money(e.amount_usd)}`);
                 }
             }
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chainhint-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "ChainHint MCP server — crypto risk intelligence tools for Claude Desktop and Cursor",
   "license": "MIT",
   "repository": {