hive-intelligence 1.9.0 → 1.11.0

package/build/{chunk-MVO6LL3H.js → chunk-X4U2IALG.js}

@@ -4457,6 +4457,52 @@ var handler42 = async (client2, args) => {
 };
 var get_timeframe_pools_networks_onchain_ohlcv_default = { metadata: metadata42, tool: tool42, handler: handler42 };
 
+// src/tools/onchain/tradeSummary.ts
+var UPSTREAM_TRADE_CAP = 300;
+function usd(value) {
+  const n = typeof value === "string" ? Number(value) : value;
+  return typeof n === "number" && Number.isFinite(n) ? n : 0;
+}
+function withTradeSummary(payload, minTradeUsd) {
+  const rows = payload?.data;
+  if (!Array.isArray(rows)) return payload;
+  let buys = 0;
+  let sells = 0;
+  let buyVolume = 0;
+  let sellVolume = 0;
+  const timestamps = [];
+  for (const row of rows) {
+    const attrs = row?.attributes ?? {};
+    if (attrs.kind === "buy") {
+      buys += 1;
+      buyVolume += usd(attrs.volume_in_usd);
+    } else if (attrs.kind === "sell") {
+      sells += 1;
+      sellVolume += usd(attrs.volume_in_usd);
+    }
+    if (typeof attrs.block_timestamp === "string") {
+      timestamps.push(attrs.block_timestamp);
+    }
+  }
+  timestamps.sort();
+  const filtered = usd(minTradeUsd) > 0;
+  return {
+    summary: {
+      trade_count: rows.length,
+      buys,
+      sells,
+      buy_volume_usd: buyVolume,
+      sell_volume_usd: sellVolume,
+      oldest_trade_at: timestamps[0] ?? null,
+      newest_trade_at: timestamps.at(-1) ?? null,
+      min_trade_usd: filtered ? usd(minTradeUsd) : 0,
+      upstream_capped: rows.length >= UPSTREAM_TRADE_CAP,
+      note: `Counts cover every trade GeckoTerminal returned: at most ${UPSTREAM_TRADE_CAP}, newest first, within the last 24h${filtered ? `, trades of at least $${usd(minTradeUsd)} only` : ""}. The data array may be cut to the newest rows by the response budget, so count buys and sells from this summary, not from data. Pool transactions.h24 (get_token_pools) counts every swap and can exceed trade_count when the cap or the minimum-size filter applies.`
+    },
+    ...payload
+  };
+}
+
 // src/tools/onchain/networks/pools/trades/get-pools-networks-onchain-trades.ts
 var metadata43 = {
   resource: "onchain.networks.pools.trades",
@@ -4555,7 +4601,12 @@ Error Handling:
 };
 var handler43 = async (client2, args) => {
   const { pool_address, ...body } = args;
-  return asTextContentResult(await client2.onchain.networks.pools.trades.get(pool_address, body));
+  return asTextContentResult(
+    withTradeSummary(
+      await client2.onchain.networks.pools.trades.get(pool_address, body),
+      body.trade_volume_in_usd_greater_than
+    )
+  );
 };
 var get_pools_networks_onchain_trades_default = { metadata: metadata43, tool: tool43, handler: handler43 };
 
@@ -4745,6 +4796,8 @@ var handler45 = async (client2, args) => {
 var get_tokens_networks_onchain_info_default = { metadata: metadata45, tool: tool45, handler: handler45 };
 
 // src/tools/onchain/networks/tokens/top-holders/get-tokens-networks-onchain-top-holders.ts
+var TOP_HOLDERS_MAX = 50;
+var SOLANA_TOP_HOLDERS_MAX = 40;
 var metadata46 = {
   resource: "onchain.networks.tokens.top_holders",
   operation: "read",
@@ -4769,7 +4822,8 @@ Returns a ranked list of addresses holding the largest amounts of a token. Essen
 Args:
   - network (string, required): Network ID (e.g., "eth", "bsc", "solana"). Use coingecko_get_onchain_networks to find valid IDs.
   - address (string, required): Token contract address.
-  - holders (string, optional): Number of top holders to return. Use any integer or "max". Default: 10.
+  - limit (integer, optional): Number of top holders to return, 1-50 (Solana: 1-40, the most Hive's CoinGecko plan serves). Default: the plan maximum.
+  - holders (string, optional): Legacy alias for limit; an integer or "max". Values above the plan maximum, and "max", are capped to it.
   - include_pnl_details (boolean, optional): Include realized/unrealized P&L per holder (pnl_usd, cost_basis_usd, avg_buy_price_usd). Default: false.
 
 Returns:
@@ -4793,9 +4847,8 @@ Returns:
   }
 
 Examples:
-  - Top 10 USDC holders: {"network": "eth", "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}
-  - Top 50 holders: {"network": "eth", "address": "0xa0b86991...", "holders": "50"}
-  - All holders: {"network": "bsc", "address": "0x...", "holders": "max"}
+  - Top 50 USDC holders: {"network": "eth", "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"}
+  - Top 10 holders: {"network": "eth", "address": "0xa0b86991...", "limit": 10}
 
 Use when:
   - You need to identify major token holders (whales)
@@ -4804,6 +4857,7 @@ Use when:
   - You're tracking institutional or smart money positions
 
 Don't use when:
+  - You need the total holder count or how many holders are above a USD size (use get_token_holder_distribution)
   - You need historical holder count (use coingecko_get_onchain_token_holders_chart)
   - You need token metadata (use coingecko_get_onchain_token_info)
   - You need trading data (use coingecko_get_onchain_token_trades)
@@ -4825,9 +4879,15 @@ Error Handling:
         type: "string",
         description: "Token contract address. Required."
       },
+      limit: {
+        type: "integer",
+        minimum: 1,
+        maximum: TOP_HOLDERS_MAX,
+        description: `Number of top holders to return, 1-${TOP_HOLDERS_MAX} (Solana: 1-${SOLANA_TOP_HOLDERS_MAX}). Default: the plan maximum.`
+      },
       holders: {
         type: "string",
-        description: 'Number of top holders to return, or "max". Default: 10.'
+        description: 'Legacy alias for limit: an integer or "max". Capped to the plan maximum.'
       },
       include_pnl_details: {
         type: "boolean",
@@ -4838,10 +4898,19 @@ Error Handling:
   },
   annotations: VOLATILE_READ_ANNOTATIONS
 };
+function resolveTopHoldersCount(network, limit, holders) {
+  const cap = String(network ?? "").toLowerCase() === "solana" ? SOLANA_TOP_HOLDERS_MAX : TOP_HOLDERS_MAX;
+  const requested = Number(limit ?? (holders === "max" ? cap : holders ?? cap));
+  if (!Number.isFinite(requested) || requested < 1) return String(cap);
+  return String(Math.min(Math.floor(requested), cap));
+}
 var handler46 = async (client2, args) => {
-  const { address, ...body } = args;
+  const { address, limit, holders, ...body } = args ?? {};
   return asTextContentResult(
-    await client2.onchain.networks.tokens.topHolders.get(address, body)
+    await client2.onchain.networks.tokens.topHolders.get(address, {
+      ...body,
+      holders: resolveTopHoldersCount(body.network, limit, holders)
+    })
   );
 };
 var get_tokens_networks_onchain_top_holders_default = { metadata: metadata46, tool: tool46, handler: handler46 };
@@ -5255,7 +5324,12 @@ Error Handling:
 };
 var handler50 = async (client2, args) => {
   const { token_address, ...body } = args;
-  return asTextContentResult(await client2.onchain.networks.tokens.trades.get(token_address, body));
+  return asTextContentResult(
+    withTradeSummary(
+      await client2.onchain.networks.tokens.trades.get(token_address, body),
+      body.trade_volume_in_usd_greater_than
+    )
+  );
 };
 var get_tokens_networks_onchain_trades_default = { metadata: metadata50, tool: tool50, handler: handler50 };
 
@@ -7762,9 +7836,8 @@ Don't use when:
   - You need token metadata (use coingecko_get_onchain_token_info)
 
 Error Handling:
-  - Returns 404 if network or token address not found
+  - Returns 404 for tokens CoinGecko does not track traders for: wrapped native tokens (WETH, wSOL), stablecoins, and tokens created before 2023-09-01. Works on eth, base, solana and other networks for newer tokens.
   - Requires CoinGecko's Analyst plan or higher (a provider tier, not a Hive plan)
-  - Not all networks support trader tracking
   - Rate limited based on API plan`,
   inputSchema: {
     type: "object",
@@ -7803,7 +7876,7 @@ var handler79 = async (client2, args) => {
     if (error?.status === 404) {
       return asTextContentResult(
         {
-          error: `Invalid arguments: trader tracking is not available for ${address} on network "${network}" on the CoinGecko tier this account is on (404). Use coingecko_get_onchain_token_top_holders or get_token_top_holders for this token; traders are served on networks such as base.`,
+          error: `Invalid arguments: CoinGecko does not track top traders for ${address} on "${network}" (404). It covers tokens created after 2023-09-01 and excludes wrapped native tokens and stablecoins. Use coingecko_get_onchain_token_top_holders or get_token_top_holders for this token.`,
           code: "VALIDATION_ERROR",
           suggestion: "Call coingecko_get_onchain_token_top_holders with the same network and address."
         },
@@ -8394,17 +8467,18 @@ var handler87 = async (client2, args) => asTextContentResult(
 var get_total_supply_chart_range_default = { metadata: metadata87, tool: tool87, handler: handler87 };
 
 // src/tools/insights/get-insights.ts
+var INSIGHTS_SOURCE_NOTE = "AI-generated summary written by CoinGecko; not verified by Hive.";
 var metadata88 = {
   resource: "insights",
   operation: "read",
-  tags: ["coingecko", "coins", "insights", "research", "enterprise"],
+  tags: ["coingecko", "coins", "insights", "research", "ai-generated"],
   httpMethod: "get",
   httpPath: "/insights",
   operationId: "insights"
 };
 var tool88 = {
   name: "coingecko_get_coin_insights",
-  description: `Get CoinGecko's latest coin research insights. Requires a CoinGecko Enterprise API plan and returns a bounded page of at most 20 items.
+  description: `Get CoinGecko's AI-generated coin insights: short summaries of market catalysts, sentiment, and fundamentals. CoinGecko's AI writes these; Hive does not verify them, so treat them as context and confirm facts with market data. Returns a bounded page of at most 20 items.
 
 Args:
   - page (integer, optional): Page number from 1 to 20. Default: 1.
@@ -8414,7 +8488,7 @@ Args:
   - to (string, optional): End date in YYYY-MM-DD format.
 
 Returns:
-  JSON array of recent CoinGecko insight records, bounded to the requested page and page size.
+  { source_note, insights: [{ title, description, related_coin_ids, posted_at }] }, bounded to the requested page and page size.
 
 Examples:
   - Latest insights: {"page":1,"per_page":10}
@@ -8429,7 +8503,6 @@ Don't use when:
   - You need live prices or market rankings (use coingecko_get_coins_markets)
 
 Plan and freshness:
-  - CoinGecko marks this endpoint Enterprise-only.
   - CoinGecko documents a 60-second cache/update interval.
   - Insight publication time is supplied by CoinGecko; inspect each returned record before treating it as current.`,
   inputSchema: {
@@ -8482,10 +8555,398 @@ var handler88 = async (client2, args) => {
     from: args?.from,
     to: args?.to
   };
-  return asTextContentResult(await client2.get("/insights", { query }));
+  const insights = await client2.get("/insights", { query });
+  return asTextContentResult({ source_note: INSIGHTS_SOURCE_NOTE, insights });
 };
 var get_insights_default = { metadata: metadata88, tool: tool88, handler: handler88 };
 
+// src/tools/onchain/wallets/get-wallet-balances.ts
+var WALLET_BALANCE_NETWORKS = [
+  "eth",
+  "base",
+  "bsc",
+  "polygon_pos",
+  "arbitrum",
+  "optimism",
+  "avax",
+  "linea",
+  "stable",
+  "robinhood",
+  "arc"
+];
+var metadata89 = {
+  resource: "onchain.wallets.balances",
+  operation: "read",
+  tags: [
+    "coingecko",
+    "onchain",
+    "wallets",
+    "balances",
+    "portfolio",
+    "geckoterminal"
+  ],
+  httpMethod: "get",
+  httpPath: "/onchain/wallets/{address}/balances",
+  operationId: "wallet-balances-address"
+};
+var tool89 = {
+  name: "coingecko_get_onchain_wallet_balances",
+  description: `Get a wallet's token balances with USD values and 24h price change across several EVM networks in one call.
+
+Args:
+  - address (string, required): EVM wallet address (0x\u2026).
+  - networks (string, optional): Comma-separated GeckoTerminal network ids. Default: all supported (${WALLET_BALANCE_NETWORKS.join(",")}). EVM only; Solana is rejected.
+  - page (integer, optional): Page number. Default 1.
+  - per_page (integer, optional): Tokens per page, 1-100. Default 100.
+
+Returns:
+  data.attributes with total_value_usd, total_holdings, a per-network value breakdown, and balances sorted by value: network, address, token_type ("native" rows use 0xeeee\u2026eeee), symbol, decimals, balance (decimal string), price_usd, value_usd, h24_price_change_percentage, total_reserve_in_usd (pool liquidity behind the price). Numbers are strings.
+
+Examples:
+  - All supported networks: {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}
+  - Base only: {"address":"0x\u2026","networks":"base"}
+
+Use when:
+  - You need a priced multi-chain EVM portfolio in one call.
+
+Don't use when:
+  - The wallet is on Solana (use helius_get_wallet_balances).
+  - You need realized or unrealized PnL (use get_wallet_pnl).
+
+Notes:
+  - value_usd uses DEX prices; a large value_usd with a small total_reserve_in_usd usually means an illiquid or spam token.`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      address: {
+        type: "string",
+        minLength: 1,
+        maxLength: 100,
+        description: "EVM wallet address (0x\u2026). Required."
+      },
+      networks: {
+        type: "string",
+        maxLength: 200,
+        description: `Comma-separated network ids. Default: ${WALLET_BALANCE_NETWORKS.join(",")}.`
+      },
+      page: {
+        type: "integer",
+        minimum: 1,
+        maximum: 500,
+        description: "Page number, 1-500. Default 1."
+      },
+      per_page: {
+        type: "integer",
+        minimum: 1,
+        maximum: 100,
+        description: "Tokens per page, 1-100. Default 100."
+      }
+    },
+    required: ["address"],
+    additionalProperties: false
+  },
+  annotations: VOLATILE_READ_ANNOTATIONS
+};
+var handler89 = async (client2, args) => {
+  const address = String(args?.address ?? "").trim();
+  const query = {
+    networks: args?.networks ?? WALLET_BALANCE_NETWORKS.join(","),
+    page: args?.page,
+    per_page: args?.per_page ?? 100
+  };
+  return asTextContentResult(
+    await client2.get(
+      `/onchain/wallets/${encodeURIComponent(address)}/balances`,
+      { query }
+    )
+  );
+};
+var get_wallet_balances_default = { metadata: metadata89, tool: tool89, handler: handler89 };
+
+// src/tools/onchain/wallets/get-wallet-pnl.ts
+var metadata90 = {
+  resource: "onchain.wallets.pnl",
+  operation: "read",
+  tags: [
+    "coingecko",
+    "onchain",
+    "wallets",
+    "pnl",
+    "profitability",
+    "geckoterminal"
+  ],
+  httpMethod: "get",
+  httpPath: "/onchain/wallets/{address}/pnl",
+  operationId: "wallet-pnl-address"
+};
+var tool90 = {
+  name: "coingecko_get_onchain_wallet_pnl",
+  description: `Get a wallet's realized and unrealized DEX trading PnL, in total, per network, and per token.
+
+Args:
+  - address (string, required): Wallet address.
+  - networks (string, optional): Comma-separated GeckoTerminal network ids, all from one VM family (all EVM, or "solana"). Default: ${WALLET_BALANCE_NETWORKS.join(",")}. Any GeckoTerminal network is accepted.
+  - page (integer, optional): Page number. Default 1.
+  - per_page (integer, optional): Tokens per page, 1-300. Default 50.
+
+Returns:
+  data.attributes with total_realized_pnl_usd, total_unrealized_pnl_usd, total_tokens, a per-network breakdown, and token_stats rows: network, address, symbol, realized_pnl_usd, unrealized_pnl_usd, average_buy_price_usd, average_sell_price_usd, total_buy/sell_count, total_buy/sell_usd. Numbers are strings; unrealized_pnl_usd is null when the token is no longer held.
+
+Examples:
+  - EVM PnL: {"address":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"}
+  - Solana PnL: {"address":"<base58>","networks":"solana"}
+
+Use when:
+  - You need to know whether a wallet trades profitably, or which tokens made or lost it money.
+
+Don't use when:
+  - You need current holdings (use get_wallet_balances).
+  - You need the individual trades (use get_wallet_trades).
+
+Notes:
+  - PnL is computed from DEX trades CoinGecko indexes; CEX activity and OTC transfers are not counted.`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      address: {
+        type: "string",
+        minLength: 1,
+        maxLength: 100,
+        description: "Wallet address. Required."
+      },
+      networks: {
+        type: "string",
+        maxLength: 200,
+        description: `Comma-separated network ids from one VM family. Default: ${WALLET_BALANCE_NETWORKS.join(",")}.`
+      },
+      page: {
+        type: "integer",
+        minimum: 1,
+        maximum: 500,
+        description: "Page number, 1-500. Default 1."
+      },
+      per_page: {
+        type: "integer",
+        minimum: 1,
+        maximum: 300,
+        description: "Tokens per page, 1-300. Default 50."
+      }
+    },
+    required: ["address"],
+    additionalProperties: false
+  },
+  annotations: VOLATILE_READ_ANNOTATIONS
+};
+var handler90 = async (client2, args) => {
+  const address = String(args?.address ?? "").trim();
+  const query = {
+    networks: args?.networks ?? WALLET_BALANCE_NETWORKS.join(","),
+    page: args?.page,
+    per_page: args?.per_page ?? 50
+  };
+  return asTextContentResult(
+    await client2.get(`/onchain/wallets/${encodeURIComponent(address)}/pnl`, {
+      query
+    })
+  );
+};
+var get_wallet_pnl_default = { metadata: metadata90, tool: tool90, handler: handler90 };
+
+// src/tools/onchain/networks/wallets/get-wallet-trades.ts
+function walletWindowError(args) {
+  if (args?.from == null === (args?.to == null)) return null;
+  return asTextContentResult(
+    {
+      error: "Invalid arguments: pass both from and to (YYYY-MM-DD, at most 30 days apart), or neither for the last 7 days.",
+      code: "VALIDATION_ERROR"
+    },
+    true
+  );
+}
+var WALLET_WINDOW_PROPERTIES = {
+  from: {
+    type: "string",
+    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+    description: "Window start, YYYY-MM-DD. Send with to; window at most 30 days. Default: last 7 days."
+  },
+  to: {
+    type: "string",
+    pattern: "^\\d{4}-\\d{2}-\\d{2}$",
+    description: "Window end, YYYY-MM-DD. Send with from."
+  },
+  cursor: {
+    type: "string",
+    maxLength: 500,
+    description: "meta.next_cursor from the previous page. Omit for the first page."
+  },
+  per_page: {
+    type: "integer",
+    minimum: 1,
+    maximum: 300,
+    description: "Rows per page, 1-300. Default 100."
+  }
+};
+var metadata91 = {
+  resource: "onchain.networks.wallets.trades",
+  operation: "read",
+  tags: ["coingecko", "onchain", "wallets", "trades", "swaps", "geckoterminal"],
+  httpMethod: "get",
+  httpPath: "/onchain/networks/{network}/wallets/{address}/trades",
+  operationId: "wallet-trades-address"
+};
+var tool91 = {
+  name: "coingecko_get_onchain_wallet_trades",
+  description: `Get a wallet's DEX buys and sells on one network, with USD prices at execution time.
+
+Args:
+  - network (string, required): GeckoTerminal network id, e.g. "eth", "base", "solana". Any GeckoTerminal network.
+  - address (string, required): Wallet address.
+  - from, to (string, optional): YYYY-MM-DD window, sent together, at most 30 days. Default: last 7 days.
+  - cursor (string, optional): meta.next_cursor from the previous page.
+  - per_page (integer, optional): 1-300. Default 100.
+
+Returns:
+  data rows with pool_address, pool_dex, kind (buy/sell), from/to_token_address, from/to_token_amount, price_from/to_in_usd, volume_in_usd, tx_hash, block_timestamp; meta.next_cursor (null on the last page). An empty data array means no DEX trades in the window.
+
+Examples:
+  - Last 7 days on Base: {"network":"base","address":"0x\u2026"}
+  - September on Ethereum: {"network":"eth","address":"0x\u2026","from":"2026-09-01","to":"2026-09-30"}
+
+Use when:
+  - You need what a wallet bought and sold, and at what price.
+
+Don't use when:
+  - You need all token movements including plain transfers (use get_wallet_transfers).
+  - You need the PnL summary (use get_wallet_pnl).`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      network: {
+        type: "string",
+        minLength: 1,
+        maxLength: 60,
+        description: 'GeckoTerminal network id, e.g. "eth". Required.'
+      },
+      address: {
+        type: "string",
+        minLength: 1,
+        maxLength: 100,
+        description: "Wallet address. Required."
+      },
+      ...WALLET_WINDOW_PROPERTIES
+    },
+    required: ["network", "address"],
+    additionalProperties: false
+  },
+  annotations: VOLATILE_READ_ANNOTATIONS
+};
+var handler91 = async (client2, args) => {
+  const invalid2 = walletWindowError(args);
+  if (invalid2) return invalid2;
+  const network = encodeURIComponent(String(args?.network ?? "").trim());
+  const address = encodeURIComponent(String(args?.address ?? "").trim());
+  const query = {
+    from: args?.from,
+    to: args?.to,
+    cursor: args?.cursor,
+    per_page: args?.per_page ?? 100
+  };
+  return asTextContentResult(
+    await client2.get(`/onchain/networks/${network}/wallets/${address}/trades`, {
+      query
+    })
+  );
+};
+var get_wallet_trades_default = { metadata: metadata91, tool: tool91, handler: handler91 };
+
+// src/tools/onchain/networks/wallets/get-wallet-transfers.ts
+var metadata92 = {
+  resource: "onchain.networks.wallets.transfers",
+  operation: "read",
+  tags: ["coingecko", "onchain", "wallets", "transfers", "geckoterminal"],
+  httpMethod: "get",
+  httpPath: "/onchain/networks/{network}/wallets/{address}/transfers",
+  operationId: "wallet-transfers-address"
+};
+var tool92 = {
+  name: "coingecko_get_onchain_wallet_transfers",
+  description: `Get a wallet's inbound and outbound token transfers on one EVM network.
+
+Args:
+  - network (string, required): One of ${WALLET_BALANCE_NETWORKS.join(", ")}.
+  - address (string, required): EVM wallet address (0x\u2026).
+  - direction (string, optional): "in" or "out". Default both.
+  - token (string, optional): Only transfers of this token contract address.
+  - from, to (string, optional): YYYY-MM-DD window, sent together, at most 30 days. Default: last 7 days.
+  - cursor (string, optional): meta.next_cursor from the previous page.
+  - per_page (integer, optional): 1-300. Default 100.
+
+Returns:
+  data rows with block_number, tx_hash, direction, token_address, symbol, decimals, amount (decimal string), from_address, to_address, block_timestamp; meta.next_cursor (null on the last page).
+
+Examples:
+  - Recent inbound on Ethereum: {"network":"eth","address":"0x\u2026","direction":"in"}
+
+Use when:
+  - You need who sent a wallet what, or where its tokens went.
+
+Don't use when:
+  - The wallet is on Solana (use helius_get_wallet_transfers).
+  - You only need DEX buys and sells (use get_wallet_trades).`,
+  inputSchema: {
+    type: "object",
+    properties: {
+      network: {
+        type: "string",
+        minLength: 1,
+        maxLength: 60,
+        description: 'Network id, e.g. "eth". Required.'
+      },
+      address: {
+        type: "string",
+        minLength: 1,
+        maxLength: 100,
+        description: "EVM wallet address. Required."
+      },
+      direction: {
+        type: "string",
+        enum: ["in", "out"],
+        description: "Transfer direction. Default both."
+      },
+      token: {
+        type: "string",
+        maxLength: 100,
+        description: "Token contract address filter."
+      },
+      ...WALLET_WINDOW_PROPERTIES
+    },
+    required: ["network", "address"],
+    additionalProperties: false
+  },
+  annotations: VOLATILE_READ_ANNOTATIONS
+};
+var handler92 = async (client2, args) => {
+  const invalid2 = walletWindowError(args);
+  if (invalid2) return invalid2;
+  const network = encodeURIComponent(String(args?.network ?? "").trim());
+  const address = encodeURIComponent(String(args?.address ?? "").trim());
+  const query = {
+    direction: args?.direction,
+    token: args?.token,
+    from: args?.from,
+    to: args?.to,
+    cursor: args?.cursor,
+    per_page: args?.per_page ?? 100
+  };
+  return asTextContentResult(
+    await client2.get(
+      `/onchain/networks/${network}/wallets/${address}/transfers`,
+      { query }
+    )
+  );
+};
+var get_wallet_transfers_default = { metadata: metadata92, tool: tool92, handler: handler92 };
+
 // src/tools/rwas/query.ts
 function pickQuery(args, keys) {
   const query = {};
@@ -8522,7 +8983,7 @@ var PRECISION_VALUES = [
 ];
 
 // src/tools/rwas/get-rwas-list.ts
-var metadata89 = {
+var metadata93 = {
   resource: "rwas",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "stocks", "commodities", "etf", "list"],
@@ -8530,7 +8991,7 @@ var metadata89 = {
   httpPath: "/rwas/list",
   operationId: "rwas-list"
 };
-var tool89 = {
+var tool93 = {
   name: "coingecko_get_rwa_list",
   description: `List every tokenized real-world asset (RWA) that CoinGecko tracks: tokenized stocks, commodities, and ETFs with spot market data. Use it to resolve the RWA asset IDs the other coingecko_get_rwa_* tools take.
 
@@ -8577,15 +9038,15 @@ Plan and freshness:
   },
   annotations: READ_ONLY_ANNOTATIONS
 };
-var handler89 = async (client2, args) => {
+var handler93 = async (client2, args) => {
   return asTextContentResult(
     await client2.get("/rwas/list", { query: pickQuery(args, ["asset_type"]) })
   );
 };
-var get_rwas_list_default = { metadata: metadata89, tool: tool89, handler: handler89 };
+var get_rwas_list_default = { metadata: metadata93, tool: tool93, handler: handler93 };
 
 // src/tools/rwas/get-rwas-markets.ts
-var metadata90 = {
+var metadata94 = {
   resource: "rwas.markets",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "stocks", "commodities", "etf", "markets", "price"],
@@ -8606,7 +9067,7 @@ var QUERY_KEYS = [
   "price_change_percentage",
   "sparkline"
 ];
-var tool90 = {
+var tool94 = {
   name: "coingecko_get_rwa_markets",
   description: `Get CoinGecko spot market data for tokenized real-world assets (RWAs): tokenized stocks, commodities, and ETFs, with USD price, market cap, and 24h volume aggregated across every token that wraps each asset. This is spot data for the tokenized versions, not the traditional exchange quote and not perpetual futures.
 
@@ -8740,15 +9201,15 @@ Plan and freshness:
   },
   annotations: VOLATILE_READ_ANNOTATIONS
 };
-var handler90 = async (client2, args) => {
+var handler94 = async (client2, args) => {
   return asTextContentResult(
     await client2.get("/rwas/markets", { query: pickQuery(args, QUERY_KEYS) })
   );
 };
-var get_rwas_markets_default = { metadata: metadata90, tool: tool90, handler: handler90 };
+var get_rwas_markets_default = { metadata: metadata94, tool: tool94, handler: handler94 };
 
 // src/tools/rwas/get-rwas-asset.ts
-var metadata91 = {
+var metadata95 = {
   resource: "rwas",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "stocks", "commodities", "etf", "details", "tokens"],
@@ -8757,7 +9218,7 @@ var metadata91 = {
   operationId: "rwas-id"
 };
 var QUERY_KEYS2 = ["sparkline", "tokenized_market_data", "tokens"];
-var tool91 = {
+var tool95 = {
   name: "coingecko_get_rwa_asset",
   description: `Get one tokenized real-world asset (RWA) from CoinGecko by ID: a tokenized stock, commodity, or ETF, with its metadata, aggregated spot market data, and the list of tokens that wrap it, each with contract addresses per chain and its issuer.
 
@@ -8834,17 +9295,17 @@ Plan and freshness:
   },
   annotations: VOLATILE_READ_ANNOTATIONS
 };
-var handler91 = async (client2, args) => {
+var handler95 = async (client2, args) => {
   return asTextContentResult(
     await client2.get(`/rwas/${pathId(args)}`, {
       query: pickQuery(args, QUERY_KEYS2)
     })
   );
 };
-var get_rwas_asset_default = { metadata: metadata91, tool: tool91, handler: handler91 };
+var get_rwas_asset_default = { metadata: metadata95, tool: tool95, handler: handler95 };
 
 // src/tools/rwas/get-rwas-tickers.ts
-var metadata92 = {
+var metadata96 = {
   resource: "rwas.tickers",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "stocks", "commodities", "etf", "tickers", "exchanges", "liquidity"],
@@ -8860,7 +9321,7 @@ var QUERY_KEYS3 = [
   "order",
   "page"
 ];
-var tool92 = {
+var tool96 = {
   name: "coingecko_get_rwa_tickers",
   description: `Get exchange tickers for one tokenized real-world asset (RWA) on CoinGecko: every spot pair, across centralized and decentralized exchanges, for the tokens that wrap a given stock, commodity, or ETF. Requires a CoinGecko Basic plan or above.
 
@@ -8950,17 +9411,17 @@ Plan and freshness:
   },
   annotations: VOLATILE_READ_ANNOTATIONS
 };
-var handler92 = async (client2, args) => {
+var handler96 = async (client2, args) => {
   return asTextContentResult(
     await client2.get(`/rwas/${pathId(args)}/tickers`, {
       query: pickQuery(args, QUERY_KEYS3)
     })
   );
 };
-var get_rwas_tickers_default = { metadata: metadata92, tool: tool92, handler: handler92 };
+var get_rwas_tickers_default = { metadata: metadata96, tool: tool96, handler: handler96 };
 
 // src/tools/rwas/get-rwas-market-chart.ts
-var metadata93 = {
+var metadata97 = {
   resource: "rwas.market_chart",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "stocks", "commodities", "etf", "chart", "historical"],
@@ -8969,7 +9430,7 @@ var metadata93 = {
   operationId: "rwas-id-market-chart"
 };
 var QUERY_KEYS4 = ["days", "interval", "precision"];
-var tool93 = {
+var tool97 = {
   name: "coingecko_get_rwa_market_chart",
   description: `Get historical spot price, market cap, and volume series for one tokenized real-world asset (RWA) on CoinGecko: a tokenized stock, commodity, or ETF, aggregated across the tokens that wrap it. Requires a CoinGecko Basic plan or above.
 
@@ -9037,17 +9498,17 @@ Plan and freshness:
   },
   annotations: HISTORICAL_ANNOTATIONS
 };
-var handler93 = async (client2, args) => {
+var handler97 = async (client2, args) => {
   const query = pickQuery(args, QUERY_KEYS4);
   if (query.days === void 0) query.days = "1";
   return asTextContentResult(
     await client2.get(`/rwas/${pathId(args)}/market_chart`, { query })
   );
 };
-var get_rwas_market_chart_default = { metadata: metadata93, tool: tool93, handler: handler93 };
+var get_rwas_market_chart_default = { metadata: metadata97, tool: tool97, handler: handler97 };
 
 // src/tools/rwas/get-rwas-issuers.ts
-var metadata94 = {
+var metadata98 = {
   resource: "rwas.issuers",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "issuers", "list"],
@@ -9055,7 +9516,7 @@ var metadata94 = {
   httpPath: "/rwas/issuers/list",
   operationId: "rwas-issuers-list"
 };
-var tool94 = {
+var tool98 = {
   name: "coingecko_get_rwa_issuers",
   description: `List every issuer of tokenized real-world assets (RWAs) that CoinGecko tracks with spot market data: the companies and protocols that mint tokenized stocks, commodities, and ETFs, such as Ondo, Backed, Paxos, Dinari, and Robinhood. Use it to resolve issuer IDs for coingecko_get_rwa_issuer and for the issuer filters on coingecko_get_rwa_markets and coingecko_get_rwa_tickers.
 
@@ -9093,13 +9554,13 @@ Plan and freshness:
   },
   annotations: READ_ONLY_ANNOTATIONS
 };
-var handler94 = async (client2, _args) => {
+var handler98 = async (client2, _args) => {
   return asTextContentResult(await client2.get("/rwas/issuers/list"));
 };
-var get_rwas_issuers_default = { metadata: metadata94, tool: tool94, handler: handler94 };
+var get_rwas_issuers_default = { metadata: metadata98, tool: tool98, handler: handler98 };
 
 // src/tools/rwas/get-rwas-issuer.ts
-var metadata95 = {
+var metadata99 = {
   resource: "rwas.issuers",
   operation: "read",
   tags: ["coingecko", "rwa", "tokenized", "issuers", "details", "tokens"],
@@ -9107,7 +9568,7 @@ var metadata95 = {
   httpPath: "/rwas/issuers/{id}",
   operationId: "rwas-issuers-id"
 };
-var tool95 = {
+var tool99 = {
   name: "coingecko_get_rwa_issuer",
   description: `Get one issuer of tokenized real-world assets (RWAs) from CoinGecko by ID, with its aggregated spot market cap and 24h volume across every tokenized stock, commodity, and ETF it has minted, plus the full token catalog with per-chain contract addresses.
 
@@ -9167,12 +9628,12 @@ Plan and freshness:
   },
   annotations: VOLATILE_READ_ANNOTATIONS
 };
-var handler95 = async (client2, args) => {
+var handler99 = async (client2, args) => {
   return asTextContentResult(
     await client2.get(`/rwas/issuers/${pathId(args)}`)
   );
 };
-var get_rwas_issuer_default = { metadata: metadata95, tool: tool95, handler: handler95 };
+var get_rwas_issuer_default = { metadata: metadata99, tool: tool99, handler: handler99 };
 
 // src/db/supabase.ts
 import { createClient } from "@supabase/supabase-js";
@@ -9341,24 +9802,24 @@ var secureLogger = {
   /**
    * Log authentication events without exposing tokens
    */
-  authEvent: (event, success, metadata100) => {
+  authEvent: (event, success, metadata104) => {
     const logData = {
       event,
       success,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-      ...sanitizeObject(metadata100 || {})
+      ...sanitizeObject(metadata104 || {})
     };
     console.error(formatLogMessage("AUTH", event, logData));
   },
   /**
    * Log MCP tool calls for analytics
    */
-  toolCall: (toolName, success, durationMs, metadata100) => {
+  toolCall: (toolName, success, durationMs, metadata104) => {
     const logData = {
       tool: toolName,
       success,
       durationMs,
-      ...sanitizeObject(metadata100 || {})
+      ...sanitizeObject(metadata104 || {})
     };
     console.error(
       formatLogMessage(
@@ -9371,12 +9832,12 @@ var secureLogger = {
   /**
    * Log request/response for debugging (sanitized)
    */
-  request: (method, path, statusCode, metadata100) => {
+  request: (method, path, statusCode, metadata104) => {
     const logData = {
       method,
       path,
       statusCode,
-      ...sanitizeObject(metadata100 || {})
+      ...sanitizeObject(metadata104 || {})
     };
     console.error(formatLogMessage("REQUEST", `${method} ${path}`, logData));
   }
@@ -10018,8 +10479,8 @@ function canonicalJson2(value) {
   }
   return JSON.stringify(value) ?? "null";
 }
-function cleanMonitorMetadata(metadata100) {
-  const cleaned = { ...metadata100 ?? {} };
+function cleanMonitorMetadata(metadata104) {
+  const cleaned = { ...metadata104 ?? {} };
   delete cleaned.idempotency_key;
   delete cleaned.idempotency_fingerprint;
   delete cleaned.legacy_duplicate_idempotency_key;
@@ -10055,15 +10516,15 @@ function monitorCreateFingerprint(input) {
   ).digest("hex");
 }
 function existingMonitorFingerprint(existing) {
-  const metadata100 = existing.metadata ?? {};
-  const stored = metadata100.idempotency_fingerprint;
+  const metadata104 = existing.metadata ?? {};
+  const stored = metadata104.idempotency_fingerprint;
   if (typeof stored === "string" && /^[a-f0-9]{64}$/.test(stored)) {
     return stored;
   }
   return monitorCreateFingerprint({
     cadence: existing.cadence,
     kind: existing.kind,
-    metadata: metadata100,
+    metadata: metadata104,
     name: existing.name,
     nextRunAt: existing.next_run_at,
     rules: existing.rules,
@@ -10833,7 +11294,7 @@ var hiveCreateMonitor = {
     const target = parseMonitorTarget(args?.target);
     const rules = parseMonitorRules(args?.rules);
     const status = parseMonitorStatus(args?.status);
-    const metadata100 = parseMonitorMetadata(args?.metadata);
+    const metadata104 = parseMonitorMetadata(args?.metadata);
     const name = stringArg(args, "name");
     if (!name) {
       return result(
@@ -10881,7 +11342,7 @@ var hiveCreateMonitor = {
         "monitor"
       );
     }
-    if (args?.metadata !== void 0 && !metadata100) {
+    if (args?.metadata !== void 0 && !metadata104) {
       return result(
         {
           ok: false,
@@ -10913,7 +11374,7 @@ var hiveCreateMonitor = {
         cadence: stringArg(args, "cadence"),
         status,
         nextRunAt: stringArg(args, "next_run_at") ?? null,
-        metadata: metadata100,
+        metadata: metadata104,
         idempotencyKey
       }),
       "monitor"
@@ -11100,7 +11561,7 @@ var hiveUpdateMonitor = {
     const status = parseMonitorStatus(args?.status);
     const target = args?.target === void 0 ? void 0 : parseMonitorTarget(args?.target);
     const rules = args?.rules === void 0 ? void 0 : parseMonitorRules(args?.rules);
-    const metadata100 = args?.metadata === void 0 ? void 0 : parseMonitorMetadata(args?.metadata);
+    const metadata104 = args?.metadata === void 0 ? void 0 : parseMonitorMetadata(args?.metadata);
     if (args?.status !== void 0 && !status) {
       return result(
         {
@@ -11131,7 +11592,7 @@ var hiveUpdateMonitor = {
         "monitor"
       );
     }
-    if (args?.metadata !== void 0 && !metadata100) {
+    if (args?.metadata !== void 0 && !metadata104) {
       return result(
         {
           ok: false,
@@ -11152,7 +11613,7 @@ var hiveUpdateMonitor = {
         rules,
         cadence: stringArg(args, "cadence"),
         nextRunAt: args?.next_run_at === void 0 ? void 0 : stringArg(args, "next_run_at") ?? null,
-        metadata: metadata100
+        metadata: metadata104
       }),
       "monitor"
     );
@@ -12044,14 +12505,14 @@ function validateFeedbackInput(input) {
       `Invalid arguments: message is ${message.length} characters; the limit is ${FEEDBACK_MAX_MESSAGE_CHARS}.`
     );
   }
-  let tool96 = null;
+  let tool100 = null;
   if (input.tool !== void 0 && input.tool !== null) {
     if (typeof input.tool !== "string" || !isToolNameShaped(input.tool)) {
       throw new FeedbackValidationError(
         "Invalid arguments: tool must be a Hive tool name (lowercase letters, digits and underscores, 3 to 128 characters) or omitted."
       );
     }
-    tool96 = input.tool;
+    tool100 = input.tool;
   }
   let receiptId = null;
   if (input.receiptId !== void 0 && input.receiptId !== null) {
@@ -12062,7 +12523,7 @@ function validateFeedbackInput(input) {
     }
     receiptId = input.receiptId.toLowerCase();
   }
-  return { message: scrubFeedbackText(message), tool: tool96, receiptId };
+  return { message: scrubFeedbackText(message), tool: tool100, receiptId };
 }
 function withTimeout(promise, ms) {
   return new Promise((resolve, reject) => {
@@ -12367,6 +12828,10 @@ function getAllEndpoints() {
   list.push(get_total_supply_chart_default);
   list.push(get_total_supply_chart_range_default);
   list.push(get_insights_default);
+  list.push(get_wallet_balances_default);
+  list.push(get_wallet_pnl_default);
+  list.push(get_wallet_trades_default);
+  list.push(get_wallet_transfers_default);
   list.push(get_rwas_list_default);
   list.push(get_rwas_markets_default);
   list.push(get_rwas_asset_default);
@@ -16573,6 +17038,30 @@ var wrapper = {
         oldToolName: "coingecko_get_coin_insights"
       }
     },
+    {
+      tool: {
+        name: "get_wallet_balances",
+        oldToolName: "coingecko_get_onchain_wallet_balances"
+      }
+    },
+    {
+      tool: {
+        name: "get_wallet_pnl",
+        oldToolName: "coingecko_get_onchain_wallet_pnl"
+      }
+    },
+    {
+      tool: {
+        name: "get_wallet_trades",
+        oldToolName: "coingecko_get_onchain_wallet_trades"
+      }
+    },
+    {
+      tool: {
+        name: "get_wallet_transfers",
+        oldToolName: "coingecko_get_onchain_wallet_transfers"
+      }
+    },
     {
       tool: {
         name: "get_token_lists",
@@ -18117,6 +18606,16 @@ var wrapper = {
         oldToolName: "ccxt_fetch_convert_quote"
       }
     }
+  ],
+  // Blockscout tools describe themselves; these entries only admit the
+  // unprefixed name (src/tools/blockscout/tools.ts).
+  getAllBlockscoutEndpoints: [
+    {
+      tool: {
+        name: "get_token_holder_distribution",
+        oldToolName: "get_token_holder_distribution"
+      }
+    }
   ]
 };
 
@@ -18139,10 +18638,10 @@ function setupLogger() {
   const consoleFormat = winston.format.combine(
     winston.format.colorize(),
     winston.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
-    winston.format.printf(({ timestamp, level, message, ...metadata100 }) => {
+    winston.format.printf(({ timestamp, level, message, ...metadata104 }) => {
       let msg = `${timestamp} [${level}]: ${message}`;
-      if (Object.keys(metadata100).length > 0) {
-        msg += ` ${JSON.stringify(metadata100)}`;
+      if (Object.keys(metadata104).length > 0) {
+        msg += ` ${JSON.stringify(metadata104)}`;
       }
       return msg;
     })
@@ -26685,10 +27184,10 @@ function setupTools(apiClient) {
     ...derivativesVolumesTools(apiClient),
     ...metadataTools(apiClient)
   ];
-  toolCategories.forEach((tool96) => {
-    const execute = tool96.execute.bind(tool96);
-    tools5[tool96.name] = {
-      ...tool96,
+  toolCategories.forEach((tool100) => {
+    const execute = tool100.execute.bind(tool100);
+    tools5[tool100.name] = {
+      ...tool100,
       execute: async (args) => normalizeMcpErrorResult(await execute(args))
     };
   });
@@ -30771,7 +31270,7 @@ var handlers2 = {
     "ccxt_fetch_open_interest_multi"
   )
 };
-var metadata96 = {
+var metadata100 = {
   fetchMarkets: fetchMarketsMetadata,
   fetchCurrencies: fetchCurrenciesMetadata,
   fetchTicker: fetchTickerMetadata,
@@ -30887,8 +31386,8 @@ var CCXT_REQUIRED_BATCH_FILTERS = {
   ccxt_fetch_borrow_rate_histories: "codes",
   ccxt_fetch_all_greeks: "symbols"
 };
-function withCcxtBounds(tool96) {
-  const schema = tool96.inputSchema;
+function withCcxtBounds(tool100) {
+  const schema = tool100.inputSchema;
   const properties = Object.fromEntries(
     Object.entries(schema.properties || {}).map(
       ([name, rawProperty]) => {
@@ -30907,13 +31406,13 @@ function withCcxtBounds(tool96) {
     )
   );
   const required = new Set(schema.required || []);
-  const explicitFilter = CCXT_REQUIRED_BATCH_FILTERS[tool96.name];
+  const explicitFilter = CCXT_REQUIRED_BATCH_FILTERS[tool100.name];
   if (explicitFilter) required.add(explicitFilter);
   return {
-    ...tool96,
-    description: explicitFilter ? `${tool96.description}
+    ...tool100,
+    description: explicitFilter ? `${tool100.description}
 
-Hive safety bound: ${explicitFilter} is required and accepts at most 100 entries; unbounded all-market reads are rejected.` : tool96.description,
+Hive safety bound: ${explicitFilter} is required and accepts at most 100 entries; unbounded all-market reads are rejected.` : tool100.description,
     inputSchema: {
       ...schema,
       type: "object",
@@ -30924,10 +31423,10 @@ Hive safety bound: ${explicitFilter} is required and accepts at most 100 entries
   };
 }
 var tools = Object.fromEntries(
-  Object.entries(rawTools).map(([key, tool96]) => [key, withCcxtBounds(tool96)])
+  Object.entries(rawTools).map(([key, tool100]) => [key, withCcxtBounds(tool100)])
 );
 var exportedHandlers = handlers2;
-var ccxt_default = { metadata: metadata96, tools, handlers: exportedHandlers };
+var ccxt_default = { metadata: metadata100, tools, handlers: exportedHandlers };
 
 // src/tools/ccxt/index.ts
 function getAllCCXTEndpoints() {
@@ -31768,7 +32267,7 @@ Use when:
   - You need accurate gas estimation for a complex transaction
 
 Don't use when:
-  - You only need current token balances (use moralis_get_wallet_token_balances)
+  - You only need current token balances (use get_wallet_balances)
   - You want historical transaction data (use moralis_get_wallet_history)
   - You need token security analysis without simulation (use goplus_ tools)`,
   inputSchema: {
@@ -31848,7 +32347,7 @@ function handleSimulateTransaction(clientParam, args) {
         "Set TENDERLY_API_KEY, TENDERLY_ACCOUNT_SLUG, and TENDERLY_PROJECT_SLUG environment variables.",
         [
           "goplus_check_token_security \u2014 for token risk analysis without simulation",
-          "moralis_get_wallet_token_balances \u2014 for current wallet balances"
+          "get_wallet_balances \u2014 for current wallet balances"
         ],
         {
           network_id: "1",
@@ -31887,7 +32386,7 @@ function handleSimulateTransaction(clientParam, args) {
       "Check that network_id is valid, from/to are valid addresses, and input is properly hex-encoded.",
       [
         "goplus_check_token_security \u2014 for token risk analysis",
-        "moralis_get_wallet_token_balances \u2014 for current balances"
+        "get_wallet_balances \u2014 for current balances"
       ],
       {
         network_id: "1",
@@ -32428,7 +32927,7 @@ function handleGetBlockNumber(clientParam, args) {
   );
 }
 function makeGatewayTool(key, name, method, description, properties, required, buildParams) {
-  const metadata100 = {
+  const metadata104 = {
     resource: `tenderly.gateway.${method}`,
     operation: "read",
     tags: ["blockchain", "evm", "tenderly", "gateway", "read"],
@@ -32436,7 +32935,7 @@ function makeGatewayTool(key, name, method, description, properties, required, b
     httpPath: "/{network}.gateway.tenderly.co/{accessKey}",
     operationId: `tenderly-${method.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)}`
   };
-  const tool96 = {
+  const tool100 = {
     name,
     title: name.replace(/^tenderly_/, "").replace(/_/g, " ").replace(/\b\w/g, (character) => character.toUpperCase()),
     description: `${description}
@@ -32463,7 +32962,7 @@ Requires TENDERLY_NODE_ACCESS_KEY (or TENDERLY_GATEWAY_ACCESS_KEY). This is a re
       openWorldHint: true
     }
   };
-  const handler96 = async (clientParam, args = {}) => {
+  const handler100 = async (clientParam, args = {}) => {
     const client2 = resolveClient(clientParam);
     if (!client2) {
       return createErrorResponse3(
@@ -32493,7 +32992,7 @@ Requires TENDERLY_NODE_ACCESS_KEY (or TENDERLY_GATEWAY_ACCESS_KEY). This is a re
       );
     }
   };
-  return { key, tool: tool96, metadata: metadata100, handler: handler96 };
+  return { key, tool: tool100, metadata: metadata104, handler: handler100 };
 }
 var accessListProp = {
   type: "array",
@@ -32900,7 +33399,7 @@ var gatewayDefinitions = [
     }
   )
 ];
-var metadata97 = {
+var metadata101 = {
   simulateTransaction: simulateTransactionMetadata2,
   simulateBundle: simulateBundleMetadata,
   estimateGas: estimateGasMetadata,
@@ -32927,7 +33426,7 @@ var handlers3 = {
   getBlockNumber: handleGetBlockNumber,
   ...Object.fromEntries(gatewayDefinitions.map((definition) => [definition.key, definition.handler]))
 };
-var tenderly_default = { metadata: metadata97, tools: tools2, handlers: handlers3 };
+var tenderly_default = { metadata: metadata101, tools: tools2, handlers: handlers3 };
 
 // src/tools/tenderly/index.ts
 function getAllTenderlyEndpoints() {
@@ -40320,7 +40819,7 @@ var newHandlers = {
     }
   }
 };
-function currentMoralisDefinition(key, name, resource, httpMethod, httpPath, description, properties, required, handler96) {
+function currentMoralisDefinition(key, name, resource, httpMethod, httpPath, description, properties, required, handler100) {
   return {
     key,
     metadata: {
@@ -40348,7 +40847,7 @@ function currentMoralisDefinition(key, name, resource, httpMethod, httpPath, des
         openWorldHint: true
       }
     },
-    handler: handler96
+    handler: handler100
   };
 }
 var currentMoralisDefinitions = [
@@ -40577,7 +41076,7 @@ var currentMoralisTools = Object.fromEntries(
 var currentMoralisHandlers = Object.fromEntries(
   currentMoralisDefinitions.map((definition) => [definition.key, definition.handler])
 );
-var metadata98 = {
+var metadata102 = {
   ...currentMoralisMetadata,
   getTokenScoreTimeseries: getTokenScoreTimeseriesMeta,
   getTokenAnalyticsTimeseries: getTokenAnalyticsTimeseriesMeta,
@@ -40847,8 +41346,8 @@ var MORALIS_ARRAY_LIMITS = {
   getNativeBalancesBatch: { wallet_addresses: 25 },
   getNftCollectionMetadataBatch: { addresses: 25 }
 };
-function withMoralisBounds(key, tool96) {
-  const schema = tool96.inputSchema;
+function withMoralisBounds(key, tool100) {
+  const schema = tool100.inputSchema;
   const properties = Object.fromEntries(
     Object.entries(schema.properties || {}).map(
       ([name, rawProperty]) => {
@@ -40867,7 +41366,7 @@ function withMoralisBounds(key, tool96) {
     )
   );
   return {
-    ...tool96,
+    ...tool100,
     inputSchema: {
       ...schema,
       type: "object",
@@ -40877,7 +41376,7 @@ function withMoralisBounds(key, tool96) {
   };
 }
 var activeMetadata = Object.fromEntries(
-  activeMoralisKeys.map((key) => [key, metadata98[key]])
+  activeMoralisKeys.map((key) => [key, metadata102[key]])
 );
 var activeTools = Object.fromEntries(
   activeMoralisKeys.map((key) => [key, withMoralisBounds(String(key), tools3[key])])
@@ -41688,7 +42187,7 @@ Use when:
 
 Don't use when:
   - You need raw token account data only (use helius_get_token_balances \u2014 faster)
-  - You need EVM wallet data (use moralis_get_wallet_token_balances or moralis_get_wallet_net_worth)`,
+  - You need EVM wallet data (use get_wallet_balances or get_wallet_portfolio)`,
   inputSchema: {
     type: "object",
     properties: {
@@ -44184,7 +44683,7 @@ function meta(resource, path, method) {
   };
 }
 function dataPost(key, name, description, path, properties, bodyBuilder, required = [], schemaExtensions = {}) {
-  const tool96 = makeTool(
+  const tool100 = makeTool(
     name,
     description,
     properties,
@@ -44194,7 +44693,7 @@ function dataPost(key, name, description, path, properties, bodyBuilder, require
   );
   return {
     key,
-    tool: tool96,
+    tool: tool100,
     metadata: meta(key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`), path, "post"),
     handler: async (clientParam, args = {}) => {
       const client2 = resolveClient4(clientParam);
@@ -44209,7 +44708,7 @@ function dataPost(key, name, description, path, properties, bodyBuilder, require
   };
 }
 function dataGet(key, name, description, path, properties, queryBuilder, required = [], schemaExtensions = {}) {
-  const tool96 = makeTool(
+  const tool100 = makeTool(
     name,
     description,
     properties,
@@ -44219,7 +44718,7 @@ function dataGet(key, name, description, path, properties, queryBuilder, require
   );
   return {
     key,
-    tool: tool96,
+    tool: tool100,
     metadata: meta(key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`), path, "get"),
     handler: async (clientParam, args = {}) => {
       const client2 = resolveClient4(clientParam);
@@ -44234,7 +44733,7 @@ function dataGet(key, name, description, path, properties, queryBuilder, require
   };
 }
 function nftGet(key, name, description, path, properties, queryBuilder, required = [], annotations = volatileAnnotations3, schemaExtensions = {}) {
-  const tool96 = makeTool(
+  const tool100 = makeTool(
     name,
     description,
     properties,
@@ -44244,7 +44743,7 @@ function nftGet(key, name, description, path, properties, queryBuilder, required
   );
   return {
     key,
-    tool: tool96,
+    tool: tool100,
     metadata: meta(`nft.${key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)}`, path, "get"),
     handler: async (clientParam, args = {}) => {
       const client2 = resolveClient4(clientParam);
@@ -44264,7 +44763,7 @@ function nftGet(key, name, description, path, properties, queryBuilder, required
   };
 }
 function nftPost(key, name, description, path, properties, bodyBuilder, required = [], annotations = volatileAnnotations3, schemaExtensions = {}) {
-  const tool96 = makeTool(
+  const tool100 = makeTool(
     name,
     description,
     properties,
@@ -44274,7 +44773,7 @@ function nftPost(key, name, description, path, properties, bodyBuilder, required
   );
   return {
     key,
-    tool: tool96,
+    tool: tool100,
     metadata: meta(`nft.${key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)}`, path, "post"),
     handler: async (clientParam, args = {}) => {
       const client2 = resolveClient4(clientParam);
@@ -44294,7 +44793,7 @@ function nftPost(key, name, description, path, properties, bodyBuilder, required
   };
 }
 function rpcTool(key, name, description, method, properties, paramsBuilder, required = [], schemaExtensions = {}, defaultNetwork = "eth-mainnet") {
-  const tool96 = makeTool(
+  const tool100 = makeTool(
     name,
     description,
     properties,
@@ -44304,7 +44803,7 @@ function rpcTool(key, name, description, method, properties, paramsBuilder, requ
   );
   return {
     key,
-    tool: tool96,
+    tool: tool100,
     metadata: meta(`rpc.${key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)}`, "/v2/{apiKey}", "post"),
     handler: async (clientParam, args = {}) => {
       const client2 = resolveClient4(clientParam);
@@ -46078,8 +46577,8 @@ var ALCHEMY_ARRAY_LIMITS = {
   networks: 20,
   category: 10
 };
-function withAlchemyBounds(tool96) {
-  const schema = tool96.inputSchema;
+function withAlchemyBounds(tool100) {
+  const schema = tool100.inputSchema;
   const properties = Object.fromEntries(
     Object.entries(schema.properties || {}).map(
       ([name, rawProperty]) => {
@@ -46101,20 +46600,20 @@ function withAlchemyBounds(tool96) {
       }
     )
   );
-  return { ...tool96, inputSchema: { ...schema, properties } };
+  return { ...tool100, inputSchema: { ...schema, properties } };
 }
 var activeDefinitions = definitions.map((definition) => ({
   ...definition,
   tool: withAlchemyBounds(definition.tool)
 }));
-var metadata99 = Object.fromEntries(
+var metadata103 = Object.fromEntries(
   activeDefinitions.map((d) => [d.key, d.metadata])
 );
 var tools4 = Object.fromEntries(activeDefinitions.map((d) => [d.key, d.tool]));
 var handlers5 = Object.fromEntries(
   activeDefinitions.map((d) => [d.key, d.handler])
 );
-var alchemy_default = { metadata: metadata99, tools: tools4, handlers: handlers5 };
+var alchemy_default = { metadata: metadata103, tools: tools4, handlers: handlers5 };
 
 // src/tools/alchemy/index.ts
 function getAllAlchemyEndpoints() {
@@ -46134,7 +46633,7 @@ function getAllAlchemyEndpoints() {
 import axios3 from "axios";
 var HYPERLIQUID_API_URL = "https://api.hyperliquid.xyz";
 var DEFAULT_LEADERBOARD_LIMIT = 20;
-var MAX_LEADERBOARD_LIMIT = 100;
+var MAX_LEADERBOARD_LIMIT = 500;
 var FUNDING_HISTORY_PAGE_SIZE = 500;
 var DEFAULT_FUNDING_HISTORY_RETURN_POINTS = 500;
 var MAX_FUNDING_HISTORY_RETURN_POINTS = 500;
@@ -46177,7 +46676,7 @@ var HyperliquidAPI = class {
    *   Omit (or pass empty) for the main Hyperliquid DEX.
    * @param limit - top N pairs by 24h notional volume (1-100, default 20).
    */
-  async getPerpVolumeLeaderboard(dex, limit = DEFAULT_LEADERBOARD_LIMIT) {
+  async getPerpVolumeLeaderboard(dex, limit = DEFAULT_LEADERBOARD_LIMIT, offset = 0) {
     const body = { type: "metaAndAssetCtxs" };
     if (dex) body.dex = dex;
     const { data } = await this.client.post("/info", body);
@@ -46202,6 +46701,7 @@ var HyperliquidAPI = class {
       Math.max(1, Math.floor(limit || DEFAULT_LEADERBOARD_LIMIT)),
       MAX_LEADERBOARD_LIMIT
     );
+    const safeOffset = Math.max(0, Math.floor(offset || 0));
     return {
       dex: dex || "main",
       pairCount: rows.length,
@@ -46209,7 +46709,8 @@ var HyperliquidAPI = class {
         (sum, row) => sum + row.dayNotionalVolume,
         0
       ),
-      leaderboard: rows.slice(0, safeLimit)
+      offset: safeOffset,
+      leaderboard: rows.slice(safeOffset, safeOffset + safeLimit)
     };
   }
   /**
@@ -46438,6 +46939,85 @@ var HyperliquidAPI = class {
   }
 };
 
+// src/config/responseLimits.ts
+var RESPONSE_LIMITS = {
+  // Maximum tokens allowed in a response (MCP constraint)
+  MAX_RESPONSE_TOKENS: 25e3,
+  // Estimated characters per token (rough approximation)
+  CHARS_PER_TOKEN: 4,
+  // Maximum characters allowed (25000 * 4 = 100,000)
+  MAX_RESPONSE_CHARS: 1e5,
+  // Default pagination limits for different endpoints
+  DEFAULT_LIMITS: {
+    tokens: 100,
+    pools: 50,
+    trades: 100,
+    holders: 100,
+    events: 200,
+    nfts: 50
+  },
+  // Maximum allowed limits to prevent oversized responses
+  MAX_LIMITS: {
+    tokens: 100,
+    pools: 50,
+    trades: 200,
+    holders: 200,
+    events: 300,
+    nfts: 100
+  },
+  // Size thresholds for automatic truncation (in characters)
+  TRUNCATION_THRESHOLDS: {
+    warning: 8e4,
+    // Start warning at 80KB
+    truncate: 1e5
+    // Force truncation at 100KB
+  }
+};
+
+// src/utils/responseHeadroom.ts
+var MAX_RESULT_SIZE_META_KEY = "anthropic/maxResultSizeChars";
+var ANNOTATED_MAX_RESULT_SIZE_CHARS = RESPONSE_LIMITS.MAX_RESPONSE_CHARS;
+var DEFAULT_RESULT_SIZE_GUARD_CHARS = 2e4;
+var HEADROOM_TOOL_PATTERNS = [
+  // Depth-of-book: order books, l2/l3 books.
+  /orderbook|order_book|l2_book|l3_orderbook/i,
+  // Holder / owner lists.
+  /holders?(?:_|$)|owners_for/i,
+  // OHLCV, candles, charts, and history/time-series families.
+  /ohlc|candle|kline|market_chart|chart|history|timeseries/i
+];
+function toolNeedsResponseHeadroom(toolName) {
+  return HEADROOM_TOOL_PATTERNS.some((pattern) => pattern.test(toolName));
+}
+function getAnnotatedMaxResultSizeChars(tool100) {
+  const meta2 = tool100?._meta;
+  const value = meta2?.[MAX_RESULT_SIZE_META_KEY];
+  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : null;
+}
+function withResponseHeadroomMeta(tool100) {
+  if (!toolNeedsResponseHeadroom(tool100.name)) return tool100;
+  const existing = tool100._meta;
+  if (existing && existing[MAX_RESULT_SIZE_META_KEY] !== void 0) return tool100;
+  return {
+    ...tool100,
+    _meta: {
+      ...existing ?? {},
+      [MAX_RESULT_SIZE_META_KEY]: ANNOTATED_MAX_RESULT_SIZE_CHARS
+    }
+  };
+}
+function largestFittingRowCount(max, fits) {
+  if (max <= 0 || fits(max)) return Math.max(0, max);
+  let lo = 1;
+  let hi = max - 1;
+  while (lo < hi) {
+    const mid = Math.ceil((lo + hi) / 2);
+    if (fits(mid)) lo = mid;
+    else hi = mid - 1;
+  }
+  return lo;
+}
+
 // src/tools/hyperliquid/infoTools.ts
 var MAX_ARRAY_ITEMS = 500;
 var SPOT_TOKEN_TTL_MS = 10 * 60 * 1e3;
@@ -47376,14 +47956,19 @@ Hyperliquid is the dominant on-chain perpetual DEX. This reads the venue's own p
 
 Args:
   - dex (string, optional): Builder DEX name to scope the leaderboard to (e.g. "xyz" for tokenized-stock / pre-IPO perps like SPCX, MU, XYZ100). Omit for Hyperliquid's main perp DEX. Call hyperliquid_get_perp_dexs to discover builder DEX names.
-  - limit (number, optional): Number of top pairs to return, ranked by 24h notional volume (1-100, default 20).
+  - limit (number, optional): Number of top pairs to return, ranked by 24h notional volume (1-${MAX_LEADERBOARD_LIMIT}, default 20). A page also stops at the ~${DEFAULT_RESULT_SIZE_GUARD_CHARS / 1e3}k-character response budget (about 100 pairs); page on with offset=next_offset to read every pair.
+  - offset (number, optional): Rank to start from (0 = top pair, default 0).
 
 Returns:
   JSON object:
   {
     "dex": string,                       // "main" or the builder DEX name
     "pairCount": number,                 // total pairs on this DEX
-    "totalDayNotionalVolume": number,    // summed 24h notional volume (USD)
+    "totalDayNotionalVolume": number,    // summed 24h notional volume over ALL pairs (USD), not just this page
+    "offset": number,                    // rank of the first row
+    "returnedCount": number,             // rows in this response
+    "next_offset": number | null,        // pass as offset for the next page; null after the last pair
+    "pagination_note"?: string,          // present when the response budget cut the requested page short
     "leaderboard": [{
       "coin": string,                    // perp symbol (e.g. "BTC", "HYPE", "SPCX")
       "dayNotionalVolume": number,       // 24h notional volume (USD)
@@ -47414,8 +47999,13 @@ Don't use when:
             limit: {
               type: "integer",
               minimum: 1,
-              maximum: 100,
-              description: "Top N pairs by 24h notional volume (1-100, default 20)."
+              maximum: MAX_LEADERBOARD_LIMIT,
+              description: `Top N pairs by 24h notional volume (1-${MAX_LEADERBOARD_LIMIT}, default 20). One page carries about 100 pairs (response budget); returnedCount and next_offset say what shipped.`
+            },
+            offset: {
+              type: "integer",
+              minimum: 0,
+              description: "Rank to start from (0 = top pair). Pass the previous response's next_offset for the next page."
             }
           }
         },
@@ -47424,8 +48014,29 @@ Don't use when:
       handler: async (_client, args) => {
         const dex = typeof args?.dex === "string" ? args.dex : void 0;
         const limit = typeof args?.limit === "number" ? args.limit : void 0;
-        const data = await api.getPerpVolumeLeaderboard(dex, limit);
-        return asTextContentResult(data);
+        const offset = typeof args?.offset === "number" ? args.offset : 0;
+        const data = await api.getPerpVolumeLeaderboard(dex, limit, offset);
+        const requested = data.leaderboard;
+        const page = (kept) => {
+          const next = data.offset + kept;
+          return {
+            ...data,
+            returnedCount: kept,
+            next_offset: next < data.pairCount ? next : null,
+            ...kept < requested.length && {
+              pagination_note: `${kept} of the ${requested.length} requested pairs fit the response budget. Re-call with offset=${next} for the next page.`
+            },
+            leaderboard: requested.slice(0, kept)
+          };
+        };
+        return asTextContentResult(
+          page(
+            largestFittingRowCount(
+              requested.length,
+              (kept) => JSON.stringify(page(kept)).length <= DEFAULT_RESULT_SIZE_GUARD_CHARS - 500
+            )
+          )
+        );
       }
     },
     {
@@ -48599,6 +49210,7 @@ async function collectRwaRows(deps, venues = RWA_VENUE_IDS) {
 // src/tools/rwa/tools.ts
 var DEFAULT_LIMIT = 100;
 var MAX_LIMIT = 500;
+var PAGE_BUDGET_CHARS = DEFAULT_RESULT_SIZE_GUARD_CHARS - 500;
 var ASSET_CLASSES = [
   "equity",
   "pre_ipo",
@@ -48620,6 +49232,10 @@ function clampLimit2(value) {
   if (!Number.isFinite(parsed)) return DEFAULT_LIMIT;
   return Math.min(Math.max(parsed, 1), MAX_LIMIT);
 }
+function clampOffset(value) {
+  const parsed = typeof value === "number" ? Math.floor(value) : NaN;
+  return Number.isFinite(parsed) ? Math.max(parsed, 0) : 0;
+}
 function sortRows(rows) {
   return [...rows].sort((a, b) => {
     const oiA = a.open_interest_usd ?? -1;
@@ -48657,15 +49273,30 @@ function applyFilters(rows, args) {
     }
   };
 }
-function boundedEnvelope(rows, limit) {
+function boundedPayload(rows, args, render) {
   const sorted = sortRows(rows);
-  const items = sorted.slice(0, limit);
-  return {
-    count: sorted.length,
-    returnedCount: items.length,
-    truncated: items.length < sorted.length,
-    rows: items
+  const offset = clampOffset(args?.offset);
+  const requested = sorted.slice(offset, offset + clampLimit2(args?.limit));
+  const build = (kept) => {
+    const next = offset + kept;
+    const page = {
+      count: sorted.length,
+      offset,
+      returnedCount: kept,
+      truncated: next < sorted.length,
+      next_offset: next < sorted.length ? next : null,
+      ...kept < requested.length && {
+        pagination_note: `${kept} of the ${requested.length} requested rows fit the response budget. Re-call with offset=${next} for the next page.`
+      }
+    };
+    return render(page, requested.slice(0, kept));
   };
+  return build(
+    largestFittingRowCount(
+      requested.length,
+      (kept) => JSON.stringify(build(kept)).length <= PAGE_BUDGET_CHARS
+    )
+  );
 }
 var FILTER_PARAM_PROPERTIES = {
   underlying: {
@@ -48685,7 +49316,12 @@ var FILTER_PARAM_PROPERTIES = {
     type: "integer",
     minimum: 1,
     maximum: MAX_LIMIT,
-    description: `Maximum rows to return (1-${MAX_LIMIT}, default ${DEFAULT_LIMIT}). Rows are ordered by open interest (deepest first).`
+    description: `Maximum rows to return (1-${MAX_LIMIT}, default ${DEFAULT_LIMIT}). Rows are ordered by open interest (deepest first). A page also stops at the ~${DEFAULT_RESULT_SIZE_GUARD_CHARS / 1e3}k-character response budget (about 30 full rows); returnedCount is what shipped and next_offset continues.`
+  },
+  offset: {
+    type: "integer",
+    minimum: 0,
+    description: "Rows to skip in the open-interest order (default 0). Pass the previous response's next_offset to read the next page."
   }
 };
 function toMarketRow(row) {
@@ -48733,9 +49369,10 @@ Args:
   - underlying (string, optional): filter to one canonical underlying ticker.
   - asset_class (string, optional): filter to one asset class.
   - limit (integer, optional): max rows (1-${MAX_LIMIT}, default ${DEFAULT_LIMIT}), deepest open interest first.
+  - offset (integer, optional): rows to skip; pass next_offset to page.
 
 Returns:
-  Bounded JSON envelope: { "venue", "count", "returnedCount", "truncated", "rows": [normalized rows] }. ${returnsNote}
+  Bounded JSON envelope: { "venue", "count", "offset", "returnedCount", "truncated", "next_offset", "pagination_note"?, "rows": [normalized rows] }. A page holds at most what fits the response budget (about 30 rows): returnedCount is the rows shipped, next_offset is null on the last page. ${returnsNote}
 
 Use when:
 ${useWhen.map((line) => `  - ${line}`).join("\n")}
@@ -48747,7 +49384,8 @@ ${dontUseWhen.map((line) => `  - ${line}`).join("\n")}`,
         properties: {
           underlying: FILTER_PARAM_PROPERTIES.underlying,
           asset_class: FILTER_PARAM_PROPERTIES.asset_class,
-          limit: FILTER_PARAM_PROPERTIES.limit
+          limit: FILTER_PARAM_PROPERTIES.limit,
+          offset: FILTER_PARAM_PROPERTIES.offset
         }
       },
       annotations: VOLATILE_READ_ANNOTATIONS
@@ -48756,13 +49394,15 @@ ${dontUseWhen.map((line) => `  - ${line}`).join("\n")}`,
       const { rows, note } = await fetchRwaVenueRows(venueId, deps);
       stampPriceSuspect(rows);
       const { filtered, filters } = applyFilters(rows, args);
-      const envelope = boundedEnvelope(filtered, clampLimit2(args?.limit));
-      return asTextContentResult({
-        venue: venueId,
-        ...note ? { note } : {},
-        filters,
-        ...envelope
-      });
+      return asTextContentResult(
+        boundedPayload(filtered, args, (page, pageRows) => ({
+          venue: venueId,
+          ...note ? { note } : {},
+          filters,
+          ...page,
+          rows: pageRows
+        }))
+      );
     }
   };
 }
@@ -48798,6 +49438,7 @@ Args:
   - venue (string, optional): filter to one venue ("ostium", "avantis", "lighter", "extended", "hyperliquid", or "hyperliquid:xyz").
   - asset_class (string, optional): filter to one asset class (equity, pre_ipo, etf, index, commodity, fx, crypto).
   - limit (integer, optional): max rows (1-${MAX_LIMIT}, default ${DEFAULT_LIMIT}), deepest open interest first.
+  - offset (integer, optional): rows to skip; pass next_offset to page.
 
 Returns:
   JSON object:
@@ -48805,9 +49446,11 @@ Returns:
     "filters": { "underlying", "venue", "asset_class" },
     "venueCount": number, "okCount": number,
     "venues": [{ "venue", "runtime_status", "rowCount", "error"? }],
-    "count": number, "returnedCount": number, "truncated": boolean,
+    "count": number, "offset": number, "returnedCount": number, "truncated": boolean,
+    "next_offset": number | null, "pagination_note"?: string,
     "rows": [normalized funding rows]
   }
+  A page holds at most what fits the response budget (about 30 rows): returnedCount is the rows shipped; re-call with offset=next_offset for more.
 
 Use when:
   - "TSLA perp funding across venues" / tokenized-stock or equity perp funding questions
@@ -48827,17 +49470,19 @@ Don't use when:
       handler: async (_client, args) => {
         const { results, rows } = await collectRwaRows(deps);
         const { filtered, filters } = applyFilters(rows, args);
-        const envelope = boundedEnvelope(filtered, clampLimit2(args?.limit));
         const okCount = results.filter(
           (result2) => result2.runtime_status === "ok"
         ).length;
-        return asTextContentResult({
-          filters,
-          venueCount: results.length,
-          okCount,
-          venues: results,
-          ...envelope
-        });
+        return asTextContentResult(
+          boundedPayload(filtered, args, (page, pageRows) => ({
+            filters,
+            venueCount: results.length,
+            okCount,
+            venues: results,
+            ...page,
+            rows: pageRows
+          }))
+        );
       }
     },
     {
@@ -48864,6 +49509,7 @@ Args:
   - venue (string, optional): filter to one venue.
   - asset_class (string, optional): filter to one asset class (equity, pre_ipo, etf, index, commodity, fx, crypto).
   - limit (integer, optional): max rows (1-${MAX_LIMIT}, default ${DEFAULT_LIMIT}), deepest open interest first.
+  - offset (integer, optional): rows to skip; pass next_offset to page.
 
 Returns:
   JSON object:
@@ -48871,7 +49517,7 @@ Returns:
     "filters": {...},
     "venueCount": number, "okCount": number,
     "venues": [{ "venue", "runtime_status", "rowCount", "error"? }],
-    "count", "returnedCount", "truncated",
+    "count", "offset", "returnedCount", "truncated", "next_offset", "pagination_note"?,
     "rows": [{ "venue", "market", "symbol", "underlying", "asset_class", "funding_mechanism", "is_delisted", "mark_price", "oracle_price", "open_interest_usd", "volume_24h_usd", "is_price_suspect", "price_suspect_basis", "price_deviation_pct", "meta" }]
   }
 
@@ -48892,20 +49538,19 @@ Don't use when:
       handler: async (_client, args) => {
         const { results, rows } = await collectRwaRows(deps);
         const { filtered, filters } = applyFilters(rows, args);
-        const envelope = boundedEnvelope(filtered, clampLimit2(args?.limit));
         const okCount = results.filter(
           (result2) => result2.runtime_status === "ok"
         ).length;
-        return asTextContentResult({
-          filters,
-          venueCount: results.length,
-          okCount,
-          venues: results,
-          count: envelope.count,
-          returnedCount: envelope.returnedCount,
-          truncated: envelope.truncated,
-          rows: envelope.rows.map(toMarketRow)
-        });
+        return asTextContentResult(
+          boundedPayload(filtered, args, (page, pageRows) => ({
+            filters,
+            venueCount: results.length,
+            okCount,
+            venues: results,
+            ...page,
+            rows: pageRows.map(toMarketRow)
+          }))
+        );
       }
     },
     // -----------------------------------------------------------------
@@ -49285,13 +49930,13 @@ function historyInputSchema(baseCoinDescription) {
     required: ["base_coin"]
   };
 }
-function errorResult2(tool96, error) {
+function errorResult2(tool100, error) {
   if (error instanceof ArchiveInputError) {
     return asTextContentResult(
       {
         error: error.message,
         runtime_status: "invalid_input",
-        tool: tool96
+        tool: tool100
       },
       true
     );
@@ -49301,17 +49946,17 @@ function errorResult2(tool96, error) {
     {
       error: message,
       runtime_status: classifyRuntimeStatusFromError(message),
-      tool: tool96
+      tool: tool100
     },
     true
   );
 }
-function missingCredentialsResult(tool96) {
+function missingCredentialsResult(tool100) {
   return asTextContentResult(
     {
       error: ARCHIVE_MISSING_CREDENTIALS_MESSAGE,
       runtime_status: "missing_key",
-      tool: tool96
+      tool: tool100
     },
     true
   );
@@ -49685,74 +50330,6 @@ async function fetchPolymarketJson(url, label, timeoutMs = POLYMARKET_TIMEOUT_MS
   }
 }
 
-// src/config/responseLimits.ts
-var RESPONSE_LIMITS = {
-  // Maximum tokens allowed in a response (MCP constraint)
-  MAX_RESPONSE_TOKENS: 25e3,
-  // Estimated characters per token (rough approximation)
-  CHARS_PER_TOKEN: 4,
-  // Maximum characters allowed (25000 * 4 = 100,000)
-  MAX_RESPONSE_CHARS: 1e5,
-  // Default pagination limits for different endpoints
-  DEFAULT_LIMITS: {
-    tokens: 100,
-    pools: 50,
-    trades: 100,
-    holders: 100,
-    events: 200,
-    nfts: 50
-  },
-  // Maximum allowed limits to prevent oversized responses
-  MAX_LIMITS: {
-    tokens: 100,
-    pools: 50,
-    trades: 200,
-    holders: 200,
-    events: 300,
-    nfts: 100
-  },
-  // Size thresholds for automatic truncation (in characters)
-  TRUNCATION_THRESHOLDS: {
-    warning: 8e4,
-    // Start warning at 80KB
-    truncate: 1e5
-    // Force truncation at 100KB
-  }
-};
-
-// src/utils/responseHeadroom.ts
-var MAX_RESULT_SIZE_META_KEY = "anthropic/maxResultSizeChars";
-var ANNOTATED_MAX_RESULT_SIZE_CHARS = RESPONSE_LIMITS.MAX_RESPONSE_CHARS;
-var DEFAULT_RESULT_SIZE_GUARD_CHARS = 2e4;
-var HEADROOM_TOOL_PATTERNS = [
-  // Depth-of-book: order books, l2/l3 books.
-  /orderbook|order_book|l2_book|l3_orderbook/i,
-  // Holder / owner lists.
-  /holders?(?:_|$)|owners_for/i,
-  // OHLCV, candles, charts, and history/time-series families.
-  /ohlc|candle|kline|market_chart|chart|history|timeseries/i
-];
-function toolNeedsResponseHeadroom(toolName) {
-  return HEADROOM_TOOL_PATTERNS.some((pattern) => pattern.test(toolName));
-}
-function getAnnotatedMaxResultSizeChars(tool96) {
-  const meta2 = tool96?._meta;
-  const value = meta2?.[MAX_RESULT_SIZE_META_KEY];
-  return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : null;
-}
-function withResponseHeadroomMeta(tool96) {
-  if (!toolNeedsResponseHeadroom(tool96.name)) return tool96;
-  const existing = tool96._meta;
-  if (existing && existing[MAX_RESULT_SIZE_META_KEY] !== void 0) return tool96;
-  return {
-    ...tool96,
-    _meta: {
-      ...existing ?? {},
-      [MAX_RESULT_SIZE_META_KEY]: ANNOTATED_MAX_RESULT_SIZE_CHARS
-    }
-  };
-}
-
 // src/tools/polymarket/api.ts
 var DEFAULT_LIMIT3 = 10;
 var MAX_LIMIT3 = 50;
@@ -49760,9 +50337,14 @@ var MAX_OFFSET = 1e4;
 var DEFAULT_BOOK_DEPTH = 10;
 var MAX_BOOK_DEPTH = 50;
 var MAX_HISTORY_POINTS = 500;
-var SEARCH_SCAN_LIMIT = 100;
+var SEARCH_EVENT_LIMIT = 20;
 var EVENT_MARKETS_PREVIEW = 10;
-var EVENT_RESPONSE_BUDGET_CHARS = DEFAULT_RESULT_SIZE_GUARD_CHARS;
+var EVENT_RESPONSE_BUDGET_CHARS = (
+  // Rows only: the okResult envelope (odds note, source URL twice, filters)
+  // adds ~1k, and at the full 20k the guard still trimmed 48 rows to 45
+  // (order=volume, limit=50, 2026-10-09).
+  DEFAULT_RESULT_SIZE_GUARD_CHARS - 2e3
+);
 var DESCRIPTION_MAX_CHARS = 1200;
 var PRICE_INTERVALS = ["1d", "1w", "1m", "max"];
 var DEFAULT_FIDELITY_MINUTES = {
@@ -49962,6 +50544,21 @@ function parseInterval(value) {
   }
   return interval;
 }
+var EVENT_ORDERS = [
+  "volume24hr",
+  "volume",
+  "liquidity",
+  "endDate"
+];
+function eventOrderParams(value, now = /* @__PURE__ */ new Date()) {
+  const order = value === void 0 || value === null ? "volume24hr" : value;
+  if (typeof order !== "string" || !EVENT_ORDERS.includes(order)) {
+    invalid(
+      `order must be one of ${EVENT_ORDERS.map((o) => `"${o}"`).join(", ")}; got ${JSON.stringify(value)}.`
+    );
+  }
+  return order === "endDate" ? { order, ascending: true, end_date_min: now.toISOString() } : { order, ascending: false };
+}
 function parseFidelity(value, interval) {
   return parseBoundedInteger(
     value,
@@ -50290,6 +50887,22 @@ async function fetchGammaEvents(params) {
   const data = await fetchPolymarketJson(url, "Gamma /events");
   return { url, rows: asRecordArray(data, "Gamma /events") };
 }
+async function searchGammaMarkets(query, closed) {
+  const url = buildUrl(GAMMA_BASE_URL, "/public-search", {
+    q: query,
+    limit_per_type: SEARCH_EVENT_LIMIT,
+    events_status: closed ? "closed" : "active"
+  });
+  const data = asRecord(await fetchPolymarketJson(url, "Gamma /public-search"));
+  const events = asRecordArray(data?.events ?? [], "Gamma /public-search");
+  const rows = events.flatMap(
+    (event) => (Array.isArray(event.markets) ? event.markets : []).map(asRecord).filter((market) => market !== null).map((market) => ({
+      ...market,
+      events: [{ slug: event.slug, title: event.title }]
+    }))
+  );
+  return { url, rows, eventCount: events.length };
+}
 async function resolveMarket(selector) {
   if (selector.slug) {
     const { url, rows } = await fetchGammaMarkets({ slug: selector.slug });
@@ -50410,13 +51023,13 @@ function okResult(sourceUrl, body) {
     may_have_more
   });
 }
-function errorResult3(tool96, error) {
+function errorResult3(tool100, error) {
   if (error instanceof PolymarketInputError) {
     return asTextContentResult(
       {
         error: error.message,
         runtime_status: "invalid_input",
-        tool: tool96
+        tool: tool100
       },
       true
     );
@@ -50426,7 +51039,7 @@ function errorResult3(tool96, error) {
     {
       error: message,
       runtime_status: classifyRuntimeStatusFromError(message),
-      tool: tool96
+      tool: tool100
     },
     true
   );
@@ -50466,7 +51079,7 @@ function getAllPolymarketEndpoints() {
       },
       tool: {
         name: "polymarket_search_markets",
-        description: `Search Polymarket prediction markets by free text and list their market-implied odds, liquidity, volume, CLOB token ids, and end dates (Gamma API, keyless). With a query the tool scans the top ${SEARCH_SCAN_LIMIT} markets by 24h volume (honoring the active/closed filters) and keeps rows where every query term appears in the question, slug, bracket title, or event title. Without a query it returns the top markets by 24h volume.
+        description: `Search Polymarket prediction markets by free text and list their market-implied odds, liquidity, volume, CLOB token ids, and end dates (Gamma API, keyless). With a query the tool runs Polymarket's own search across every event (up to ${SEARCH_EVENT_LIMIT} events, honoring the active/closed filters), keeps markets where every query term appears in the question, slug, bracket title, or event title, and orders them by 24h volume; when no market contains every term it returns Polymarket's relevance order instead and says so in scan.order. Without a query it returns the top markets by 24h volume.
 
 Args:
   - query (string, optional): free-text terms, all must match (case-insensitive), e.g. "fed rate" or "bitcoin 2026".
@@ -50477,7 +51090,7 @@ Args:
 Returns:
   ${ENVELOPE_DOC}
   "filters", "scan" { "scanned", "scan_limit", "matched", "order" }, and "rows": [{ "id", "slug", "question", "groupItemTitle", "conditionId", "eventSlug", "eventTitle", "outcomes", "outcomePrices" (0-1 per outcome, same order as outcomes), "clobTokenIds" (same order; pass to polymarket_get_orderbook / polymarket_get_price_history), "liquidity", "volume", "volume24hr", "endDate", "active", "closed" }].
-  may_have_more is true when more rows matched than were returned or the scan window was full; narrow the query or use polymarket_get_events with a tag.
+  scan.scan_limit is the event cap for a query and the row limit without one. may_have_more is true when more rows matched than were returned or the search page was full; narrow the query or use polymarket_get_events with a tag.
 
 Examples:
   - { "query": "fed decision", "limit": 5 } \u2014 Fed-rate brackets with current odds.
@@ -50514,16 +51127,20 @@ Don't use when:
           const limit = parseLimit(args?.limit);
           const active = parseOptionalBoolean(args?.active, "active", true);
           const closed = parseOptionalBoolean(args?.closed, "closed", false);
-          const scanLimit = query ? SEARCH_SCAN_LIMIT : limit;
-          const { url, rows } = await fetchGammaMarkets({
-            limit: scanLimit,
+          const scanLimit = query ? SEARCH_EVENT_LIMIT : limit;
+          const search = query ? await searchGammaMarkets(query, closed) : null;
+          const listing = search ?? await fetchGammaMarkets({
+            limit,
             active,
             closed,
             order: "volume24hr",
             ascending: false
           });
-          const mapped = rows.map(toMarketRow2);
-          const matched = query ? mapped.filter(
+          const { url, rows } = listing;
+          const mapped = rows.map(toMarketRow2).filter(
+            (row) => !query || row.active === active && row.closed === closed
+          );
+          const exact = query ? mapped.filter(
             (row) => matchesQuery(
               [
                 row.question,
@@ -50534,19 +51151,22 @@ Don't use when:
               ],
               query
             )
-          ) : mapped;
+          ).sort((a, b) => (b.volume24hr ?? 0) - (a.volume24hr ?? 0)) : mapped;
+          const fuzzy = Boolean(query) && exact.length === 0;
+          const matched = fuzzy ? mapped : exact;
+          const scanned = search ? search.eventCount : rows.length;
           const items = matched.slice(0, limit);
           return okResult(url, {
             filters: { query, active, closed, limit },
             scan: {
-              scanned: rows.length,
+              scanned,
               scan_limit: scanLimit,
               matched: matched.length,
-              order: "volume24hr desc"
+              order: fuzzy ? "relevance (no market contains every term)" : "volume24hr desc"
             },
             rows: items,
             returnedCount: items.length,
-            may_have_more: matched.length > limit || rows.length >= scanLimit
+            may_have_more: matched.length > limit || scanned >= scanLimit
           });
         } catch (error) {
           return errorResult3(toolName, error);
@@ -50568,14 +51188,16 @@ Args:
   - slug (string, optional): one event's URL slug (exact); other filters are ignored.
   - active (boolean, optional): Polymarket active flag filter (default true).
   - closed (boolean, optional): Polymarket closed flag filter (default false).
+  - order (string, optional): "volume24hr" (default, trending: most traded in the last 24h), "volume" (biggest by lifetime volume), "liquidity" (deepest books), or "endDate" (closing soonest, from now on). Biggest first for the volume and liquidity sorts.
 ${PAGING_ARGS_DOC}
 
 Returns:
   ${ENVELOPE_DOC}
-  "filters", "markets_preview_limit" (nested previews actually kept per event, ${EVENT_MARKETS_PREVIEW} unless the size budget forced fewer), "rows_dropped_for_size" (0 unless headline data alone overran the budget), and "rows": [{ "id", "slug", "title", "active", "closed", "endDate", "liquidity", "volume", "volume24hr", "negRisk", "tags", "marketCount", "markets": [{ "slug", "question", "groupItemTitle", "conditionId", "outcomes", "outcomePrices", "clobTokenIds", "volume24hr" }], "marketsTruncated" }]. Rows are ordered by 24h volume (desc). returnedCount is always the number of rows actually in the response. Large limits are slow because Gamma nests every market of every event.
+  "filters" (including the order applied), "markets_preview_limit" (nested previews actually kept per event, ${EVENT_MARKETS_PREVIEW} unless the size budget forced fewer), "rows_dropped_for_size" (0 unless headline data alone overran the budget), and "rows": [{ "id", "slug", "title", "active", "closed", "endDate", "liquidity", "volume", "volume24hr", "negRisk", "tags", "marketCount", "markets": [{ "slug", "question", "groupItemTitle", "conditionId", "outcomes", "outcomePrices", "clobTokenIds", "volume24hr" }], "marketsTruncated" }]. Rows follow the requested order (24h volume, desc, by default). returnedCount is always the number of rows actually in the response. Large limits are slow because Gamma nests every market of every event.
 
 Examples:
   - { "tag": "crypto", "limit": 5 } \u2014 the busiest crypto events.
+  - { "order": "volume", "limit": 5 } \u2014 the biggest events by all-time volume (not just today's trend).
   - { "slug": "presidential-election-winner-2028" } \u2014 one event with its top-${EVENT_MARKETS_PREVIEW} candidates by odds.
   - { "limit": 10, "offset": 10 } \u2014 the next page of the most active events.
 
@@ -50600,6 +51222,11 @@ Don't use when:
             },
             active: ACTIVE_SCHEMA,
             closed: CLOSED_SCHEMA,
+            order: {
+              type: "string",
+              enum: [...EVENT_ORDERS],
+              description: 'Sort: "volume24hr" (default, trending), "volume" (biggest all-time), "liquidity", or "endDate" (closing soonest from now).'
+            },
             limit: LIMIT_SCHEMA,
             offset: OFFSET_SCHEMA
           }
@@ -50615,19 +51242,19 @@ Don't use when:
           const offset = parseOffset(args?.offset);
           const active = parseOptionalBoolean(args?.active, "active", true);
           const closed = parseOptionalBoolean(args?.closed, "closed", false);
+          const sort = eventOrderParams(args?.order);
           const { url, rows } = slug ? await fetchGammaEvents({ slug }) : await fetchGammaEvents({
             limit,
             offset,
             active,
             closed,
             tag_slug: tag ?? void 0,
-            order: "volume24hr",
-            ascending: false
+            ...sort
           });
           const bounded = boundEventRows(rows);
           const items = bounded.rows;
           return okResult(url, {
-            filters: slug ? { slug } : { tag, active, closed, limit, offset },
+            filters: slug ? { slug } : { tag, active, closed, order: sort.order, limit, offset },
             markets_preview_limit: bounded.marketsPreviewLimit,
             rows_dropped_for_size: bounded.rowsDropped,
             rows: items,
@@ -51039,7 +51666,7 @@ function isAbortError(error) {
   const name = error?.name;
   return name === "AbortError" || name === "TimeoutError";
 }
-async function fetchJsonWithTimeout(url, label, timeoutMs = SIGNALS_FETCH_TIMEOUT_MS) {
+async function fetchJsonWithTimeout(url, label, timeoutMs = SIGNALS_FETCH_TIMEOUT_MS, headers = {}) {
   const controller = new AbortController();
   const timer = setTimeout(() => controller.abort(), timeoutMs);
   try {
@@ -51049,7 +51676,8 @@ async function fetchJsonWithTimeout(url, label, timeoutMs = SIGNALS_FETCH_TIMEOU
         signal: controller.signal,
         headers: {
           Accept: "application/json",
-          "User-Agent": "hive-mcp-server/1.0.0"
+          "User-Agent": "hive-mcp-server/1.0.0",
+          ...headers
         }
       });
     } catch (error) {
@@ -51910,10 +52538,10 @@ async function fetchHackRows() {
 }
 
 // src/tools/signals/tools.ts
-function errorResult4(tool96, error, extra = {}) {
+function errorResult4(tool100, error, extra = {}) {
   if (error instanceof SignalsInputError) {
     return asTextContentResult(
-      { error: error.message, runtime_status: "invalid_input", tool: tool96, ...extra },
+      { error: error.message, runtime_status: "invalid_input", tool: tool100, ...extra },
       true
     );
   }
@@ -51922,7 +52550,7 @@ function errorResult4(tool96, error, extra = {}) {
     {
       error: message,
       runtime_status: classifyRuntimeStatusFromError(message),
-      tool: tool96,
+      tool: tool100,
       ...extra
     },
     true
@@ -52294,6 +52922,334 @@ Don't use when:
   ];
 }
 
+// src/tools/blockscout/tools.ts
+import Coingecko2 from "@coingecko/coingecko-typescript";
+var BLOCKSCOUT_PROVIDER = "Blockscout";
+var HOLDERS_PAGE_SIZE = 50;
+var DEFAULT_MAX_PAGES = 20;
+var MAX_PAGES = 40;
+var TIME_BUDGET_MS = 2e4;
+var CHAINS = {
+  eth: { chainId: 1, host: "eth.blockscout.com", gecko: "eth" },
+  base: { chainId: 8453, host: "base.blockscout.com", gecko: "base" },
+  optimism: { chainId: 10, host: "explorer.optimism.io", gecko: "optimism" },
+  arbitrum: {
+    chainId: 42161,
+    host: "arbitrum.blockscout.com",
+    gecko: "arbitrum"
+  },
+  polygon: {
+    chainId: 137,
+    host: "polygon.blockscout.com",
+    gecko: "polygon_pos"
+  }
+};
+var CHAIN_ALIASES = {
+  ethereum: "eth",
+  mainnet: "eth",
+  "1": "eth",
+  "8453": "base",
+  op: "optimism",
+  "10": "optimism",
+  arb: "arbitrum",
+  "42161": "arbitrum",
+  matic: "polygon",
+  polygon_pos: "polygon",
+  "137": "polygon"
+};
+var USD_TIERS = [
+  { label: ">$10k", min_usd: 1e4, max_usd: null },
+  { label: "$1k-$10k", min_usd: 1e3, max_usd: 1e4 },
+  { label: "$100-$1k", min_usd: 100, max_usd: 1e3 },
+  { label: "$1-$100", min_usd: 1, max_usd: 100 },
+  { label: "<$1", min_usd: 0, max_usd: 1 }
+];
+function tallyTiers(rows, totalHolders, stop) {
+  const reachedBottom = stop === "end_of_holders";
+  const smallest = rows.length > 0 ? rows[rows.length - 1].usd : null;
+  const tiers = USD_TIERS.map((tier) => {
+    const members = rows.filter(
+      (row) => row.usd >= tier.min_usd && (tier.max_usd === null || row.usd < tier.max_usd)
+    );
+    const exact = reachedBottom || smallest !== null && smallest < tier.min_usd;
+    const reached = smallest !== null && smallest < (tier.max_usd ?? Infinity);
+    return {
+      ...tier,
+      count: exact || reached ? members.length : null,
+      contracts: exact || reached ? members.filter((r) => r.is_contract).length : null,
+      exact,
+      lower_bound: !exact && reached
+    };
+  });
+  const dust = tiers[tiers.length - 1];
+  if (!dust.exact && stop === "below_smallest_tier" && totalHolders !== null) {
+    const above = rows.filter((row) => row.usd >= 1).length;
+    dust.count = Math.max(totalHolders - above, 0);
+    dust.contracts = null;
+    dust.exact = true;
+    dust.lower_bound = false;
+  }
+  const real = tiers.filter((tier) => tier.min_usd >= 100);
+  return {
+    tiers,
+    holders_100_usd_plus: {
+      count: real.reduce((sum, tier) => sum + (tier.count ?? 0), 0),
+      exact: real.every((tier) => tier.exact)
+    },
+    exhaustive: tiers.every((tier) => tier.exact),
+    smallest_scanned_usd: smallest
+  };
+}
+function parseArgs(args) {
+  const rawNetwork = String(args?.network ?? args?.chain ?? "").trim().toLowerCase();
+  const key = CHAIN_ALIASES[rawNetwork] ?? rawNetwork;
+  const chain = CHAINS[key];
+  if (!chain) {
+    throw new SignalsInputError(
+      `network must be one of ${Object.keys(CHAINS).join(", ")} (or a chain id); got ${JSON.stringify(args?.network ?? null)}.`
+    );
+  }
+  const address = String(args?.address ?? "").trim();
+  if (!/^0x[0-9a-fA-F]{40}$/.test(address)) {
+    throw new SignalsInputError(
+      `address must be a 0x token contract address; got ${JSON.stringify(args?.address ?? null)}.`
+    );
+  }
+  const priceOverride = args?.price_usd === void 0 || args?.price_usd === null ? null : parseNumberArg(args.price_usd, "price_usd", Number.MIN_VALUE, 1e12, 0);
+  return {
+    network: key,
+    chain,
+    address,
+    maxPages: parseIntegerArg(
+      args?.max_pages,
+      "max_pages",
+      1,
+      MAX_PAGES,
+      DEFAULT_MAX_PAGES
+    ),
+    priceOverride
+  };
+}
+function blockscoutGet(chain, path) {
+  const apiKey = getEnvVar("BLOCKSCOUT_API_KEY");
+  const url = apiKey ? `https://api.blockscout.com/${chain.chainId}/api/v2${path}` : `https://${chain.host}/api/v2${path}`;
+  return fetchJsonWithTimeout(
+    url,
+    `Blockscout (${chain.chainId})`,
+    void 0,
+    apiKey ? { Authorization: `Bearer ${apiKey}` } : {}
+  ).catch((error) => {
+    if (error instanceof SignalsHttpError && error.status === 404) {
+      throw new SignalsInputError(
+        `Blockscout has no token at this address on chain ${chain.chainId}.`
+      );
+    }
+    if (!apiKey && error instanceof SignalsHttpError && (error.status === 403 || error.status === 402)) {
+      throw new Error(
+        `Blockscout's public explorer for chain ${chain.chainId} refused the request (HTTP ${error.status}, bot protection). Set BLOCKSCOUT_API_KEY (free API key at dev.blockscout.com) to use the Blockscout PRO API.`
+      );
+    }
+    throw error;
+  });
+}
+var ownCoinGecko = null;
+async function resolvePrice(chain, address, token) {
+  const blockscoutRate = parseFiniteNumber3(token.exchange_rate);
+  if (blockscoutRate !== null && blockscoutRate > 0) {
+    return { price: blockscoutRate, source: "blockscout_exchange_rate" };
+  }
+  try {
+    if (!ownCoinGecko)
+      ownCoinGecko = new Coingecko2(getCoinGeckoClientOptions());
+    const result2 = await ownCoinGecko.onchain.simple.networks.tokenPrice.getAddresses(
+      address,
+      { network: chain.gecko }
+    );
+    const prices = result2?.data?.attributes?.token_prices ?? {};
+    const price = parseFiniteNumber3(
+      prices[address.toLowerCase()] ?? prices[address]
+    );
+    if (price !== null && price > 0) {
+      return { price, source: "coingecko_onchain_price" };
+    }
+  } catch {
+  }
+  return { price: null, source: null };
+}
+async function getTokenHolderDistribution(args, now = Date.now) {
+  const { network, chain, address, maxPages, priceOverride } = parseArgs(args);
+  const started = now();
+  const token = await blockscoutGet(chain, `/tokens/${address}`) ?? {};
+  if (token.type !== void 0 && token.type !== "ERC-20") {
+    throw new SignalsInputError(
+      `this address is a ${String(token.type)} token; holder tiers are computed for ERC-20 tokens only.`
+    );
+  }
+  const decimals = parseFiniteNumber3(token.decimals);
+  if (decimals === null) {
+    throw new Error("Blockscout returned no decimals for this token");
+  }
+  const totalHolders = parseFiniteNumber3(token.holders_count ?? token.holders);
+  const { price, source: priceSource } = priceOverride !== null ? { price: priceOverride, source: "caller" } : await resolvePrice(chain, address, token);
+  const base = {
+    provider: BLOCKSCOUT_PROVIDER,
+    network,
+    chain_id: chain.chainId,
+    address,
+    token: {
+      name: token.name ?? null,
+      symbol: token.symbol ?? null,
+      decimals,
+      total_supply: token.total_supply ?? null
+    },
+    total_holders: totalHolders,
+    price_usd: price,
+    price_source: priceSource
+  };
+  if (price === null) {
+    return {
+      ...base,
+      runtime_status: "degraded",
+      fetched_at: (/* @__PURE__ */ new Date()).toISOString(),
+      tiers: null,
+      note: "No USD price was found for this token, so holders could not be tiered by value. total_holders counts every address with a positive balance, dust included. Pass price_usd to tier anyway."
+    };
+  }
+  const rows = [];
+  let pages = 0;
+  let cursor = "";
+  let stop = "end_of_holders";
+  for (; ; ) {
+    if (pages >= maxPages) {
+      stop = "max_pages";
+      break;
+    }
+    if (now() - started > TIME_BUDGET_MS) {
+      stop = "time_budget";
+      break;
+    }
+    const page = await blockscoutGet(
+      chain,
+      `/tokens/${address}/holders${cursor}`
+    ) ?? {};
+    pages += 1;
+    const items = Array.isArray(page.items) ? page.items : [];
+    let belowFloor = false;
+    for (const item of items) {
+      const holder = item ?? {};
+      const units = parseFiniteNumber3(holder.value);
+      if (units === null) continue;
+      const usd2 = units / 10 ** decimals * price;
+      rows.push({ usd: usd2, is_contract: holder.address?.is_contract === true });
+      if (usd2 < 1) {
+        belowFloor = true;
+        break;
+      }
+    }
+    if (belowFloor) {
+      stop = "below_smallest_tier";
+      break;
+    }
+    const next = page.next_page_params;
+    if (!next || typeof next !== "object" || items.length === 0) break;
+    cursor = `?${new URLSearchParams(
+      Object.entries(next).map(([k, v]) => [
+        k,
+        String(v)
+      ])
+    ).toString()}`;
+  }
+  const tally = tallyTiers(rows, totalHolders, stop);
+  return {
+    ...base,
+    runtime_status: "ok",
+    fetched_at: (/* @__PURE__ */ new Date()).toISOString(),
+    holders_scanned: rows.length,
+    pages_fetched: pages,
+    stopped_reason: stop,
+    ...tally,
+    lower_bound: !tally.exhaustive,
+    note: (tally.exhaustive ? "Every tier is exact." : `The walk stopped (${stop}) at a holder worth $${tally.smallest_scanned_usd?.toFixed(2)}; tiers marked exact are complete, lower_bound tiers are at least the count shown, and null tiers were not reached. Raise max_pages (up to ${MAX_PAGES}) to go deeper.`) + " Counts include contracts (pools, vesting, treasuries); each tier's contracts field says how many. USD values use price_usd at fetch time."
+  };
+}
+function getAllBlockscoutEndpoints() {
+  return [
+    {
+      metadata: {
+        resource: "blockscout.tokens.holders",
+        operation: "read",
+        tags: ["blockscout", "tokens", "holders", "distribution", "onchain"]
+      },
+      tool: {
+        name: "get_token_holder_distribution",
+        description: `Count a token's holders by USD balance: total holders plus how many hold >$10k, $1k-$10k, $100-$1k, $1-$100, and under $1 (dust), from Blockscout's holder list. Answers "how many real (non-dust) holders does this token have?". Keyless on EVM chains: ${Object.keys(CHAINS).join(", ")}.
+
+Args:
+  - network (string, required): ${Object.keys(CHAINS).join(", ")}, or a chain id (1, 8453, 10, 42161, 137).
+  - address (string, required): ERC-20 token contract address.
+  - max_pages (integer, optional): holder pages of ${HOLDERS_PAGE_SIZE} to walk, 1-${MAX_PAGES} (default ${DEFAULT_MAX_PAGES}). The walk also stops after ${TIME_BUDGET_MS / 1e3} s, at the end of the list, or at the first holder under $1.
+  - price_usd (number, optional): USD price to tier with. Default: Blockscout's exchange rate, then the GeckoTerminal on-chain price.
+
+Returns:
+  { "provider": "Blockscout", "runtime_status", "fetched_at", "network", "chain_id", "address", "token": { "name", "symbol", "decimals", "total_supply" }, "total_holders", "price_usd", "price_source", "holders_scanned", "pages_fetched", "stopped_reason", "tiers": [{ "label", "min_usd", "max_usd", "count", "contracts", "exact", "lower_bound" }], "holders_100_usd_plus": { "count", "exact" }, "exhaustive", "lower_bound", "smallest_scanned_usd", "note" }. A tier with exact=false and lower_bound=true holds at least count holders; count null means the walk never reached it.
+
+Examples:
+  - { "network": "base", "address": "0x91dA780BC7f4B7Cf19ABE90411a2a296Ec5FF787" }
+  - { "network": "eth", "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "max_pages": 5 }
+
+Use when:
+  - You need holder counts above a USD size, or how much of the holder count is dust.
+Don't use when:
+  - You need the largest holders and their share of supply (use get_token_top_holders).`,
+        inputSchema: {
+          type: "object",
+          properties: {
+            network: {
+              type: "string",
+              description: `Chain: ${Object.keys(CHAINS).join(", ")}, or a chain id.`
+            },
+            address: {
+              type: "string",
+              description: "ERC-20 token contract address (0x...)."
+            },
+            max_pages: {
+              type: "integer",
+              minimum: 1,
+              maximum: MAX_PAGES,
+              default: DEFAULT_MAX_PAGES,
+              description: `Holder pages of ${HOLDERS_PAGE_SIZE} to walk (1-${MAX_PAGES}).`
+            },
+            price_usd: {
+              type: "number",
+              exclusiveMinimum: 0,
+              description: "USD price to tier with; default Blockscout's rate, then GeckoTerminal."
+            }
+          },
+          required: ["network", "address"],
+          additionalProperties: false
+        },
+        annotations: VOLATILE_READ_ANNOTATIONS
+      },
+      handler: async (_client, args) => {
+        try {
+          return asTextContentResult(await getTokenHolderDistribution(args));
+        } catch (error) {
+          const message = error instanceof Error ? error.message : String(error);
+          return asTextContentResult(
+            {
+              error: message,
+              runtime_status: error instanceof SignalsInputError ? "invalid_input" : classifyRuntimeStatusFromError(message),
+              tool: "get_token_holder_distribution",
+              provider: BLOCKSCOUT_PROVIDER
+            },
+            true
+          );
+        }
+      }
+    }
+  ];
+}
+
 // src/freeWriteEndpoints.ts
 var FREE_WRITE_ENDPOINTS = /* @__PURE__ */ new Set([
   // Feedback is a bounded, rate-limited insert into Hive's own table. It
@@ -52863,7 +53819,7 @@ Don't use when:
 }
 
 // src/wrapper/index.ts
-import Coingecko2 from "@coingecko/coingecko-typescript";
+import Coingecko3 from "@coingecko/coingecko-typescript";
 
 // src/utils/descriptionGenerator.ts
 function needsEnrichment(description) {
@@ -53538,7 +54494,7 @@ var SCHEMA_PATTERNS = [
     TOKEN_DILIGENCE_OUTPUT_SCHEMA
   ],
   [
-    /^(alchemy_get_tokens_by_wallet|alchemy_get_token_balances_by_wallet|alchemy_get_native_balance|alchemy_get_asset_transfers|moralis_get_wallet_history|moralis_get_wallet_profitability|moralis_get_wallet_profitability_summary|moralis_get_wallet_pnl|moralis_get_wallet_pnl_summary|moralis_get_wallet_defi_positions|moralis_get_wallet_defi_summary|moralis_get_wallet_insight|helius_get_wallet_balances|helius_get_wallet_history|helius_get_wallet_transfers|get_wallet_balances|get_wallet_stats|get_wallet_chart)$/,
+    /^(get_wallet_balances|get_wallet_pnl|get_wallet_trades|get_wallet_transfers|alchemy_get_tokens_by_wallet|alchemy_get_token_balances_by_wallet|alchemy_get_native_balance|alchemy_get_asset_transfers|moralis_get_wallet_history|moralis_get_wallet_profitability|moralis_get_wallet_profitability_summary|moralis_get_wallet_pnl|moralis_get_wallet_pnl_summary|moralis_get_wallet_defi_positions|moralis_get_wallet_defi_summary|moralis_get_wallet_insight|helius_get_wallet_balances|helius_get_wallet_history|helius_get_wallet_transfers|get_wallet_balances|get_wallet_stats|get_wallet_chart)$/,
     WALLET_INVESTIGATION_OUTPUT_SCHEMA
   ],
   [
@@ -53634,6 +54590,11 @@ var CHECK_TOKEN_SAFETY_OUTPUT_SCHEMA = {
       additionalProperties: true,
       description: "Raw provider risk datapoints; '1' means flagged. A missing key means the provider did not report that signal, not that it passed."
     },
+    summary: {
+      type: "object",
+      additionalProperties: true,
+      description: "Concise scam signals: verdicts (plain-language list), lp (lock state and top LP holder), top_holders (largest holder and top-10 share, DEX pairs excluded), creator, owner. Percents are 0-100."
+    },
     holder_count: {},
     token_name: { type: "string" },
     note: { type: "string" }
@@ -54055,11 +55016,11 @@ var TENDERLY_REST_TOOLS = /* @__PURE__ */ new Set([
   "tenderly_estimate_gas",
   "tenderly_decode_calldata"
 ]);
-function matchesProvider(provider, toolName, metadata100) {
+function matchesProvider(provider, toolName, metadata104) {
   const normalizedProvider = provider.toLowerCase();
   const normalizedToolName = toolName.toLowerCase();
-  const resource = metadata100.resource.toLowerCase();
-  const tags = metadata100.tags.map((tag) => tag.toLowerCase());
+  const resource = metadata104.resource.toLowerCase();
+  const tags = metadata104.tags.map((tag) => tag.toLowerCase());
   return normalizedToolName.startsWith(`${normalizedProvider}_`) || normalizedToolName.includes(`_${normalizedProvider}_`) || resource.startsWith(normalizedProvider) || resource.includes(`${normalizedProvider}.`) || tags.includes(normalizedProvider);
 }
 var PROVIDER_CATALOG = [
@@ -54070,7 +55031,7 @@ var PROVIDER_CATALOG = [
     type: "MCP discovery and compatibility tools",
     clientStrategy: "hive",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => toolName.startsWith("hive_") || metadata100.resource === "dynamic_tools" || metadata100.tags.includes("hive")
+    matches: (toolName, metadata104) => toolName.startsWith("hive_") || metadata104.resource === "dynamic_tools" || metadata104.tags.includes("hive")
   },
   {
     id: "coingecko",
@@ -54079,7 +55040,7 @@ var PROVIDER_CATALOG = [
     type: "Market data, prices, and metadata",
     clientStrategy: "shared-coingecko",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("coingecko", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("coingecko", toolName, metadata104)
   },
   {
     id: "goplus",
@@ -54091,7 +55052,7 @@ var PROVIDER_CATALOG = [
       label: "GOPLUS_APP_KEY or GOPLUS_API_KEY, plus GOPLUS_APP_SECRET",
       isConfigured: () => hasAnyEnvVar("GOPLUS_APP_KEY", "GOPLUS_API_KEY") && hasEnvVar("GOPLUS_APP_SECRET")
     },
-    matches: (toolName, metadata100) => matchesProvider("goplus", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("goplus", toolName, metadata104)
   },
   {
     id: "ccxt",
@@ -54100,7 +55061,7 @@ var PROVIDER_CATALOG = [
     type: "Centralized exchange market data and trading metadata",
     clientStrategy: "shared-ccxt",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("ccxt", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("ccxt", toolName, metadata104)
   },
   {
     id: "defillama",
@@ -54109,7 +55070,7 @@ var PROVIDER_CATALOG = [
     type: "TVL, protocol analytics, yields, and bridge data",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("defillama", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("defillama", toolName, metadata104)
   },
   {
     // Listed BEFORE hyperliquid: rwa_get_hyperliquid_dex_perps contains the
@@ -54121,7 +55082,7 @@ var PROVIDER_CATALOG = [
     type: "Tokenized real-world-asset perps: cross-venue funding, markets, and open interest across Hyperliquid HIP-3 builder dexes, Ostium, Avantis, Lighter, and Extended (keyless official APIs)",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("rwa", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("rwa", toolName, metadata104)
   },
   {
     id: "hyperliquid",
@@ -54130,7 +55091,7 @@ var PROVIDER_CATALOG = [
     type: "Hyperliquid perpetual DEX: per-pair volume, funding, open interest, and builder DEXs (tokenized-stock perps)",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("hyperliquid", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("hyperliquid", toolName, metadata104)
   },
   {
     // The Hive-native hive_archive_monitor tool contains the "_archive_"
@@ -54148,7 +55109,7 @@ var PROVIDER_CATALOG = [
         "SHARPE_ARCHIVE_SUPABASE_SERVICE_ROLE_KEY"
       )
     },
-    matches: (toolName, metadata100) => matchesProvider("archive", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("archive", toolName, metadata104)
   },
   {
     id: "polymarket",
@@ -54157,7 +55118,7 @@ var PROVIDER_CATALOG = [
     type: "Polymarket prediction markets: market and event search, market-implied odds, CLOB order books and price history, per-wallet positions and activity (keyless public Gamma, CLOB and Data APIs)",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("polymarket", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("polymarket", toolName, metadata104)
   },
   {
     id: "alternative",
@@ -54166,7 +55127,7 @@ var PROVIDER_CATALOG = [
     type: "Crypto Fear & Greed Index: daily market-wide sentiment composite since 2018 (keyless)",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (_toolName, metadata100) => metadata100.tags.includes("alternative-me")
+    matches: (_toolName, metadata104) => metadata104.tags.includes("alternative-me")
   },
   {
     id: "blockchain",
@@ -54175,7 +55136,16 @@ var PROVIDER_CATALOG = [
     type: "Bitcoin on-chain charts: hash rate, active addresses, transaction count, market price, difficulty, fees, miner revenue (keyless)",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (_toolName, metadata100) => metadata100.tags.includes("blockchain-com")
+    matches: (_toolName, metadata104) => metadata104.tags.includes("blockchain-com")
+  },
+  {
+    id: "blockscout",
+    name: "Blockscout",
+    prefix: "blockscout_",
+    type: "EVM token holder lists and counts from Blockscout explorers (keyless public API; BLOCKSCOUT_API_KEY switches to the PRO API)",
+    clientStrategy: "internal",
+    alwaysAvailable: true,
+    matches: (_toolName, metadata104) => metadata104.tags.includes("blockscout")
   },
   {
     id: "fetch",
@@ -54184,7 +55154,7 @@ var PROVIDER_CATALOG = [
     type: "Allowlisted fetch of long-tail public crypto APIs (the escape hatch when no typed tool covers a source)",
     clientStrategy: "internal",
     alwaysAvailable: true,
-    matches: (toolName, metadata100) => matchesProvider("fetch", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("fetch", toolName, metadata104)
   },
   {
     id: "tenderly",
@@ -54196,7 +55166,7 @@ var PROVIDER_CATALOG = [
       label: "Tenderly REST credentials or TENDERLY_NODE_ACCESS_KEY/TENDERLY_GATEWAY_ACCESS_KEY",
       isConfigured: () => hasTenderlyRestCredentials() || hasTenderlyNodeCredentials()
     },
-    matches: (toolName, metadata100) => matchesProvider("tenderly", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("tenderly", toolName, metadata104)
   },
   {
     id: "moralis",
@@ -54208,7 +55178,7 @@ var PROVIDER_CATALOG = [
       label: "MORALIS_API_KEY",
       isConfigured: () => hasEnvVar("MORALIS_API_KEY")
     },
-    matches: (toolName, metadata100) => matchesProvider("moralis", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("moralis", toolName, metadata104)
   },
   {
     id: "helius",
@@ -54220,7 +55190,7 @@ var PROVIDER_CATALOG = [
       label: "HELIUS_API_KEY",
       isConfigured: () => hasEnvVar("HELIUS_API_KEY")
     },
-    matches: (toolName, metadata100) => matchesProvider("helius", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("helius", toolName, metadata104)
   },
   {
     id: "alchemy",
@@ -54232,11 +55202,11 @@ var PROVIDER_CATALOG = [
       label: "ALCHEMY_API_KEY",
       isConfigured: () => hasEnvVar("ALCHEMY_API_KEY")
     },
-    matches: (toolName, metadata100) => matchesProvider("alchemy", toolName, metadata100)
+    matches: (toolName, metadata104) => matchesProvider("alchemy", toolName, metadata104)
   }
 ];
-function getProviderDescriptorForTool(toolName, metadata100) {
-  return PROVIDER_CATALOG.find((provider) => provider.matches(toolName, metadata100)) ?? UNKNOWN_PROVIDER_DESCRIPTOR;
+function getProviderDescriptorForTool(toolName, metadata104) {
+  return PROVIDER_CATALOG.find((provider) => provider.matches(toolName, metadata104)) ?? UNKNOWN_PROVIDER_DESCRIPTOR;
 }
 function getProviderDescriptorForEndpoint(endpoint) {
   return getProviderDescriptorForTool(endpoint.tool.name, endpoint.metadata);
@@ -54265,7 +55235,7 @@ function getProviderStatusCatalog() {
     })
   );
 }
-function getCredentialRequirementForTool(toolName, metadata100) {
+function getCredentialRequirementForTool(toolName, metadata104) {
   if (toolName === "tenderly_get_supported_networks" || toolName === "tenderly_get_block_number") {
     return null;
   }
@@ -54278,7 +55248,7 @@ function getCredentialRequirementForTool(toolName, metadata100) {
       isConfigured: hasTenderlyNodeCredentials
     };
   }
-  return getProviderDescriptorForTool(toolName, metadata100).credentialRequirement ?? null;
+  return getProviderDescriptorForTool(toolName, metadata104).credentialRequirement ?? null;
 }
 
 // src/mcpInvokers.ts
@@ -54309,14 +55279,14 @@ var RESPONSE_FORMAT_SCHEMA = {
   enum: ["json", "markdown"],
   description: "Output format: 'json' for structured data (default) or 'markdown' for human-readable text."
 };
-function normalizeToolSchema(tool96) {
+function normalizeToolSchema(tool100) {
   const normalized = {
-    ...tool96,
-    inputSchema: tool96.inputSchema ? JSON.parse(JSON.stringify(tool96.inputSchema)) : tool96.inputSchema,
-    title: tool96.title ?? getToolTitle(tool96.name),
+    ...tool100,
+    inputSchema: tool100.inputSchema ? JSON.parse(JSON.stringify(tool100.inputSchema)) : tool100.inputSchema,
+    title: tool100.title ?? getToolTitle(tool100.name),
     annotations: {
-      ...getAnnotationsForTool(tool96.name),
-      ...tool96.annotations ?? {}
+      ...getAnnotationsForTool(tool100.name),
+      ...tool100.annotations ?? {}
     }
   };
   if (normalized.inputSchema && typeof normalized.inputSchema === "object" && normalized.inputSchema.type === "object") {
@@ -54343,20 +55313,19 @@ function normalizeEndpointSchema(endpoint) {
 var RETIRED_TOOLS_DATE = "2026-09-06";
 var RETIRED_TOOL_REPLACEMENTS = {
   // wallet
-  codex_filter_wallets_by_network: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  codex_get_wallet_aggregate_backfill_state: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  codex_get_wallet_label_types: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  filter_network_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  filter_token_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  filter_wallets: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_balances: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_chart: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_stats: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
-  get_wallet_token_events: "Use alchemy_get_token_balances_by_wallet, alchemy_get_asset_transfers, or moralis_get_wallet_profitability_summary for wallet balances, transfers, and PnL.",
+  codex_filter_wallets_by_network: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  codex_get_wallet_aggregate_backfill_state: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  codex_get_wallet_label_types: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  filter_network_wallets: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  filter_token_wallets: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  filter_wallets: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  get_wallet_chart: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  get_wallet_stats: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
+  get_wallet_token_events: "Use get_wallet_balances, get_wallet_transfers, get_wallet_trades, or get_wallet_pnl for wallet balances, transfers, DEX trades, and PnL.",
   // holders
-  get_token_holders: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
-  get_token_top_traders: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
-  get_top_holders_percentage: "Use get_token_top_holders for holders on any network, coingecko_get_onchain_token_top_traders for traders where CoinGecko serves them (base and similar; not Ethereum on the current plan), or moralis_get_token_holder_metrics for holder metrics.",
+  get_token_holders: "Use get_token_top_holders for holders on any network, or coingecko_get_onchain_token_top_traders for traders (tokens created after 2023-09-01; not wrapped native tokens or stablecoins).",
+  get_token_top_traders: "Use get_token_top_holders for holders on any network, or coingecko_get_onchain_token_top_traders for traders (tokens created after 2023-09-01; not wrapped native tokens or stablecoins).",
+  get_top_holders_percentage: "Use get_token_top_holders for holders on any network, or coingecko_get_onchain_token_top_traders for traders (tokens created after 2023-09-01; not wrapped native tokens or stablecoins).",
   // pairs
   codex_get_detailed_token_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
   codex_get_windowed_pair_stats: "Use get_token_pools, get_pool_info, get_pools_by_address, moralis_get_pair_stats, or get_new_pools for pool and pair data.",
@@ -54414,7 +55383,12 @@ var HELIUS_WALLET_PLAN = "because Helius answers 403 for it on Hive's current He
 var DEFILLAMA_PRO = "because it needs a DeFiLlama Pro plan, which Hive does not have";
 var DEFILLAMA_DERIVATIVES_REPLACEMENT = "Use defillama_get_open_interest, defillama_get_derivatives_aggregator_volumes, or get_derivatives_exchanges for derivatives activity.";
 var ALCHEMY_PAYG = "because Alchemy offers it only on Pay As You Go and Enterprise plans, and Hive's key is on the Free tier";
-var ALCHEMY_BUNDLE_REPLACEMENT = "Use tenderly_simulate_bundle for multi-transaction simulation, or alchemy_simulate_asset_changes and alchemy_simulate_execution one transaction at a time.";
+var ALCHEMY_BUNDLE_REPLACEMENT = "Use tenderly_simulate_bundle or tenderly_node_simulate_bundle for multi-transaction simulation.";
+var ALCHEMY_SIMULATION_SUNSET = 'because Alchemy shut down its Transaction Simulation API on 2026-09-30 and now answers "Unsupported method" on every plan';
+var ALCHEMY_SIMULATION_REPLACEMENT = "Use tenderly_simulate_transaction or tenderly_node_simulate_transaction; both return the execution trace, logs, and asset and balance changes without broadcasting.";
+var MORALIS_PAUSED = "because Hive's Moralis account is paused and will not be renewed";
+var MORALIS_BALANCES_REPLACEMENT = "Use get_wallet_balances for priced EVM balances across chains.";
+var MORALIS_PNL_REPLACEMENT = "Use get_wallet_pnl for realized and unrealized PnL per wallet and per token.";
 var CCXT_PRIVATE = "because every exchange that serves it requires an authenticated exchange account";
 var CCXT_BORROW_REPLACEMENT = "Use ccxt_fetch_borrow_rate_history or ccxt_fetch_borrow_rate_histories (public) and read the latest point.";
 var UNSERVABLE_TOOLS = {
@@ -54434,10 +55408,6 @@ var UNSERVABLE_TOOLS = {
     reason: COINGECKO_ENTERPRISE,
     replacement: COINGECKO_SUPPLY_REPLACEMENT
   },
-  get_coin_insights: {
-    reason: COINGECKO_ENTERPRISE,
-    replacement: "No direct replacement; use get_coins_market_data and get_coin_tickers for the market facts behind an insight."
-  },
   helius_get_wallet_identity: {
     reason: HELIUS_WALLET_PLAN,
     replacement: "No other wallet-identity source is live on Hive's plans; use helius_get_wallet_history or helius_get_transfers_by_address for the wallet's activity."
@@ -54498,9 +55468,74 @@ var UNSERVABLE_TOOLS = {
     reason: CCXT_PRIVATE,
     replacement: CCXT_BORROW_REPLACEMENT
   },
+  alchemy_simulate_asset_changes: {
+    reason: ALCHEMY_SIMULATION_SUNSET,
+    replacement: ALCHEMY_SIMULATION_REPLACEMENT,
+    date: "2026-10-09"
+  },
+  alchemy_simulate_execution: {
+    reason: ALCHEMY_SIMULATION_SUNSET,
+    replacement: ALCHEMY_SIMULATION_REPLACEMENT,
+    date: "2026-10-09"
+  },
+  alchemy_is_holder_of_contract: {
+    reason: 'because Alchemy deprecated the isHolderOfContract endpoint, which now answers 404 "This API endpoint has been deprecated"',
+    replacement: "Use alchemy_get_nfts_for_owner for the wallet and look for the contract, or alchemy_get_owners_for_contract and look for the wallet.",
+    date: "2026-10-09"
+  },
   goplus_simulate_solana_transaction: {
     reason: 'because GoPlus answers "system error" to every Solana pre-execution request, including a fresh valid transfer',
     replacement: "Use get_solana_token_security for the tokens the transaction touches; Hive has no other Solana pre-signing simulation."
+  },
+  moralis_get_wallet_token_balances: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_BALANCES_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_token_balances_price: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_BALANCES_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_net_worth: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_BALANCES_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_profitability: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_PNL_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_profitability_summary: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_PNL_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_pnl: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_PNL_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_pnl_summary: {
+    reason: MORALIS_PAUSED,
+    replacement: MORALIS_PNL_REPLACEMENT,
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_swaps: {
+    reason: MORALIS_PAUSED,
+    replacement: "Use get_wallet_trades for a wallet's DEX buys and sells.",
+    date: "2026-10-14"
+  },
+  moralis_get_wallet_token_transfers: {
+    reason: MORALIS_PAUSED,
+    replacement: "Use get_wallet_transfers for EVM token transfers, or helius_get_wallet_transfers on Solana.",
+    date: "2026-10-14"
+  },
+  moralis_get_token_top_traders: {
+    reason: MORALIS_PAUSED,
+    replacement: "Use coingecko_get_onchain_token_top_traders for a token's most profitable traders.",
+    date: "2026-10-14"
   }
 };
 function isUnservableTool(toolName) {
@@ -54510,7 +55545,7 @@ function getRetiredTool(toolName) {
   if (isUnservableTool(toolName)) {
     const entry2 = UNSERVABLE_TOOLS[toolName];
     return {
-      date: UNSERVABLE_TOOLS_DATE,
+      date: entry2.date ?? UNSERVABLE_TOOLS_DATE,
       cause: entry2.reason,
       replacement: entry2.replacement
     };
@@ -54687,7 +55722,40 @@ function boundedJsonTruncationStub(originalLength, note, characterLimit) {
   ];
   return candidates.find((candidate) => candidate.length <= characterLimit) ?? "";
 }
-function smartTruncate(text, characterLimit = CHARACTER_LIMIT) {
+function inputSchemaParamNames(schema) {
+  const properties = schema?.properties;
+  return properties && typeof properties === "object" ? Object.keys(properties) : [];
+}
+function truncationRecallHint(params = [], nextOffset) {
+  const names = new Set(params);
+  if (names.has("offset")) {
+    return `Re-call with offset=${nextOffset ?? "_pagination.next_offset"} to continue, or add filters.`;
+  }
+  const sizeParam = ["limit", "per_page", "page_size", "count"].find(
+    (name) => names.has(name)
+  );
+  return sizeParam ? `This tool has no offset parameter: a smaller ${sizeParam} returns an untruncated page; narrower filters reach the remaining rows.` : "This tool has no paging parameter: narrow the request with its filters to see the rest.";
+}
+function truncationPagination(kept, original, context) {
+  const params = [...context.params ?? []];
+  const head = `Response truncated from ${original} to ${kept} items to fit the response budget.`;
+  const base = {
+    count: kept,
+    total_count: original,
+    has_more: kept < original
+  };
+  if (!params.includes("offset")) {
+    return { ...base, note: `${head} ${truncationRecallHint(params)}` };
+  }
+  const start = typeof context.offset === "number" && Number.isFinite(context.offset) ? Math.max(0, Math.floor(context.offset)) : 0;
+  return {
+    ...base,
+    offset: start,
+    next_offset: start + kept,
+    note: `${head} ${truncationRecallHint(params, start + kept)}`
+  };
+}
+function smartTruncate(text, characterLimit = CHARACTER_LIMIT, pagination = {}) {
   if (text.length <= characterLimit) return text;
   const originalLength = text.length;
   const head = text.trimStart();
@@ -54748,14 +55816,11 @@ function smartTruncate(text, characterLimit = CHARACTER_LIMIT) {
   if (typeof parsed === "object" && parsed !== null && !Array.isArray(parsed)) {
     const obj = parsed;
     if (pagInfo && pagInfo.kept < pagInfo.original) {
-      obj._pagination = {
-        count: pagInfo.kept,
-        total_count: pagInfo.original,
-        offset: 0,
-        has_more: pagInfo.kept < pagInfo.original,
-        next_offset: pagInfo.kept,
-        note: `Response truncated from ${pagInfo.original} to ${pagInfo.kept} items. Re-call with offset=${pagInfo.kept} or add filters to see more.`
-      };
+      obj._pagination = truncationPagination(
+        pagInfo.kept,
+        pagInfo.original,
+        pagination
+      );
     }
     if (dropped.length > 0) {
       obj._dropped_fields = dropped;
@@ -54826,9 +55891,9 @@ function withExecMarker(result2, marker) {
 function humanizePropertyName(propName) {
   return propName.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/[_-]+/g, " ").trim().toLowerCase();
 }
-function fillMissingInputDescriptions(tool96) {
-  const schema = tool96.inputSchema;
-  if (!schema?.properties) return tool96;
+function fillMissingInputDescriptions(tool100) {
+  const schema = tool100.inputSchema;
+  if (!schema?.properties) return tool100;
   let changed = false;
   const properties = {};
   for (const [propName, propSchema] of Object.entries(schema.properties)) {
@@ -54839,14 +55904,14 @@ function fillMissingInputDescriptions(tool96) {
     changed = true;
     properties[propName] = {
       ...propSchema,
-      description: `${humanizePropertyName(propName)} parameter for ${tool96.name}. See the tool Args section for accepted values and examples.`
+      description: `${humanizePropertyName(propName)} parameter for ${tool100.name}. See the tool Args section for accepted values and examples.`
     };
   }
-  if (!changed) return tool96;
+  if (!changed) return tool100;
   return {
-    ...tool96,
+    ...tool100,
     inputSchema: {
-      ...tool96.inputSchema,
+      ...tool100.inputSchema,
       properties
     }
   };
@@ -54872,24 +55937,25 @@ function stripProviderPrefix(toolName) {
 var fallbackCoinGeckoClient = null;
 function getFallbackCoinGeckoClient() {
   if (!fallbackCoinGeckoClient) {
-    fallbackCoinGeckoClient = new Coingecko2(getCoinGeckoClientOptions());
+    fallbackCoinGeckoClient = new Coingecko3(getCoinGeckoClientOptions());
   }
   return fallbackCoinGeckoClient;
 }
 function isKeylessCoinGeckoClient(client2) {
-  return client2 instanceof Coingecko2 && !client2.proAPIKey && !client2.demoAPIKey;
+  return client2 instanceof Coingecko3 && !client2.proAPIKey && !client2.demoAPIKey;
 }
-function createSafeHandler(handler96, metadata100, toolName) {
+function createSafeHandler(handler100, metadata104, toolName, inputSchema) {
+  const schemaParams = inputSchemaParamNames(inputSchema);
   const credentialRequirement = getCredentialRequirementForTool(
     toolName,
-    metadata100
+    metadata104
   );
   return async (client2, args) => {
     const t0 = Date.now();
     try {
-      let usedFallback = metadata100.tags.includes("coingecko") && isKeylessCoinGeckoClient(client2);
+      let usedFallback = metadata104.tags.includes("coingecko") && isKeylessCoinGeckoClient(client2);
       let effectiveClient = client2;
-      if (effectiveClient == null && metadata100.tags.includes("coingecko")) {
+      if (effectiveClient == null && metadata104.tags.includes("coingecko")) {
         effectiveClient = getFallbackCoinGeckoClient();
         usedFallback = isKeylessCoinGeckoClient(effectiveClient);
       }
@@ -54920,7 +55986,7 @@ function createSafeHandler(handler96, metadata100, toolName) {
           );
         }
       }
-      let result2 = await handler96(effectiveClient, safeArgs);
+      let result2 = await handler100(effectiveClient, safeArgs);
       const observedAt = (/* @__PURE__ */ new Date()).toISOString();
       if (result2._hiveExec?.source === "fallback") usedFallback = true;
       if (!result2.isError && credentialRequirement && !credentialRequirement.isConfigured() && result2?.content?.[0]?.type === "text" && result2.content[0].text) {
@@ -54975,7 +56041,15 @@ function createSafeHandler(handler96, metadata100, toolName) {
           withExecMarker(
             {
               ...result2,
-              content: [{ type: "text", text: smartTruncate(text) }]
+              content: [
+                {
+                  type: "text",
+                  text: smartTruncate(text, CHARACTER_LIMIT, {
+                    params: schemaParams,
+                    offset: safeArgs.offset
+                  })
+                }
+              ]
             },
             {
               truncated: true,
@@ -55138,14 +56212,15 @@ function getAllWrappedEndpoints() {
     ...getAllArchiveEndpoints(),
     ...getAllPolymarketEndpoints(),
     ...getAllSignalsEndpoints(),
+    ...getAllBlockscoutEndpoints(),
     ...getAllFetchEndpoints()
   ];
   const allEndpointsJSON = wrapper;
   const updatedTools = [];
   for (const endpoint of allTool) {
-    let { tool: tool96 } = endpoint;
+    let { tool: tool100 } = endpoint;
     let matchedItem = null;
-    const originalName = tool96.name;
+    const originalName = tool100.name;
     const strippedName = stripProviderPrefix(originalName);
     for (const endpoints of Object.values(allEndpointsJSON)) {
       for (const item of endpoints) {
@@ -55171,10 +56246,10 @@ function getAllWrappedEndpoints() {
     }
     if (matchedItem) {
       let toolInstanse = {
-        ...tool96,
+        ...tool100,
         name: matchedItem.tool.name,
-        title: tool96.title ?? getToolTitle(matchedItem.tool.name),
-        description: matchedItem.tool.description ?? tool96.description
+        title: tool100.title ?? getToolTitle(matchedItem.tool.name),
+        description: matchedItem.tool.description ?? tool100.description
       };
       if (!toolInstanse.annotations) {
         toolInstanse.annotations = getAnnotationsForTool(toolInstanse.name);
@@ -55193,7 +56268,8 @@ function getAllWrappedEndpoints() {
         handler: createSafeHandler(
           endpoint.handler,
           endpoint.metadata,
-          toolInstanse.name
+          toolInstanse.name,
+          toolInstanse.inputSchema
         ),
         metadata: endpoint.metadata,
         tool: toolInstanse
@@ -55216,10 +56292,10 @@ function getAllWrappedEndpoints() {
         "signals_",
         "fetch_"
       ];
-      if (selfDescribedPrefixes.some((p) => tool96.name.startsWith(p)) || isFreeWriteEndpoint(tool96.name)) {
+      if (selfDescribedPrefixes.some((p) => tool100.name.startsWith(p)) || isFreeWriteEndpoint(tool100.name)) {
         let toolInstanse = {
-          ...tool96,
-          title: tool96.title ?? getToolTitle(tool96.name)
+          ...tool100,
+          title: tool100.title ?? getToolTitle(tool100.name)
         };
         if (!toolInstanse.annotations) {
           toolInstanse.annotations = getAnnotationsForTool(toolInstanse.name);
@@ -55237,14 +56313,15 @@ function getAllWrappedEndpoints() {
           handler: createSafeHandler(
             endpoint.handler,
             endpoint.metadata,
-            toolInstanse.name
+            toolInstanse.name,
+            toolInstanse.inputSchema
           ),
           metadata: endpoint.metadata,
           tool: toolInstanse
         });
       } else {
         secureLogger.debug(
-          `No match found in allEndpoints for tool: ${tool96.name}`
+          `No match found in allEndpoints for tool: ${tool100.name}`
         );
       }
     }
@@ -55260,9 +56337,9 @@ function getToolByCategory(category) {
   const allWrappedTools = getAllWrappedEndpoints();
   const tools5 = [];
   for (const toolName of toolNameList) {
-    const tool96 = allWrappedTools.find((tool97) => tool97.tool.name === toolName);
-    if (tool96) {
-      tools5.push(tool96);
+    const tool100 = allWrappedTools.find((tool101) => tool101.tool.name === toolName);
+    if (tool100) {
+      tools5.push(tool100);
     }
   }
   return tools5;
@@ -55485,8 +56562,13 @@ var ToolRegistry = [
   {
     category: "Portfolio & Wallet",
     name: "get_portfolio_wallet_endpoints",
-    description: "Endpoints for tracking user wallet balances, transaction history, portfolio positions across protocols and chains, net asset calculations, token holdings analysis, comprehensive wallet activity monitoring, real-time balance tracking, balance update history over time, multi-token portfolio analysis, balance changes with transaction context, financial auditing capabilities for individual users and addresses, wallet filtering and discovery, NFT holdings tracking, wallet PnL, DeFi positions, swap history, and wallet insight metrics. Provider guide: Use alchemy_ tools for default EVM portfolio, balances, transfers, and NFT holdings. Use moralis_ tools only for unique wallet intelligence (PnL, DeFi positions, decoded wallet insight/history). Use helius_ tools for Solana-native wallet depth (native SOL balance, SPL token accounts, Digital Asset Standard assets owned by a wallet).",
+    description: "Endpoints for tracking user wallet balances, transaction history, portfolio positions across protocols and chains, net asset calculations, token holdings analysis, comprehensive wallet activity monitoring, real-time balance tracking, balance update history over time, multi-token portfolio analysis, balance changes with transaction context, financial auditing capabilities for individual users and addresses, wallet filtering and discovery, NFT holdings tracking, wallet PnL, DeFi positions, swap history, and wallet insight metrics. Provider guide: Use get_wallet_balances, get_wallet_pnl, get_wallet_trades, and get_wallet_transfers (CoinGecko) for EVM balances, PnL, DEX trades, and transfers. Use alchemy_ tools for NFT holdings, raw transfers, and EVM chains CoinGecko does not cover. Use moralis_ tools only for DeFi positions and decoded wallet insight/history. Use helius_ tools for Solana-native wallet depth (native SOL balance, SPL token accounts, Digital Asset Standard assets owned by a wallet).",
     tools: [
+      // CoinGecko wallet data (default for EVM balances, PnL, DEX trades, transfers)
+      "get_wallet_balances",
+      "get_wallet_pnl",
+      "get_wallet_trades",
+      "get_wallet_transfers",
       "alchemy_get_tokens_by_wallet",
       "alchemy_get_token_balances_by_wallet",
       "alchemy_get_nfts_by_wallet",
@@ -55517,24 +56599,15 @@ var ToolRegistry = [
       "alchemy_solana_get_transaction_with_compression_info",
       // Moralis wallet intelligence tools
       "moralis_get_wallet_history",
-      "moralis_get_wallet_profitability",
-      "moralis_get_wallet_profitability_summary",
-      "moralis_get_wallet_pnl",
-      "moralis_get_wallet_pnl_summary",
       "moralis_get_wallet_defi_positions",
       "moralis_get_wallet_defi_summary",
-      "moralis_get_wallet_swaps",
       "moralis_get_wallet_chain_activity",
       "moralis_get_wallet_stats",
       "moralis_get_wallet_insight",
-      "moralis_get_wallet_token_balances",
-      "moralis_get_wallet_token_balances_price",
-      "moralis_get_wallet_net_worth",
       "moralis_get_wallet_approvals",
       "moralis_get_wallet_active_chains",
       "moralis_get_native_balance",
       "moralis_get_native_balances_batch",
-      "moralis_get_wallet_token_transfers",
       "moralis_get_sol_balance",
       "moralis_get_sol_token_balances",
       "moralis_get_sol_portfolio",
@@ -55594,6 +56667,7 @@ var ToolRegistry = [
       "get_tokens_by_address",
       "get_token_info",
       "get_token_top_holders",
+      "get_token_holder_distribution",
       "get_token_holders_chart",
       "get_multi_tokens",
       "get_recently_updated_tokens",
@@ -55618,7 +56692,6 @@ var ToolRegistry = [
       "moralis_get_token_metadata_batch",
       "moralis_get_token_holders",
       "moralis_get_token_transfers",
-      "moralis_get_token_top_traders",
       "moralis_get_token_details",
       "moralis_get_sol_token_price",
       "moralis_get_sol_token_metadata",
@@ -55696,7 +56769,6 @@ var ToolRegistry = [
       "alchemy_get_floor_price",
       "alchemy_get_contracts_for_owner",
       "alchemy_is_spam_contract",
-      "alchemy_is_holder_of_contract",
       "alchemy_solana_get_asset",
       "alchemy_solana_get_asset_proof",
       "alchemy_solana_get_asset_proofs",
@@ -55798,9 +56870,7 @@ var ToolRegistry = [
       "tenderly_get_contract_abi",
       "tenderly_get_storage_changes",
       "tenderly_get_transactions_range",
-      "alchemy_get_token_allowance",
-      "alchemy_simulate_asset_changes",
-      "alchemy_simulate_execution"
+      "alchemy_get_token_allowance"
     ]
   },
   {
@@ -55858,6 +56928,7 @@ var ToolRegistry = [
       "get_exchanges_list",
       "get_derivatives_exchanges_list",
       "get_news",
+      "get_coin_insights",
       "moralis_search_entities",
       "moralis_get_entity",
       "moralis_get_entities_by_category",
@@ -55973,7 +57044,7 @@ import {
 import { existsSync, readFileSync, readdirSync } from "fs";
 import { dirname, resolve as resolvePath } from "path";
 import { fileURLToPath } from "url";
-import Coingecko4 from "@coingecko/coingecko-typescript";
+import Coingecko5 from "@coingecko/coingecko-typescript";
 
 // src/tools/dynamic-tools.ts
 import { z as z4 } from "zod";
@@ -56289,20 +57360,51 @@ function isUnmarkedErrorResponse(result2) {
   }
   return false;
 }
+var PROVIDER_SIDE_ERROR_COPY = {
+  plan_required: {
+    message: "The upstream provider declined this call: the endpoint is outside this deployment's provider plan or quota (runtime_status plan_required). The arguments were not the problem.",
+    suggestion: "Use search_tools to pick another tool for the same data. Retrying unchanged will fail again."
+  },
+  rate_limited: {
+    message: "The upstream provider rate limit was hit (runtime_status rate_limited).",
+    suggestion: "Wait about 60 seconds before one retry, or narrow the request with this tool's filters."
+  },
+  missing_key: {
+    suggestion: "This provider has no working credential on this deployment. Use search_tools to pick another tool for the same data; self-hosted deployments can configure the provider's API key."
+  }
+};
+var VENDOR_ACCOUNT_URL = /https?:\/\/[^\s"')\]]*(?:billing|pricing|plan|upgrade|admin|dashboard|account|subscri|checkout)[^\s"')\]]*/gi;
+function sanitizeProviderError(message, suggestion) {
+  const copy = PROVIDER_SIDE_ERROR_COPY[classifyRuntimeStatusFromError(message)];
+  return {
+    message: (copy?.message ?? message).replace(
+      VENDOR_ACCOUNT_URL,
+      "[link removed]"
+    ),
+    suggestion: copy?.suggestion ?? suggestion,
+    providerSide: Boolean(copy)
+  };
+}
+function collapseErrorMarkers(text) {
+  return text.replace(/(?:\*\*Error:\*\*\s*){2,}/g, "**Error:** ");
+}
 function normalizeErrorText(text, toolName, args) {
   let errorMsg = "";
   let code = "";
   let suggestion = "";
-  let alternatives = "";
+  let alternatives = [];
   let documentation = "";
   try {
     const parsed = JSON.parse(text);
     if (parsed && typeof parsed === "object" && typeof parsed.error === "string") {
       errorMsg = parsed.error;
+      if (typeof parsed.message === "string" && parsed.message.trim() && !errorMsg.includes(parsed.message)) {
+        errorMsg += `: ${parsed.message.replace(/https?:\/\/\S+/g, "[url]")}`;
+      }
       code = typeof parsed.code === "string" ? parsed.code : "";
       suggestion = parsed.suggestion || "";
       if (Array.isArray(parsed.alternatives) && parsed.alternatives.length > 0) {
-        alternatives = parsed.alternatives.join(", ");
+        alternatives = parsed.alternatives.map(String);
       }
       documentation = parsed.documentation || "";
     }
@@ -56310,7 +57412,18 @@ function normalizeErrorText(text, toolName, args) {
   }
   if (errorMsg) {
     const bareErrorMsg = errorMsg.replace(/^(?:\s*\*\*Error:\*\*\s*)+/, "");
-    let normalized = `**Error:** ${bareErrorMsg}`;
+    if (bareErrorMsg.includes("\n\n**Code:**")) {
+      return collapseErrorMarkers(`**Error:** ${bareErrorMsg}`);
+    }
+    const safe = sanitizeProviderError(bareErrorMsg, suggestion);
+    suggestion = safe.suggestion;
+    const prefix = toolName?.split("_")[0];
+    if (safe.providerSide && prefix) {
+      alternatives = alternatives.filter(
+        (name) => !name.startsWith(`${prefix}_`)
+      );
+    }
+    let normalized = `**Error:** ${safe.message}`;
     normalized += `
 
 **Code:** ${code || "API_ERROR"}`;
@@ -56326,15 +57439,29 @@ function normalizeErrorText(text, toolName, args) {
 
 **Params:** ${truncated}`;
     }
-    if (alternatives) normalized += `
+    if (alternatives.length > 0) {
+      normalized += `
 
-**Alternatives:** ${alternatives}`;
+**Alternatives:** ${alternatives.join(", ")}`;
+    }
     if (documentation) normalized += `
 
 **Documentation:** ${documentation}`;
     return normalized;
   }
-  let result2 = text;
+  let result2 = collapseErrorMarkers(text);
+  const head = /^\*\*Error:\*\* (.*?)(?=\n\n\*\*|$)/s.exec(result2);
+  if (head) {
+    const safe = sanitizeProviderError(head[1], "");
+    result2 = result2.replace(head[0], `**Error:** ${safe.message}`);
+    if (safe.suggestion) {
+      result2 = result2.replace(
+        /\*\*Suggestion:\*\* [^\n]*/,
+        `**Suggestion:** ${safe.suggestion}`
+      );
+    }
+  }
+  result2 = result2.replace(VENDOR_ACCOUNT_URL, "[link removed]");
   if (toolName && !result2.includes("**Tool:**")) {
     result2 += `
 
@@ -56379,8 +57506,8 @@ function normalizeToolResponse(result2, toolName, args) {
 }
 
 // src/utils/clientRouter.ts
-function getClientForTool(metadata100, clients) {
-  const provider = getProviderDescriptorForTool("", metadata100);
+function getClientForTool(metadata104, clients) {
+  const provider = getProviderDescriptorForTool("", metadata104);
   if (provider.clientStrategy === "shared-goplus") {
     return clients.goplusClient ?? void 0;
   }
@@ -57019,7 +58146,7 @@ function describeErrorCode(code) {
 // src/utils/agentErrorCopy.ts
 function agentErrorCopy(status, context = {}) {
   const provider = context.provider || "the provider";
-  const tool96 = context.tool || "this tool";
+  const tool100 = context.tool || "this tool";
   switch (status) {
     case "ok":
       return {
@@ -57029,17 +58156,17 @@ function agentErrorCopy(status, context = {}) {
     case "invalid_input":
       return {
         cause: "The arguments failed validation or named an unsupported venue/method; the provider was not the problem.",
-        next_action: `Fix the arguments: call get_api_endpoint_schema for '${tool96}', use supported values, then retry. Do not retry unchanged.`
+        next_action: `Fix the arguments: call get_api_endpoint_schema for '${tool100}', use supported values, then retry. Do not retry unchanged.`
       };
     case "missing_key":
       return {
-        cause: `${provider} is not configured on this deployment (no API credential), so '${tool96}' cannot return data here.`,
-        next_action: `Do not retry '${tool96}'. Use search_tools to pick a sibling provider tool for the same data, or ask the operator to configure ${provider} credentials.`
+        cause: `${provider} is not configured on this deployment (no API credential), so '${tool100}' cannot return data here.`,
+        next_action: `Do not retry '${tool100}'. Use search_tools to pick a sibling provider tool for the same data, or ask the operator to configure ${provider} credentials.`
       };
     case "plan_required":
       return {
         cause: `This ${provider} endpoint needs a paid plan, quota, or credits that this deployment does not have.`,
-        next_action: "Use search_tools to pick an alternative provider tool for the same data, or upgrade the plan. Retrying unchanged will fail again."
+        next_action: "Use search_tools to pick an alternative provider tool for the same data. Retrying unchanged will fail again."
       };
     case "rate_limited":
       return {
@@ -57053,7 +58180,7 @@ function agentErrorCopy(status, context = {}) {
       };
     case "failing":
       return {
-        cause: `${provider} returned an unexpected error for '${tool96}'.`,
+        cause: `${provider} returned an unexpected error for '${tool100}'.`,
         next_action: "Do not retry in a loop. Try the route fallback tool or a sibling provider via search_tools, and report the runtime_status to the user."
       };
   }
@@ -57613,17 +58740,17 @@ function fitPayloadWithinReceiptBudget(value, hive, isError = false) {
   const payloadBudget = Math.max(256, CHARACTER_LIMIT - receiptLength + 1);
   const truncated = smartTruncate(JSON.stringify(payload), payloadBudget);
   const parsed = parseToolText(truncated);
-  let boundedPayload = toHiveResultPayload(parsed);
-  hive.result_digest = digestHiveCanonicalJson(boundedPayload);
-  if (JSON.stringify({ ...boundedPayload, _hive: hive }).length > CHARACTER_LIMIT) {
-    boundedPayload = {
+  let boundedPayload2 = toHiveResultPayload(parsed);
+  hive.result_digest = digestHiveCanonicalJson(boundedPayload2);
+  if (JSON.stringify({ ...boundedPayload2, _hive: hive }).length > CHARACTER_LIMIT) {
+    boundedPayload2 = {
       _truncated: true,
       _original_length: JSON.stringify(payload).length,
       _note: "Response omitted because the provider payload plus its execution receipt exceeded the response limit. Re-call with narrower parameters or filters."
     };
-    hive.result_digest = digestHiveCanonicalJson(boundedPayload);
+    hive.result_digest = digestHiveCanonicalJson(boundedPayload2);
   }
-  return boundedPayload;
+  return boundedPayload2;
 }
 function createHiveExecutionMetadata(endpoint, durationMs, runtimeStatus, source, warnings = [], exec, integrity = {}, credit = {}) {
   const fetchedAt = (/* @__PURE__ */ new Date()).toISOString();
@@ -58162,6 +59289,17 @@ function executionGateFailureResult(endpoint, gate, durationMs, args, credit = {
   };
 }
 async function executeEndpoint(endpoint, args, context) {
+  const result2 = await executeEndpointUnchecked(endpoint, args, context);
+  if (result2.mcpResult.isError && endpoint.tool.outputSchema && result2.mcpResult.structuredContent !== void 0 && validateJsonSchema(
+    result2.mcpResult.structuredContent,
+    endpoint.tool.outputSchema
+  ).length > 0) {
+    const { structuredContent: _omitted, ...textOnly } = result2.mcpResult;
+    return { ...result2, mcpResult: textOnly };
+  }
+  return result2;
+}
+async function executeEndpointUnchecked(endpoint, args, context) {
   const start = context.startMs ?? Date.now();
   const validationErrors = validateEndpointArgs(endpoint, args);
   if (validationErrors.length > 0) {
@@ -58277,15 +59415,22 @@ async function executeEndpoint(endpoint, args, context) {
       const guardLimit = getAnnotatedMaxResultSizeChars(endpoint.tool) ?? DEFAULT_RESULT_SIZE_GUARD_CHARS;
       const successText = getTextContent(normalized);
       if (successText && successText.length > guardLimit) {
+        const guardParams = inputSchemaParamNames(endpoint.tool.inputSchema);
         bounded = {
           ...normalized,
           content: [
-            { type: "text", text: smartTruncate(successText, guardLimit) }
+            {
+              type: "text",
+              text: smartTruncate(successText, guardLimit, {
+                params: guardParams,
+                offset: args?.offset
+              })
+            }
           ]
         };
         execForHive = { ...exec, truncated: true };
         guardWarnings.push(
-          `Response exceeded ${guardLimit} characters and was truncated for model-context safety. Narrow the request with limit/page parameters or response_format="concise"; tools annotated with anthropic/maxResultSizeChars keep full headroom.`
+          `Response exceeded ${guardLimit} characters and was truncated for model-context safety. ${truncationRecallHint(guardParams)}`
         );
       }
     }
@@ -58498,7 +59643,7 @@ var CHAIN_ID_NAMES = {};
 for (const [name, id] of Object.entries(GOPLUS_CHAIN_IDS)) {
   if (!(id in CHAIN_ID_NAMES)) CHAIN_ID_NAMES[id] = name;
 }
-var CHAIN_ALIASES = [
+var CHAIN_ALIASES2 = [
   "chain",
   "network",
   "chain_id",
@@ -58535,7 +59680,7 @@ var HERO_ARG_ALIASES = {
       "name"
     ],
     address: CONTRACT_ADDRESS_ALIASES,
-    chain: CHAIN_ALIASES,
+    chain: CHAIN_ALIASES2,
     vs_currency: [
       "vs_currency",
       "vsCurrency",
@@ -58548,7 +59693,7 @@ var HERO_ARG_ALIASES = {
   },
   check_token_safety: {
     address: [...CONTRACT_ADDRESS_ALIASES, "token"],
-    chain: CHAIN_ALIASES,
+    chain: CHAIN_ALIASES2,
     response_format: RESPONSE_FORMAT_ALIASES
   },
   get_wallet_portfolio: {
@@ -58561,7 +59706,8 @@ var HERO_ARG_ALIASES = {
       "account_address",
       "owner"
     ],
-    chain: CHAIN_ALIASES,
+    chain: CHAIN_ALIASES2,
+    include_spam: ["include_spam", "includeSpam", "show_spam"],
     response_format: RESPONSE_FORMAT_ALIASES
   }
 };
@@ -58848,9 +59994,10 @@ function heroTools(endpoints, options = {}) {
       address,
       chain: chainLabel,
       risk_flags: flags,
+      ...isRecord3(entry2) ? { summary: summarizeTokenSafety(entry2) } : {},
       ...isRecord3(entry2) && entry2.holder_count !== void 0 ? { holder_count: entry2.holder_count } : {},
       ...isRecord3(entry2) && entry2.token_name !== void 0 ? { token_name: entry2.token_name } : {},
-      note: "risk_flags are raw GoPlus datapoints; treat '1' as flagged. Use response_format=detailed for the full report."
+      note: "risk_flags are raw GoPlus datapoints; treat '1' as flagged. summary.verdicts restates the scam signals in plain language; an empty list means none fired, not that the token is safe. Use response_format=detailed for the full report."
     };
   };
   const checkTokenSafety = {
@@ -58862,7 +60009,7 @@ function heroTools(endpoints, options = {}) {
     tool: {
       name: "check_token_safety",
       title: "Check Token Safety",
-      description: "Token security screen for a contract address: honeypot, taxes, ownership, and related GoPlus risk datapoints. EVM chains use chain + address; Solana addresses are detected automatically.",
+      description: "Token security screen for a contract address: honeypot, taxes, ownership, and related GoPlus risk datapoints, plus a summary of LP lock status, top-holder concentration, and creator/owner balances with plain-language verdicts. EVM chains use chain + address; Solana addresses are detected automatically.",
       inputSchema: zodToInputSchema(tokenSafetySchema),
       outputSchema: heroOutputSchema("check_token_safety"),
       annotations: VOLATILE_READ_ANNOTATIONS
@@ -58906,9 +60053,13 @@ function heroTools(endpoints, options = {}) {
     chain: z2.string().trim().max(40).optional().describe(
       'Chain name, for example "eth", "base", "arbitrum", or "solana". Defaults to eth for 0x addresses; Solana is auto-detected.'
     ),
+    include_spam: z2.boolean().optional().describe(
+      "Show likely spam airdrops (tokens with a URL or claim lure in the name, and on EVM chains tokens with no market price). Default false; the response says how many were hidden."
+    ),
     response_format: RESPONSE_FORMAT
   });
   const MAX_CONCISE_TOKENS = 15;
+  const SPAM_LURE = /(https?:\/\/|www\.|t\.me\/|\.(com|xyz|io|org|net|app|site|top|lol|info|claim|gift)\b|\bclaim|\bvisit\b|airdrop|\breward)/i;
   const NATIVE_SYMBOLS = {
     eth: "ETH",
     ethereum: "ETH",
@@ -58948,10 +60099,10 @@ function heroTools(endpoints, options = {}) {
   };
   const usdFromPrices = (token, balance) => {
     if (!Array.isArray(token.tokenPrices)) return null;
-    const usd = token.tokenPrices.find(
+    const usd2 = token.tokenPrices.find(
       (price) => isRecord3(price) && price.currency === "usd"
     );
-    const rate = usd && isRecord3(usd) ? Number(usd.value) : NaN;
+    const rate = usd2 && isRecord3(usd2) ? Number(usd2.value) : NaN;
     const quantity = balance == null ? NaN : Number(balance);
     const value = rate * quantity;
     if (!Number.isFinite(value)) return null;
@@ -58968,44 +60119,72 @@ function heroTools(endpoints, options = {}) {
     }
     return [];
   };
-  const trimWalletPortfolio = (address, chainLabel) => (payload) => {
+  const trimWalletPortfolio = (address, chainLabel, includeSpam = false, priced = false) => (payload) => {
     const walletLower = address.trim().toLowerCase();
     const tokens = firstArray(payload, ["tokens", "items", "balances"]);
     const summarized = tokens.map((token) => {
       if (!isRecord3(token)) return token;
-      const metadata100 = isRecord3(token.tokenMetadata) ? token.tokenMetadata : isRecord3(token.token) ? token.token : void 0;
+      const metadata104 = isRecord3(token.tokenMetadata) ? token.tokenMetadata : isRecord3(token.token) ? token.token : void 0;
       const fallbackAddress = typeof token.address === "string" && token.address.trim().toLowerCase() === walletLower ? null : token.address ?? null;
       const tokenAddress = token.tokenAddress ?? token.mint ?? fallbackAddress;
       const isNative = tokenAddress == null;
-      const rawDecimals = token.decimals ?? metadata100?.decimals;
+      const rawDecimals = token.decimals ?? metadata104?.decimals;
       const decimals = typeof rawDecimals === "number" ? rawDecimals : isNative ? 18 : void 0;
       const balance = decodeBalance(
         token.balance ?? token.amount ?? token.tokenBalance ?? token.uiAmount ?? null,
         decimals
       );
       return {
-        symbol: token.symbol ?? metadata100?.symbol ?? token.tokenSymbol ?? (isNative ? NATIVE_SYMBOLS[chainLabel] ?? null : null),
-        name: token.name ?? metadata100?.name ?? null,
+        symbol: token.symbol ?? metadata104?.symbol ?? token.tokenSymbol ?? (isNative ? NATIVE_SYMBOLS[chainLabel] ?? null : null),
+        name: token.name ?? metadata104?.name ?? null,
         address: tokenAddress,
         balance,
-        usd_value: token.totalValueUsd ?? token.valueUsd ?? token.usd_value ?? (typeof token.totalValueUsdCents === "number" ? token.totalValueUsdCents / 100 : usdFromPrices(token, balance))
+        usd_value: token.totalValueUsd ?? token.valueUsd ?? token.usd_value ?? (typeof token.totalValueUsdCents === "number" ? token.totalValueUsdCents / 100 : usdFromPrices(token, balance)),
+        ...token.h24_change_pct != null ? { h24_change_pct: token.h24_change_pct } : {}
       };
     });
-    const held = summarized.filter(
+    const nonZero = summarized.filter(
       (token) => !isRecord3(token) || token.balance !== "0"
     );
+    const isSpam = (token) => isRecord3(token) && token.address != null && (SPAM_LURE.test(`${token.name ?? ""} ${token.symbol ?? ""}`) || priced && token.usd_value == null);
+    const held = includeSpam ? nonZero : nonZero.filter((t) => !isSpam(t));
+    const hidden = nonZero.length - held.length;
     return {
       address,
       chain: chainLabel,
       token_count: held.length,
+      ...hidden > 0 ? {
+        spam_hidden: {
+          count: hidden,
+          reason: priced ? "no market price, or a URL/claim lure in the name" : "a URL/claim lure in the name",
+          note: "Likely spam airdrops; pass include_spam=true to show them."
+        }
+      } : {},
       tokens: held.slice(0, MAX_CONCISE_TOKENS),
       ...held.length > MAX_CONCISE_TOKENS ? {
         note: `Showing the first ${MAX_CONCISE_TOKENS} of ${held.length} held tokens (zero balances omitted). Use response_format=detailed for the full provider payload.`
-      } : summarized.length > held.length ? {
-        note: `${summarized.length - held.length} zero-balance tokens omitted. Use response_format=detailed for the full provider payload.`
+      } : summarized.length > nonZero.length ? {
+        note: `${summarized.length - nonZero.length} zero-balance tokens omitted. Use response_format=detailed for the full provider payload.`
       } : {}
     };
   };
+  const coingeckoBalances = (payload) => {
+    const attributes = isRecord3(payload.data) && isRecord3(payload.data.attributes) ? payload.data.attributes : {};
+    const rows = Array.isArray(attributes.balances) ? attributes.balances : [];
+    const toNumber = (value) => value == null || !Number.isFinite(Number(value)) ? null : Number(value);
+    return {
+      total_value_usd: toNumber(attributes.total_value_usd),
+      balances: rows.filter(isRecord3).map((row) => ({
+        symbol: row.symbol ?? null,
+        name: row.name ?? null,
+        tokenAddress: row.token_type === "native" ? null : row.address ?? null,
+        balance: row.balance ?? null,
+        decimals: 0,
+        usd_value: toNumber(row.value_usd),
+        h24_change_pct: toNumber(row.h24_price_change_percentage)
+      }))
+    };
+  };
   const getWalletPortfolio = {
     metadata: {
       resource: "dynamic_tools",
@@ -59015,7 +60194,7 @@ function heroTools(endpoints, options = {}) {
     tool: {
       name: "get_wallet_portfolio",
       title: "Get Wallet Portfolio",
-      description: "Token holdings for a wallet with balances and USD values where available. EVM chains route through Alchemy; Solana wallets are detected automatically and route through Helius.",
+      description: `Token holdings for a wallet with balances, USD values, and 24h price change where available. Likely spam airdrops are hidden and counted (include_spam=true shows them). EVM chains route through CoinGecko (${WALLET_BALANCE_NETWORKS.join(", ")}) with Alchemy as the fallback; Solana wallets are detected automatically and route through Helius.`,
       inputSchema: zodToInputSchema(walletPortfolioSchema),
       outputSchema: heroOutputSchema("get_wallet_portfolio"),
       annotations: VOLATILE_READ_ANNOTATIONS
@@ -59031,20 +60210,43 @@ function heroTools(endpoints, options = {}) {
           `Invalid arguments: ${formatSchemaIssues(parsed.error)}`
         );
       }
-      const { address, chain } = parsed.data;
+      const { address, chain, include_spam: includeSpam } = parsed.data;
       const format = heroFormat(parsed.data.response_format);
       if (looksLikeNameService(address)) return nameServiceError(address);
       if (isSolanaChain(chain, address)) {
         const result3 = await executeUnderlying("helius_get_wallet_balances", {
           wallet: address
         }, "get_wallet_portfolio");
-        return respond(result3, format, trimWalletPortfolio(address, "solana"));
+        return respond(
+          result3,
+          format,
+          trimWalletPortfolio(address, "solana", includeSpam)
+        );
       }
       const normalized = normalizeChain(chain);
       const network = ALCHEMY_NETWORKS[normalized];
+      const geckoNetwork = GECKO_NETWORKS[normalized] ?? normalized;
+      let fallbackNote;
+      if (WALLET_BALANCE_NETWORKS.includes(geckoNetwork)) {
+        const result3 = await executeUnderlying("get_wallet_balances", {
+          address,
+          networks: geckoNetwork,
+          per_page: 100
+        }, "get_wallet_portfolio");
+        if (!network || "hive" in result3 && result3.ok) {
+          return respond(result3, format, (payload) => {
+            const balances = coingeckoBalances(payload);
+            return {
+              ...trimWalletPortfolio(address, normalized, includeSpam, true)(balances),
+              total_value_usd: balances.total_value_usd
+            };
+          });
+        }
+        fallbackNote = "CoinGecko wallet balances failed for this call; served from Alchemy.";
+      }
       if (!network) {
         return errorResult5(
-          `Invalid arguments: Unknown chain '${chain}'. Pass an EVM chain name (${Object.keys(ALCHEMY_NETWORKS).slice(0, 6).join(", ")}, \u2026) or "solana".`
+          `Invalid arguments: Unknown chain '${chain}'. Pass an EVM chain name (${Object.keys(ALCHEMY_NETWORKS).slice(0, 6).join(", ")}, \u2026), a CoinGecko network id (${WALLET_BALANCE_NETWORKS.join(", ")}), or "solana".`
         );
       }
       const result2 = await executeUnderlying("alchemy_get_tokens_by_wallet", {
@@ -59053,11 +60255,106 @@ function heroTools(endpoints, options = {}) {
         withMetadata: true,
         withPrices: true
       }, "get_wallet_portfolio");
-      return respond(result2, format, trimWalletPortfolio(address, normalized));
+      return respond(result2, format, (payload) => ({
+        ...trimWalletPortfolio(address, normalized, includeSpam, true)(payload),
+        ...fallbackNote ? { fallback_note: fallbackNote } : {}
+      }));
     }
   };
   return [getTokenPrice, checkTokenSafety, getWalletPortfolio];
 }
+var FLAG_VERDICTS = {
+  is_honeypot: "Honeypot: GoPlus says this token cannot be sold",
+  cannot_sell_all: "Holders cannot sell their whole balance",
+  hidden_owner: "The contract has a hidden owner",
+  can_take_back_ownership: "Ownership can be taken back after renouncing",
+  is_mintable: "The owner can mint more supply",
+  transfer_pausable: "Transfers can be paused",
+  is_blacklisted: "The contract can blacklist addresses",
+  owner_change_balance: "The owner can change balances",
+  selfdestruct: "The contract can self-destruct",
+  is_airdrop_scam: "GoPlus flags this as an airdrop scam"
+};
+function percentOf(value, fraction) {
+  const n = typeof value === "string" || typeof value === "number" ? Number(value) : NaN;
+  if (!Number.isFinite(n)) return null;
+  return Math.round((fraction ? n * 100 : n) * 1e3) / 1e3;
+}
+function holderView(holder) {
+  return {
+    address: holder.address ?? holder.account ?? null,
+    // Solana rows use account
+    percent: percentOf(holder.percent, true),
+    is_contract: holder.is_contract === 1 || holder.is_contract === "1",
+    is_locked: holder.is_locked === 1 || holder.is_locked === "1",
+    tag: holder.tag || null
+  };
+}
+function summarizeTokenSafety(entry2) {
+  const verdicts = [];
+  for (const [key, sentence] of Object.entries(FLAG_VERDICTS)) {
+    if (entry2[key] === "1") verdicts.push(sentence);
+  }
+  for (const side of ["buy", "sell"]) {
+    const tax = percentOf(entry2[`${side}_tax`], true);
+    if (tax !== null && tax >= 10) verdicts.push(`${side === "buy" ? "Buy" : "Sell"} tax is ${tax}%`);
+  }
+  const lpRows = Array.isArray(entry2.lp_holders) ? entry2.lp_holders.filter(isRecord3) : [];
+  let lp = null;
+  if (lpRows.length > 0) {
+    const views = lpRows.map(holderView);
+    const top = views.reduce((a, b) => (b.percent ?? 0) > (a.percent ?? 0) ? b : a);
+    const locked = views.reduce((sum, v) => sum + (v.is_locked ? v.percent ?? 0 : 0), 0);
+    lp = {
+      holder_count: entry2.lp_holder_count ?? lpRows.length,
+      locked_percent: Math.round(locked * 1e3) / 1e3,
+      top_holder: top
+    };
+    if (locked < 50 && !top.is_locked && (top.percent ?? 0) >= 50) {
+      verdicts.push(
+        `LP not locked: ${top.percent}% held by one ${top.is_contract ? "contract" : "EOA"}`
+      );
+    } else if (locked < 50) {
+      verdicts.push(`LP mostly unlocked: only ${Math.round(locked * 1e3) / 1e3}% of LP is locked`);
+    }
+  }
+  const holderRows = Array.isArray(entry2.holders) ? entry2.holders.filter(isRecord3) : [];
+  let topHolders = null;
+  if (holderRows.length > 0) {
+    const views = holderRows.map(holderView);
+    const pairs = new Set(
+      (Array.isArray(entry2.dex) ? entry2.dex.filter(isRecord3) : []).map((d) => String(d.pair ?? "").toLowerCase())
+    );
+    const owners = views.filter((v) => !pairs.has(String(v.address).toLowerCase()));
+    const top10 = owners.slice(0, 10).reduce((sum, v) => sum + (v.percent ?? 0), 0);
+    const largest = owners[0] ?? null;
+    topHolders = {
+      largest,
+      top10_percent: Math.round(top10 * 1e3) / 1e3,
+      excludes_dex_pairs: pairs.size > 0
+    };
+    if (largest && (largest.percent ?? 0) >= 20) {
+      verdicts.push(
+        `One address holds ${largest.percent}% of supply (${largest.is_contract ? "contract" : "EOA"}, ${largest.is_locked ? "locked" : "not locked"})`
+      );
+    }
+    if (top10 >= 50) verdicts.push(`Top 10 holders hold ${Math.round(top10 * 10) / 10}% of supply`);
+  }
+  const creator = entry2.creator_address ? {
+    address: entry2.creator_address,
+    balance: entry2.creator_balance ?? null,
+    percent: percentOf(entry2.creator_percent, true)
+  } : null;
+  const owner = entry2.owner_address ? {
+    address: entry2.owner_address,
+    balance: entry2.owner_balance ?? null,
+    percent: percentOf(entry2.owner_percent, true)
+  } : null;
+  for (const [label, who] of [["Creator", creator], ["Owner", owner]]) {
+    if (who && (who.percent ?? 0) >= 5) verdicts.push(`${label} still holds ${who.percent}% of supply`);
+  }
+  return { verdicts, lp, top_holders: topHolders, creator, owner };
+}
 function heroOutputSchema(name) {
   return HERO_TOOL_OUTPUT_SCHEMAS[name];
 }
@@ -59199,7 +60496,7 @@ var TASK_TOOLSET_ROUTES = {
           "holders",
           "Measure holder concentration with a bounded holder read.",
           "get_token_top_holders",
-          "moralis_get_token_holder_metrics",
+          "get_token_holder_distribution",
           PROVIDER_FALLBACK
         ),
         step(
@@ -59225,7 +60522,7 @@ var TASK_TOOLSET_ROUTES = {
         step(
           "balances",
           "Read current wallet value and balances.",
-          "moralis_get_wallet_net_worth",
+          "get_wallet_balances",
           "alchemy_get_token_balances_by_wallet",
           PROVIDER_FALLBACK
         ),
@@ -59264,7 +60561,7 @@ var TASK_TOOLSET_ROUTES = {
         step(
           "balances",
           "Anchor activity to the current wallet state.",
-          "moralis_get_wallet_net_worth",
+          "get_wallet_balances",
           "alchemy_get_native_balance",
           PROVIDER_FALLBACK
         ),
@@ -59359,15 +60656,14 @@ var TASK_TOOLSET_ROUTES = {
           "simulation",
           "Simulate execution without broadcasting.",
           "tenderly_simulate_transaction",
-          "alchemy_simulate_execution",
+          "tenderly_node_simulate_transaction",
           PROVIDER_FALLBACK
         ),
         step(
           "risk",
           "Inspect simulated asset changes.",
-          "alchemy_simulate_asset_changes",
           "simulate_evm_transaction",
-          PROVIDER_FALLBACK
+          null
         )
       ],
       stopCondition: "Stop after decoding, execution outcome, and asset effects are clear; never broadcast or mutate chain state."
@@ -60191,6 +61487,7 @@ var TASK_TOOLSET_CATALOG = [
     optionalIdentifiers: ["symbol", "pair address", "time range"],
     recommendedTools: [
       "get_token_top_holders",
+      "get_token_holder_distribution",
       "get_token_pools",
       "get_token_ohlcv",
       "get_token_info",
@@ -60242,18 +61539,18 @@ var TASK_TOOLSET_CATALOG = [
     requiredIdentifiers: ["wallet address", "chain"],
     optionalIdentifiers: ["token contract", "transaction hash", "time range"],
     recommendedTools: [
+      "get_wallet_balances",
+      "get_wallet_pnl",
+      "get_wallet_trades",
+      "get_wallet_transfers",
       "alchemy_get_tokens_by_wallet",
       "alchemy_get_token_balances_by_wallet",
       "alchemy_get_nfts_by_wallet",
       "alchemy_get_asset_transfers",
       "alchemy_get_native_balance",
       "moralis_get_wallet_history",
-      "moralis_get_wallet_token_balances",
-      "moralis_get_wallet_net_worth",
-      "moralis_get_wallet_profitability_summary",
       "moralis_get_wallet_defi_positions",
       "moralis_get_wallet_defi_summary",
-      "moralis_get_wallet_swaps",
       "moralis_get_wallet_chain_activity",
       "moralis_get_wallet_insight",
       "helius_get_wallet_balances",
@@ -60359,8 +61656,6 @@ var TASK_TOOLSET_CATALOG = [
       "alchemy_solana_get_compression_indexer_slot",
       "alchemy_solana_get_latest_compression_signatures",
       "alchemy_solana_get_latest_non_voting_signatures",
-      "alchemy_simulate_asset_changes",
-      "alchemy_simulate_execution",
       "simulate_evm_transaction",
       "defillama_get_hacks"
     ],
@@ -61590,7 +62885,11 @@ function getTaskOutputSchema(taskToolsetId) {
 }
 
 // src/services/execution-fallback.ts
-var FALLBACK_TRIGGER_STATUSES = /* @__PURE__ */ new Set(["failing", "missing_key"]);
+var FALLBACK_TRIGGER_STATUSES = /* @__PURE__ */ new Set([
+  "failing",
+  "missing_key",
+  "plan_required"
+]);
 function findRouteFallback(primaryToolName) {
   for (const toolset of TASK_TOOLSETS) {
     if (toolset.fallbackTools.length === 0) continue;
@@ -61633,9 +62932,7 @@ async function executeEndpointWithRouteFallback(endpoints, endpoint, args, conte
   const fallbackProviderStatus = getProviderRuntimeStatus(
     getProviderDescriptorForEndpoint(fallback)
   );
-  if (fallbackProviderStatus === "missing_key" || fallbackProviderStatus === "failing") {
-    return primary;
-  }
+  if (FALLBACK_TRIGGER_STATUSES.has(fallbackProviderStatus)) return primary;
   if (!argsMapCleanly(fallback, args)) return primary;
   const fallbackResult = await executeEndpoint(fallback, args, {
     ...context,
@@ -63033,7 +64330,7 @@ async function runMcpProtocolHealth(options = {}) {
     checks.push(
       await timedCheck("tools_list_root_surface", async () => {
         const listed = await client2.listTools();
-        const names = listed.tools.map((tool96) => tool96.name);
+        const names = listed.tools.map((tool100) => tool100.name);
         const expectedCount = getRootVisibleToolCount();
         const expectedTools = [...ROOT_VISIBLE_TOOL_NAMES];
         if (listed.tools.length !== expectedCount) {
@@ -64421,7 +65718,7 @@ async function runOAuthLifecycleHealth(overrides = {}) {
 }
 
 // src/health/selfTest.ts
-import Coingecko3 from "@coingecko/coingecko-typescript";
+import Coingecko4 from "@coingecko/coingecko-typescript";
 
 // src/tools/goplus/goplusClient.ts
 import { createHash as createHash8 } from "crypto";
@@ -65766,6 +67063,87 @@ var CCXTClient = class {
   }
 };
 
+// src/health/answerProbes.ts
+var ETH_WETH = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
+var ETH_PEPE = "0x6982508145454Ce325dDbE47a25d4ec3d2311933";
+function isRecord4(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function largestArray(value, depth = 0) {
+  if (Array.isArray(value)) return value;
+  if (!isRecord4(value) || depth > 4) return [];
+  let best = [];
+  for (const child of Object.values(value)) {
+    const candidate = largestArray(child, depth + 1);
+    if (candidate.length > best.length) best = candidate;
+  }
+  return best;
+}
+function rowsOf(payload) {
+  return isRecord4(payload) && Array.isArray(payload.rows) ? payload.rows : largestArray(payload);
+}
+function returnedCountMismatch(payload, rows) {
+  const returned = isRecord4(payload) ? payload.returnedCount : void 0;
+  return typeof returned === "number" && returned !== rows.length ? `returnedCount ${returned} != rows.length ${rows.length}` : null;
+}
+var ANSWER_PROBES = {
+  polymarket_search_markets: {
+    // The "JD Vance wins 2028" market resolves 2028-11-07; the event-level
+    // fixture in selfTest's TOOL_PROBE_ARGS points at the same market.
+    args: { query: "vance 2028", limit: 3 },
+    check: (payload) => {
+      const rows = rowsOf(payload);
+      if (rows.length === 0)
+        return "text search for 'vance 2028' found no markets";
+      const unmatched = rows.filter((row) => {
+        const text = JSON.stringify(row).toLowerCase();
+        return !text.includes("vance") || !text.includes("2028");
+      });
+      if (unmatched.length > 0) {
+        return `${unmatched.length} of ${rows.length} rows do not match every query term`;
+      }
+      return returnedCountMismatch(payload, rows);
+    }
+  },
+  get_token_top_holders: {
+    args: { network: "eth", address: ETH_WETH, limit: 20 },
+    check: (payload) => {
+      const holders = largestArray(payload);
+      return holders.length > 10 ? null : `asked for 20 WETH holders, got ${holders.length}`;
+    }
+  },
+  rwa_get_hyperliquid_dex_perps: {
+    args: { limit: 100 },
+    check: (payload) => {
+      const rows = rowsOf(payload);
+      if (rows.length === 0) return "no HIP-3 builder-dex rows";
+      return returnedCountMismatch(payload, rows);
+    }
+  },
+  // check_token_safety builds its LP verdict on this GoPlus read.
+  get_token_security: {
+    args: { chainId: "1", contract_addresses: ETH_PEPE },
+    check: (payload) => {
+      const result2 = isRecord4(payload) ? payload.result : void 0;
+      const token = isRecord4(result2) ? Object.values(result2).find(isRecord4) : void 0;
+      if (!token) return "no token entry in the GoPlus result";
+      const lpHolders = token.lp_holders;
+      return Array.isArray(lpHolders) && lpHolders.length > 0 ? null : "PEPE came back without lp_holders";
+    }
+  }
+};
+function checkAnswer(probe, result2) {
+  const text = isRecord4(result2) ? result2.content?.[0]?.text : void 0;
+  if (typeof text !== "string") return "response has no text content";
+  let payload;
+  try {
+    payload = JSON.parse(text);
+  } catch {
+    return "response is not JSON";
+  }
+  return probe.check(payload);
+}
+
 // src/health/selfTest.ts
 function positiveTimeout(name, fallbackMs) {
   const configured = Number(process.env[name]);
@@ -65779,7 +67157,7 @@ var QUICK_PROBE_TIMEOUT = Math.min(
 var ETH_WALLET = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
 var MORALIS_EVM_WALLET = "0xF977814e90dA44bFA03b6295A0616a897441aceC";
 var ETH_USDC = "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48";
-var ETH_WETH = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
+var ETH_WETH2 = "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2";
 var ETH_USDT = "0xdAC17F958D2ee523a2206206994597C13D831ec7";
 var ETH_BAYC = "0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D";
 var ETH_USDC_WETH_PAIR = "0xB4e16d0168e52d35CaCD2c6185b44281Ec28C9Dc";
@@ -65836,6 +67214,7 @@ var PROVIDER_RESOURCE_PATTERNS = [
   ["polymarket", /^polymarket(?:[.-]|$)/],
   ["alternative", /^signals-fear-greed$/],
   ["blockchain", /^signals-onchain/],
+  ["blockscout", /^blockscout(?:[.-]|$)/],
   ["fetch", /^fetch(?:[.-]|$)/],
   ["helius", /^helius\./],
   ["moralis", /^moralis\./],
@@ -65906,6 +67285,11 @@ var QUICK_PROBE_ARGS = {
     toolName: "signals_get_onchain_metrics",
     args: { metrics: ["hash_rate"], days: 1 }
   },
+  // One token read plus one holder page on Ethereum (keyless public host).
+  blockscout: {
+    toolName: "get_token_holder_distribution",
+    args: { network: "eth", address: ETH_USDC, max_pages: 1 }
+  },
   fetch: {
     toolName: "fetch_public_api",
     args: { host: "api.coingecko.com", path: "/api/v3/ping" }
@@ -65944,7 +67328,7 @@ var FULL_MODE_DEFAULT_ARGS = {
     vs_currency: "usd",
     vs_currencies: "usd",
     network: "eth",
-    address: ETH_WETH,
+    address: ETH_WETH2,
     days: "7"
   },
   defillama: {
@@ -66026,7 +67410,11 @@ var TOOL_PROBE_ARGS = {
   get_rwa_market_chart: { id: "gold", days: "7" },
   get_rwa_issuer: { id: "ondo-tokenized-assets" },
   // Polymarket fixtures verified live 2026-09-16; the event ends 2028-11-07.
-  polymarket_search_markets: { query: "election", limit: 3 },
+  get_token_holder_distribution: {
+    network: "eth",
+    address: ETH_USDC,
+    max_pages: 1
+  },
   polymarket_get_events: { slug: "presidential-election-winner-2028" },
   polymarket_get_market: {
     slug: "will-jd-vance-win-the-2028-us-presidential-election"
@@ -66210,6 +67598,10 @@ var TOOL_PROBE_ARGS = {
   },
   get_multi_tokens: { network: "eth", addresses: ETH_USDC },
   get_token_lists: { asset_platform_id: "ethereum" },
+  get_wallet_balances: { address: ETH_WALLET, networks: "eth", per_page: 5 },
+  get_wallet_pnl: { address: ETH_WALLET, networks: "eth", per_page: 5 },
+  get_wallet_trades: { network: "eth", address: ETH_WALLET, per_page: 5 },
+  get_wallet_transfers: { network: "eth", address: ETH_WALLET, per_page: 5 },
   coingecko_get_onchain_token_top_traders: {
     network: COINGECKO_TOP_TRADERS_NETWORK,
     address: COINGECKO_TOP_TRADERS_TOKEN,
@@ -67235,7 +68627,7 @@ function getClientForProvider(provider, clients) {
   }
 }
 function buildClients() {
-  const coinGeckoClient = new Coingecko3(getCoinGeckoClientOptions());
+  const coinGeckoClient = new Coingecko4(getCoinGeckoClientOptions());
   return {
     coinGeckoClient,
     goplusClient: new GoPlusClient(
@@ -67481,7 +68873,7 @@ async function getEffectiveProbeArgs(toolName, provider, clients, args) {
       return { [idFixture.field]: id };
     });
   }
-  const toolFixture = TOOL_PROBE_ARGS[toolName];
+  const toolFixture = ANSWER_PROBES[toolName]?.args ?? TOOL_PROBE_ARGS[toolName];
   if (toolFixture) return toolFixture;
   return projectArgsToToolSchema(
     FULL_MODE_DEFAULT_ARGS[provider] || {},
@@ -67573,6 +68965,16 @@ async function runEndpointProbe(endpoint, provider, clients, args, timeoutMs = P
           );
         }
       }
+      const answerProbe = args ? void 0 : ANSWER_PROBES[toolName];
+      const answerProblem = answerProbe ? checkAnswer(answerProbe, result2) : null;
+      if (answerProblem) {
+        return {
+          name: toolName,
+          status: "failed",
+          duration,
+          error: `Answer check failed: ${answerProblem}`
+        };
+      }
       return { name: toolName, status: "passed", duration };
     } catch (err) {
       const errorMsg = err instanceof Error ? err.message : "Unknown error";
@@ -68323,8 +69725,8 @@ var WORKFLOW_REGRESSION_CASES = [
     expectedTopToolset: "wallet_investigation",
     expectedToolsets: ["wallet_investigation"],
     expectedCategoryTool: "get_portfolio_wallet_endpoints",
-    expectedSchemaTool: "moralis_get_wallet_profitability_summary",
-    expectedProvider: "Moralis"
+    expectedSchemaTool: "get_wallet_pnl",
+    expectedProvider: "CoinGecko"
   },
   {
     id: "wallet-defi-pnl",
@@ -68343,8 +69745,8 @@ var WORKFLOW_REGRESSION_CASES = [
     expectedTopToolset: "wallet_investigation",
     expectedToolsets: ["wallet_investigation"],
     expectedCategoryTool: "get_portfolio_wallet_endpoints",
-    expectedSchemaTool: "moralis_get_wallet_swaps",
-    expectedProvider: "Moralis"
+    expectedSchemaTool: "get_wallet_trades",
+    expectedProvider: "CoinGecko"
   },
   {
     id: "malicious-address",
@@ -69627,6 +71029,11 @@ var TOOLSET_INTENT_HINTS = {
   ],
   security_risk: [
     "rugpull",
+    "rug pull",
+    "rug check",
+    "rugcheck",
+    "honeypot",
+    "scam",
     "safe to buy",
     "phishing",
     "malicious",
@@ -69986,6 +71393,9 @@ function catalogEntry(endpoint) {
     material: getMcpCreditCost(endpoint.tool.name) === 1,
     credit_cost: getMcpCreditCost(endpoint.tool.name),
     summary: summarizeToolDescription(endpoint.tool.description ?? ""),
+    // Ranking text: the summary minus its negative guidance, so "Not
+    // recommended for: ... holder info" never counts as a holder match.
+    rankText: summarizeToolDescription(endpoint.tool.description ?? "").split(/not recommended for:|don't use when:|common mistakes:/i)[0].toLowerCase(),
     searchText: [
       endpoint.tool.name,
       endpoint.tool.title ?? getToolTitle(endpoint.tool.name),
@@ -70004,7 +71414,11 @@ function catalogEntry(endpoint) {
   };
 }
 function publicCatalogEntry(entry2) {
-  const { searchText: _searchText, ...publicEntry } = entry2;
+  const {
+    searchText: _searchText,
+    rankText: _rankText,
+    ...publicEntry
+  } = entry2;
   return publicEntry;
 }
 function normalizeSearchToken(token) {
@@ -70044,31 +71458,36 @@ function matchesSearchTokens(haystack, query) {
   return tokens.some((token) => textMatchesSearchToken(haystack, token));
 }
 function queryMatchScore(entry2, query) {
-  if (!query) return 0;
+  if (!query) return { score: 0, direct: true };
   if (!matchesSearchTokens(entry2.searchText, query)) return null;
   const tokens = parseSearchTokens(query);
-  if (tokens.length === 0) return 0;
+  if (tokens.length === 0) return { score: 0, direct: true };
   const nameTitleText = [entry2.name, entry2.title].join(" ").toLowerCase();
+  const summaryText = entry2.rankText;
   const coreText = [
     entry2.name,
     entry2.title,
     entry2.category ?? "",
     entry2.provider,
-    entry2.summary
+    summaryText
   ].join(" ").toLowerCase();
   const nameTitleTokenSet = new Set(parseSearchTokens(nameTitleText));
   const coreTextTokenSet = new Set(parseSearchTokens(coreText));
+  const providerTokenSet = new Set(parseSearchTokens(entry2.provider));
+  let direct = false;
   const score = tokens.reduce((total, token) => {
     const exactToken = singularizeToken(normalizeSearchToken(token));
-    if (nameTitleTokenSet.has(exactToken)) return total + 24;
-    if (coreTextTokenSet.has(exactToken)) return total + 14;
-    if (textMatchesSearchToken(nameTitleText, token)) return total + 12;
-    if (textMatchesSearchToken(entry2.summary, token)) return total + 6;
-    if (textMatchesSearchToken(coreText, token)) return total + 4;
-    if (textMatchesSearchToken(entry2.searchText, token)) return total + 2;
+    const providerBonus = providerTokenSet.has(exactToken) ? 8 : 0;
+    const directScore = nameTitleTokenSet.has(exactToken) ? 24 : coreTextTokenSet.has(exactToken) ? 14 : nameTitleText.includes(exactToken) ? 12 : summaryText.includes(exactToken) ? 6 : coreText.includes(exactToken) ? 4 : 0;
+    if (directScore > 0) {
+      direct = true;
+      return total + directScore + providerBonus;
+    }
+    if (textMatchesSearchToken(coreText, token)) return total + 2;
+    if (textMatchesSearchToken(entry2.searchText, token)) return total + 1;
     return total;
   }, 0);
-  return score > 0 ? score : null;
+  return score > 0 ? { score, direct } : null;
 }
 function buildProviderByToolName(endpoints) {
   const providerByToolName = /* @__PURE__ */ new Map();
@@ -70147,6 +71566,26 @@ function selectToolsetRoutes(routes, query, routeId) {
   const positive = ranked.filter((item) => item.score > 0);
   return (positive.length > 0 ? positive : ranked).slice(0, 1).map((item) => item.route);
 }
+function promoteHealthyRouteFallbacks(route, availabilityForTool) {
+  let promoted = false;
+  const steps = route.steps.map((step2) => {
+    const primaryAvailability = availabilityForTool(step2.primaryTool);
+    const fallbackTool = step2.fallback.tool;
+    if (!isUnavailable(primaryAvailability) || !fallbackTool || isUnavailable(availabilityForTool(fallbackTool))) {
+      return step2;
+    }
+    promoted = true;
+    return {
+      ...step2,
+      primaryTool: fallbackTool,
+      fallback: {
+        tool: step2.primaryTool,
+        when: `Promoted fallback: ${step2.primaryTool} is ${primaryAvailability} right now and returns runtime_status, not data. Original fallback condition: ${step2.fallback.when}`
+      }
+    };
+  });
+  return promoted ? { ...route, steps } : route;
+}
 function publicRouteEntry(route) {
   return {
     id: route.id,
@@ -70160,9 +71599,11 @@ function publicRouteEntry(route) {
     stopCondition: route.stopCondition
   };
 }
-function publicToolsetEntry(entry2, detail, query, routeId) {
+function publicToolsetEntry(entry2, detail, query, routeId, availabilityForTool = () => "ok") {
   const routes = selectToolsetRoutes(entry2.routes, query, routeId).map(
-    publicRouteEntry
+    (route) => publicRouteEntry(
+      promoteHealthyRouteFallbacks(route, availabilityForTool)
+    )
   );
   const compact = {
     id: entry2.id,
@@ -70193,6 +71634,11 @@ function publicToolsetEntry(entry2, detail, query, routeId) {
 }
 function toolsetQueryMatchScore(entry2, query) {
   if (!query) return 0;
+  if (entry2.id === "solana_analysis" && /\b0x[0-9a-f]{40}\b|\b(ethereum|base|arbitrum|optimism|polygon|bsc|avalanche)\b/i.test(
+    query
+  ) && !/\b(solana|sol|spl|pump\.?fun|raydium|jupiter)\b/i.test(query)) {
+    return null;
+  }
   const haystack = [
     entry2.id,
     entry2.label,
@@ -70368,17 +71814,15 @@ function dynamicTools(endpoints, options = {}) {
       const filteredTools = catalogEntries.map((entry2, index) => ({
         entry: entry2,
         index,
-        score: routeId ? 100 : queryMatchScore(entry2, query)
-      })).filter((item) => item.score !== null).filter(
+        match: routeId ? { score: 100, direct: true } : queryMatchScore(entry2, query)
+      })).filter((item) => item.match !== null).filter(
         (item) => selectedRouteToolNames ? selectedRouteToolNames.has(item.entry.name) : true
       ).filter(
         (entry2) => provider ? entry2.entry.provider.toLowerCase() === provider : true
       ).filter(
         (entry2) => category ? entry2.entry.category?.toLowerCase() === category : true
       ).sort(
-        (a, b) => query ? b.score - a.score || a.index - b.index : a.index - b.index
-      ).sort(
-        (a, b) => Number(isUnavailable(availabilityFor(a.entry.provider))) - Number(isUnavailable(availabilityFor(b.entry.provider)))
+        (a, b) => Number(b.match.direct) - Number(a.match.direct) || Number(isUnavailable(availabilityFor(a.entry.provider))) - Number(isUnavailable(availabilityFor(b.entry.provider))) || (query ? b.match.score - a.match.score : 0) || a.index - b.index
       ).map((item) => item.entry);
       const filteredToolsets = taskToolsetCatalogEntries.map((entry2, index) => ({
         entry: entry2,
@@ -70432,7 +71876,8 @@ function dynamicTools(endpoints, options = {}) {
             entry2,
             parsed.detail ?? "compact",
             query,
-            routeId
+            routeId,
+            (toolName) => availabilityFor(providerByToolName.get(toolName) ?? "Hive")
           );
           const providerAvailability = Object.fromEntries(
             entry2.providers.map((name) => [
@@ -71258,7 +72703,7 @@ function getRootToolSet() {
       tools: Array.from(toolsByName.values()),
       visibleTools: ROOT_VISIBLE_TOOL_ORDER.map(
         (name) => compatibilityByName.get(name)
-      ).filter((tool96) => Boolean(tool96))
+      ).filter((tool100) => Boolean(tool100))
     };
     secureLogger.info("Root MCP tool catalog cached", {
       actualToolCount: actualToolEndpoints.length,
@@ -71306,7 +72751,7 @@ function getSharedClients() {
       );
     }
     sharedClients = {
-      coinGeckoClient: new Coingecko4(getCoinGeckoClientOptions()),
+      coinGeckoClient: new Coingecko5(getCoinGeckoClientOptions()),
       goplusClient,
       ccxtClient: new CCXTClient()
     };
@@ -71339,6 +72784,7 @@ function describeToolReference(toolName, endpointIndex) {
   };
 }
 function describeTaskToolset(toolset, endpointIndex) {
+  const availability = getProviderAvailabilitySnapshot().byProviderName;
   return {
     id: toolset.id,
     kind: toolset.kind,
@@ -71347,7 +72793,12 @@ function describeTaskToolset(toolset, endpointIndex) {
     outcome: toolset.outcome,
     requiredIdentifiers: toolset.requiredIdentifiers,
     optionalIdentifiers: toolset.optionalIdentifiers,
-    routes: toolset.routes,
+    routes: toolset.routes.map(
+      (route) => promoteHealthyRouteFallbacks(route, (toolName) => {
+        const endpoint = endpointIndex.get(toolName);
+        return endpoint ? availability[getProviderNameForTool(endpoint)] ?? "ok" : "ok";
+      })
+    ),
     coverageCatalog: {
       recommendedTools: toolset.recommendedTools.map(
         (toolName) => describeToolReference(toolName, endpointIndex)
@@ -71524,21 +72975,21 @@ var HiveMCPServer = class {
   }
   registerAllTools() {
     const registeredTools = this.scope.kind === "root" ? this.compatibilityToolEndpoints.map((endpoint) => endpoint.tool) : this.visibleTools;
-    for (const tool96 of registeredTools) {
-      const inputSchema = tool96.inputSchema;
+    for (const tool100 of registeredTools) {
+      const inputSchema = tool100.inputSchema;
       const inputZodSchema = memoizedJsonSchemaToZodInputSchema(inputSchema);
-      const outputSchema = tool96.outputSchema;
+      const outputSchema = tool100.outputSchema;
       const outputZodShape = outputSchema?.type === "object" ? memoizedJsonSchemaToZodOutputSchema(outputSchema) : void 0;
-      const toolName = tool96.name;
-      const toolMeta = tool96._meta;
+      const toolName = tool100.name;
+      const toolMeta = tool100._meta;
       this.server.registerTool(
         toolName,
         {
-          title: tool96.title,
-          description: tool96.description,
+          title: tool100.title,
+          description: tool100.description,
           inputSchema: inputZodSchema,
           ...outputZodShape && { outputSchema: outputZodShape },
-          annotations: tool96.annotations,
+          annotations: tool100.annotations,
           // Surfaces response-size headroom annotations (plan 1.15) in
           // SDK-generated tools/list responses.
           ...toolMeta && { _meta: toolMeta }