@noelclaw/mcp 1.5.6 → 2.1.0

package/dist/index.js

@@ -3,29 +3,84 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const server_js_1 = require("./server.js");
 const wallet_js_1 = require("./wallet.js");
-const BANNER = `
-\x1b[36m
-  ███╗   ██╗ ██████╗ ███████╗██╗      ██████╗██╗      █████╗ ██╗    ██╗
-  ████╗  ██║██╔═══██╗██╔════╝██║     ██╔════╝██║     ██╔══██╗██║    ██║
-  ██╔██╗ ██║██║   ██║█████╗  ██║     ██║     ██║     ███████║██║ █╗ ██║
-  ██║╚██╗██║██║   ██║██╔══╝  ██║     ██║     ██║     ██╔══██║██║███╗██║
-  ██║ ╚████║╚██████╔╝███████╗███████╗╚██████╗███████╗██║  ██║╚███╔███╔╝
-  ╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚══════╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝
-\x1b[0m  \x1b[90mcrypto AI · MCP · DeFi · research · swarm\x1b[0m
-`;
+// ── ANSI helpers ──────────────────────────────────────────────────────────────
+const C = {
+    cyan: "\x1b[36m",
+    dim: "\x1b[90m",
+    white: "\x1b[97m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+};
+const BANNER = `
+${C.cyan}
+  ███╗   ██╗ ██████╗ ███████╗██╗      ██████╗██╗      █████╗ ██╗    ██╗
+  ████╗  ██║██╔═══██╗██╔════╝██║     ██╔════╝██║     ██╔══██╗██║    ██║
+  ██╔██╗ ██║██║   ██║█████╗  ██║     ██║     ██║     ███████║██║ █╗ ██║
+  ██║╚██╗██║██║   ██║██╔══╝  ██║     ██║     ██║     ██╔══██║██║███╗██║
+  ██║ ╚████║╚██████╔╝███████╗███████╗╚██████╗███████╗██║  ██║╚███╔███╔╝
+  ╚═╝  ╚═══╝ ╚═════╝ ╚══════╝╚══════╝ ╚═════╝╚══════╝╚═╝  ╚═╝ ╚══╝╚══╝
+${C.reset}`;
+function line(label, value, color = C.cyan) {
+    const pad = " ".repeat(Math.max(0, 12 - label.length));
+    process.stderr.write(`  ${color}◆ ${label}${C.reset}${pad}${value}\n`);
+}
+function divider() {
+    process.stderr.write(`  ${C.dim}${"─".repeat(58)}${C.reset}\n`);
+}
 async function main() {
-    console.error(BANNER);
+    process.stderr.write(BANNER);
+    // ── Tool category counts ──────────────────────────────────────────────────
+    const categories = [
+        { label: "Market", count: 3, tools: "get_market_data · get_token_data · ask_noel" },
+        { label: "DeFi", count: 5, tools: "portfolio · swap · send · scan_wallet · estimate" },
+        { label: "Automation", count: 5, tools: "create · list · pause · delete · runs" },
+        { label: "Scanner", count: 3, tools: "scan_dips · score_token · check_token" },
+        { label: "Agents", count: 2, tools: "list_agents · hire_agent" },
+        { label: "Swarm", count: 6, tools: "start · stop · status · read_memory · write_memory · scores" },
+        { label: "Framework", count: 6, tools: "create_task · list_tasks · list_playbooks · run_playbook · ledger · sentinel" },
+        { label: "Vault", count: 7, tools: "save · read · list · search · history · diff · export" },
+        { label: "MiroShark", count: 3, tools: "simulate · status · stop" },
+        { label: "Wallet", count: 2, tools: "get_wallet_address · set_telegram" },
+        { label: "Social", count: 1, tools: "humanize_text" },
+        { label: "Coder", count: 6, tools: "scaffold_project · generate_component · generate_contract · audit_contract · explain_code · review_code" },
+        { label: "Base", count: 4, tools: "query_vaults · list_markets · prepare_deposit · chain_stats" },
+    ];
+    const total = server_js_1.ALL_TOOLS.length;
+    divider();
+    process.stderr.write(`\n`);
+    line("version", `v2.0.0  ${C.dim}MCP protocol 2.1.0${C.reset}`);
+    line("network", `Base mainnet  ${C.dim}via 0x Protocol · ethers v6${C.reset}`);
+    line("ai", `Bankr LLM  ${C.dim}grok-3 · llm.bankr.bot${C.reset}`);
+    line("tools", `${C.white}${C.bold}${total} tools loaded${C.reset}  ${C.dim}across ${categories.length} categories${C.reset}`);
+    process.stderr.write(`\n`);
+    divider();
+    process.stderr.write(`\n`);
+    // ── Categories grid ───────────────────────────────────────────────────────
+    for (const cat of categories) {
+        const countStr = `${cat.count}`.padStart(2);
+        process.stderr.write(`  ${C.dim}│${C.reset} ${C.cyan}${cat.label.padEnd(11)}${C.reset} ${C.dim}${countStr}x${C.reset}  ${C.dim}${cat.tools}${C.reset}\n`);
+    }
+    process.stderr.write(`\n`);
+    divider();
+    // ── Wallet ────────────────────────────────────────────────────────────────
     await (0, server_js_1.startServer)();
     try {
         const wallet = await (0, wallet_js_1.getOrCreateWallet)();
-        console.error(`\x1b[36m  ◆ wallet\x1b[0m  ${wallet.address}`);
-        console.error(`\x1b[36m  ◆ status\x1b[0m  ready · 34 tools loaded\n`);
+        process.stderr.write(`\n`);
+        line("wallet", wallet.address);
+        line("status", `${C.green}ready${C.reset}  ${C.dim}waiting for MCP client...${C.reset}`, C.green);
+        process.stderr.write(`\n`);
     }
-    catch (err) {
-        console.error(`[noelclaw] wallet init failed: ${err}`);
+    catch {
+        process.stderr.write(`\n`);
+        line("wallet", `${C.yellow}not configured${C.reset}  ${C.dim}run 'noelclaw-mcp' to init${C.reset}`, C.yellow);
+        line("status", `${C.green}ready${C.reset}  ${C.dim}wallet tools require setup${C.reset}`, C.green);
+        process.stderr.write(`\n`);
     }
 }
 main().catch((err) => {
-    console.error(err);
+    process.stderr.write(`[noelclaw] fatal: ${err}\n`);
     process.exit(1);
 });

package/dist/server.js

@@ -7,22 +7,23 @@ const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
 const convex_js_1 = require("./convex.js");
 const market_js_1 = require("./tools/market.js");
-const research_js_1 = require("./tools/research.js");
 const defi_js_1 = require("./tools/defi.js");
 const automation_js_1 = require("./tools/automation.js");
 const swarm_js_1 = require("./tools/swarm.js");
 const insight_js_1 = require("./tools/insight.js");
 const framework_js_1 = require("./tools/framework.js");
 const wallet_js_1 = require("./tools/wallet.js");
-const news_js_1 = require("./tools/news.js");
 const vault_js_1 = require("./tools/vault.js");
-const twitter_js_1 = require("./tools/twitter.js");
 const miroshark_js_1 = require("./tools/miroshark.js");
 const humanizer_js_1 = require("./tools/humanizer.js");
+const agents_js_1 = require("./tools/agents.js");
+const scanner_js_1 = require("./tools/scanner.js");
+const coder_js_1 = require("./tools/coder.js");
+const base_js_1 = require("./tools/base.js");
 const PRIVATE_KEY_RESPONSE = {
     content: [{
             type: "text",
-            text: "I don't have access to your private key. Your wallet is secured by Noelclaw's encrypted vault. Only you can manage it at noelclaw.xyz",
+            text: "I don't have access to your private key. Your wallet is secured by Noelclaw's encrypted vault. Only you can manage it at noelclaw.com",
         }],
 };
 function containsSensitiveRequest(args) {
@@ -33,18 +34,21 @@ function containsSensitiveRequest(args) {
         text.includes("privatekey"));
 }
 exports.ALL_TOOLS = [
-    ...market_js_1.MARKET_TOOLS, // 2 — market data, token data
+    ...market_js_1.MARKET_TOOLS, // 2 — get_market_data, get_token_data
     ...insight_js_1.INSIGHT_TOOLS, // 1 — ask_noel
-    ...defi_js_1.DEFI_TOOLS, // 2 — swap, send
-    ...automation_js_1.AUTOMATION_TOOLS, // 4 — create, list, pause, delete
-    ...swarm_js_1.SWARM_TOOLS, // 6 — start, stop, status, memory, scores
+    ...defi_js_1.DEFI_TOOLS, // 5 — get_portfolio, estimate_swap, swap_tokens, send_token, scan_wallet
+    ...automation_js_1.AUTOMATION_TOOLS, // 5 — create, list, pause, delete, get_runs
+    ...swarm_js_1.SWARM_TOOLS, // 6 — start, stop, status, read/write memory, scores
     ...framework_js_1.FRAMEWORK_TOOLS, // 6 — task packets, playbooks, sentinel, ledger
     ...vault_js_1.VAULT_TOOLS, // 7 — save, read, list, search, history, diff, export
-    ...wallet_js_1.WALLET_TOOLS, // 2 — wallet address, telegram connect
-    ...twitter_js_1.TWITTER_TOOLS, // 1 — post tweet
-    ...miroshark_js_1.MIROSHARK_TOOLS, // 2 — simulate, status
+    ...wallet_js_1.WALLET_TOOLS, // 2 — get_wallet_address, set_telegram
+    ...miroshark_js_1.MIROSHARK_TOOLS, // 3 — simulate, status, stop
     ...humanizer_js_1.HUMANIZER_TOOLS, // 1 — humanize_text
-    // total: 34
+    ...agents_js_1.AGENT_TOOLS, // 2 — list_agents, hire_agent
+    ...scanner_js_1.SCANNER_TOOLS, // 3 — score_token, check_token, scan_dips
+    ...coder_js_1.CODER_TOOLS, // 6 — scaffold_project, generate_component, generate_contract, audit_contract, explain_code, review_code
+    ...base_js_1.BASE_TOOLS, // 4 — query_vaults, list_markets, prepare_deposit, chain_stats
+    // total: 53
 ];
 exports.server = new index_js_1.Server({ name: "noelclaw", version: "2.1.0" }, { capabilities: { tools: {} } });
 exports.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({ tools: exports.ALL_TOOLS }));
@@ -54,8 +58,6 @@ exports.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (reques
         return PRIVATE_KEY_RESPONSE;
     try {
         const result = await (0, market_js_1.handleMarketTool)(name, args) ??
-            await (0, news_js_1.handleNewsTool)(name, args) ??
-            await (0, research_js_1.handleResearchTool)(name, args) ??
             await (0, defi_js_1.handleDefiTool)(name, args) ??
             await (0, automation_js_1.handleAutomationTool)(name, args) ??
             await (0, swarm_js_1.handleSwarmTool)(name, args) ??
@@ -63,9 +65,12 @@ exports.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (reques
             await (0, vault_js_1.handleVaultTool)(name, args) ??
             await (0, wallet_js_1.handleWalletTool)(name, args) ??
             await (0, insight_js_1.handleInsightTool)(name, args) ??
-            await (0, twitter_js_1.handleTwitterTool)(name, args) ??
             await (0, miroshark_js_1.handleMirosharkTool)(name, args) ??
-            await (0, humanizer_js_1.handleHumanizerTool)(name, args);
+            await (0, humanizer_js_1.handleHumanizerTool)(name, args) ??
+            await (0, agents_js_1.handleAgentTool)(name, args) ??
+            await (0, scanner_js_1.handleScannerTool)(name, args) ??
+            await (0, coder_js_1.handleCoderTool)(name, args) ??
+            await (0, base_js_1.handleBaseTool)(name, args);
         if (result)
             return result;
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };

package/dist/tools/agents.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AGENT_TOOLS = void 0;
+exports.handleAgentTool = handleAgentTool;
+const zod_1 = require("zod");
+const convex_js_1 = require("../convex.js");
+exports.AGENT_TOOLS = [
+    {
+        name: "list_agents",
+        description: "List all available specialist agents you can hire — built-in experts (analyst, risk-manager, researcher, executor, scout) plus any community-published agents.",
+        inputSchema: { type: "object", properties: {}, required: [] },
+    },
+    {
+        name: "hire_agent",
+        description: "Hire a specialist agent to complete a task. The agent runs immediately with its own expertise and returns a focused analysis or execution plan. Use list_agents first to see what's available.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                agentId: {
+                    type: "string",
+                    description: "Agent ID from list_agents. Built-in: analyst, risk-manager, researcher, executor, scout. Or a custom agent ID.",
+                },
+                task: {
+                    type: "string",
+                    description: "The task or question for the agent. Be specific — better input = better output.",
+                },
+                maxTokens: {
+                    type: "number",
+                    description: "Max response tokens (default 800, max 1200). Lower is faster and cheaper.",
+                },
+            },
+            required: ["agentId", "task"],
+        },
+    },
+];
+const HireAgentSchema = zod_1.z.object({
+    agentId: zod_1.z.string().min(1),
+    task: zod_1.z.string().min(1),
+    maxTokens: zod_1.z.number().int().min(100).max(1200).optional(),
+});
+async function handleAgentTool(name, args) {
+    if (name === "list_agents") {
+        const data = await (0, convex_js_1.callConvex)("/agents/list", "GET", undefined, "list_agents");
+        const agents = data.agents ?? [];
+        const lines = agents.map((a) => {
+            const badge = a.pricingType === "free" ? "free" : "token-based";
+            const runs = a.runs != null ? ` · ${a.runs} runs` : "";
+            return `**${a.name}** (\`${a.id}\`) [${badge}${runs}]\n  ${a.description}`;
+        });
+        return {
+            content: [{
+                    type: "text",
+                    text: `## Available Agents (${agents.length})\n\n${lines.join("\n\n")}`,
+                }],
+        };
+    }
+    if (name === "hire_agent") {
+        const parsed = HireAgentSchema.safeParse(args);
+        if (!parsed.success) {
+            return {
+                content: [{ type: "text", text: `Invalid input: ${parsed.error.issues[0].message}` }],
+                isError: true,
+            };
+        }
+        const { agentId, task, maxTokens } = parsed.data;
+        const data = await (0, convex_js_1.callConvex)("/agents/hire", "POST", { agentId, task, maxTokens }, "hire_agent");
+        if (data.error) {
+            return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
+        }
+        const footer = data.tokensUsed ? `\n\n*Tokens used: ${data.tokensUsed}*` : "";
+        return {
+            content: [{
+                    type: "text",
+                    text: `## ${data.agent ?? agentId} — Response\n\n${data.result}${footer}`,
+                }],
+        };
+    }
+    return null;
+}

package/dist/tools/automation.js

@@ -37,9 +37,22 @@ exports.AUTOMATION_TOOLS = [
             required: ["automationId"],
         },
     },
+    {
+        name: "get_automation_runs",
+        description: "Get the execution history for an automation — each run's status (success/failed/skipped), amount spent, tx hash, and error message if any. Useful for debugging why an automation isn't working.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                automationId: { type: "string", description: "Automation ID (from list_automations)" },
+                limit: { type: "number", description: "Max runs to return (default 20)" },
+            },
+            required: ["automationId"],
+        },
+    },
 ];
 const CreateAutomationSchema = zod_1.z.object({ rawInput: zod_1.z.string().min(1) });
 const AutomationIdSchema = zod_1.z.object({ automationId: zod_1.z.string().min(1) });
+const RunsSchema = zod_1.z.object({ automationId: zod_1.z.string().min(1), limit: zod_1.z.number().int().min(1).max(100).optional() });
 async function handleAutomationTool(name, args) {
     switch (name) {
         case "create_automation": {
@@ -110,6 +123,31 @@ async function handleAutomationTool(name, args) {
                 return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
             return { content: [{ type: "text", text: "🗑️ Automation deleted." }] };
         }
+        case "get_automation_runs": {
+            const parsed = RunsSchema.safeParse(args);
+            if (!parsed.success)
+                return { content: [{ type: "text", text: `Invalid input: automationId ${parsed.error.issues[0].message}` }], isError: true };
+            const { automationId, limit = 20 } = parsed.data;
+            const qs = `automationId=${encodeURIComponent(automationId)}&limit=${limit}`;
+            const data = await (0, convex_js_1.callConvex)(`/automations/runs?${qs}`, "GET", undefined, "get_automation_runs");
+            if (data.error)
+                return { content: [{ type: "text", text: `Error: ${data.error}` }], isError: true };
+            const runs = data.runs ?? [];
+            if (!runs.length)
+                return { content: [{ type: "text", text: "No runs yet for this automation." }] };
+            const statusIcon = { success: "✅", failed: "❌", skipped: "⏭️" };
+            const lines = [`**Run History** (${runs.length} shown)`, ""];
+            for (const r of runs) {
+                const icon = statusIcon[r.status] ?? "•";
+                const time = new Date(r.triggeredAt).toUTCString();
+                const spent = r.amountUsd != null ? ` · $${Number(r.amountUsd).toFixed(2)}` : "";
+                const tx = r.txHash ? ` · [tx](https://basescan.org/tx/${r.txHash})` : "";
+                lines.push(`${icon} **${r.status}**${spent}${tx} — ${time}`);
+                if (r.error)
+                    lines.push(`   ⚠️ ${r.error}`);
+            }
+            return { content: [{ type: "text", text: lines.join("\n") }] };
+        }
         default:
             return null;
     }

package/dist/tools/base.js

@@ -0,0 +1,261 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BASE_TOOLS = void 0;
+exports.handleBaseTool = handleBaseTool;
+const MORPHO_API = "https://blue-api.morpho.org/graphql";
+const MOONWELL_API = "https://api.moonwell.fi/v1/markets";
+exports.BASE_TOOLS = [
+    {
+        name: "base_query_vaults",
+        description: "List Morpho yield vaults on Base sorted by APY. Shows vault name, asset, current APY, and total deposits. Use this to find the best yield opportunities on Base.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                asset: {
+                    type: "string",
+                    description: "Filter by asset symbol (e.g. USDC, WETH, cbBTC). Leave empty for all.",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max vaults to return (default 10)",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "base_list_markets",
+        description: "List Moonwell lending/borrowing markets on Base. Shows supply APY, borrow APY, total liquidity, and utilization rate for each asset.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                asset: {
+                    type: "string",
+                    description: "Filter by asset symbol (e.g. USDC, ETH, cbBTC). Leave empty for all.",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "base_prepare_deposit",
+        description: "Get deposit instructions for a Morpho vault — shows the vault address, expected APY, and step-by-step instructions. Does NOT execute the transaction.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                vaultName: {
+                    type: "string",
+                    description: "Name or partial name of the vault (e.g. 'Gauntlet USDC', 'steakUSDC')",
+                },
+                amount: {
+                    type: "string",
+                    description: "Amount to deposit (e.g. '100', '1000')",
+                },
+                asset: {
+                    type: "string",
+                    description: "Asset to deposit (e.g. USDC, WETH)",
+                },
+            },
+            required: ["asset", "amount"],
+        },
+    },
+    {
+        name: "base_chain_stats",
+        description: "Get real-time Base chain stats: ETH price, gas price in gwei, and latest block info.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+            required: [],
+        },
+    },
+];
+// ── Helpers ────────────────────────────────────────────────────────────────────
+function fmt(n, decimals = 2) {
+    if (n >= 1000000000)
+        return `$${(n / 1000000000).toFixed(1)}B`;
+    if (n >= 1000000)
+        return `$${(n / 1000000).toFixed(1)}M`;
+    if (n >= 1000)
+        return `$${(n / 1000).toFixed(1)}K`;
+    return `$${n.toFixed(decimals)}`;
+}
+function pct(n) {
+    return `${(n * 100).toFixed(2)}%`;
+}
+// ── Morpho vaults ─────────────────────────────────────────────────────────────
+async function fetchMorphoVaults(asset, limit = 10) {
+    const gql = `{
+    vaults(
+      where: { chainId_in: [8453] }
+      orderBy: "state_netApy"
+      orderDirection: "desc"
+      first: 50
+    ) {
+      items {
+        name
+        address
+        asset { symbol name }
+        state { apy netApy totalAssetsUsd }
+      }
+    }
+  }`;
+    const res = await fetch(MORPHO_API, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ query: gql }),
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!res.ok)
+        throw new Error(`Morpho API error: ${res.status}`);
+    const data = await res.json();
+    let vaults = data?.data?.vaults?.items ?? [];
+    if (asset) {
+        vaults = vaults.filter((v) => v.asset?.symbol?.toLowerCase().includes(asset.toLowerCase()));
+    }
+    vaults = vaults.slice(0, limit);
+    if (!vaults.length)
+        return "No vaults found for that asset.";
+    const lines = vaults.map((v, i) => {
+        const apy = pct(v.state?.netApy ?? v.state?.apy ?? 0);
+        const tvl = fmt(v.state?.totalAssetsUsd ?? 0);
+        const addr = `${v.address?.slice(0, 6)}...${v.address?.slice(-4)}`;
+        return `${i + 1}. ${v.name}\n   Asset: ${v.asset?.symbol}  APY: ${apy}  TVL: ${tvl}\n   Address: ${addr}`;
+    });
+    return `Morpho Vaults on Base (sorted by APY):\n\n${lines.join("\n\n")}`;
+}
+// ── Moonwell markets ───────────────────────────────────────────────────────────
+async function fetchMoonwellMarkets(asset) {
+    const res = await fetch(`${MOONWELL_API}?network=base`, {
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!res.ok)
+        throw new Error(`Moonwell API error: ${res.status}`);
+    const data = await res.json();
+    let markets = data?.data ?? data?.markets ?? [];
+    if (asset) {
+        markets = markets.filter((m) => (m.underlyingSymbol ?? m.symbol ?? "").toLowerCase().includes(asset.toLowerCase()));
+    }
+    if (!markets.length)
+        return "No markets found.";
+    const lines = markets.slice(0, 15).map((m, i) => {
+        const symbol = m.underlyingSymbol ?? m.symbol ?? "?";
+        const supplyApy = pct((m.supplyApy ?? m.supplyRate ?? 0));
+        const borrowApy = pct((m.borrowApy ?? m.borrowRate ?? 0));
+        const liquidity = fmt(m.totalSupplyUsd ?? m.totalSupply ?? 0);
+        const util = m.utilization != null ? `${(m.utilization * 100).toFixed(1)}%` : "—";
+        return `${i + 1}. ${symbol}\n   Supply APY: ${supplyApy}  Borrow APY: ${borrowApy}  Liquidity: ${liquidity}  Util: ${util}`;
+    });
+    return `Moonwell Markets on Base:\n\n${lines.join("\n\n")}`;
+}
+// ── Base chain stats ───────────────────────────────────────────────────────────
+async function fetchBaseStats() {
+    const rpc = "https://mainnet.base.org";
+    const [blockRes, priceRes, gasRes] = await Promise.all([
+        fetch(rpc, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 1, method: "eth_blockNumber", params: [] }),
+            signal: AbortSignal.timeout(8000),
+        }).then(r => r.json()).catch(() => null),
+        fetch("https://api.coingecko.com/api/v3/simple/price?ids=ethereum&vs_currencies=usd", {
+            signal: AbortSignal.timeout(8000),
+        }).then(r => r.json()).catch(() => null),
+        fetch(rpc, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", id: 2, method: "eth_gasPrice", params: [] }),
+            signal: AbortSignal.timeout(8000),
+        }).then(r => r.json()).catch(() => null),
+    ]);
+    const block = blockRes?.result ? parseInt(blockRes.result, 16) : "—";
+    const ethPrice = priceRes?.ethereum?.usd ?? "—";
+    const gasPriceGwei = gasRes?.result
+        ? (parseInt(gasRes.result, 16) / 1e9).toFixed(4)
+        : "—";
+    return `Base Chain Stats:\n\n• ETH Price: $${ethPrice}\n• Gas Price: ${gasPriceGwei} gwei\n• Latest Block: ${block.toLocaleString()}\n• Network: Base Mainnet (Chain ID 8453)`;
+}
+// ── Prepare deposit info ───────────────────────────────────────────────────────
+async function prepareDeposit(vaultName, asset, amount) {
+    const gql = `{
+    vaults(
+      where: { chainId_in: [8453] }
+      orderBy: "state_netApy"
+      orderDirection: "desc"
+      first: 100
+    ) {
+      items {
+        name
+        address
+        asset { symbol name }
+        state { netApy apy totalAssetsUsd }
+      }
+    }
+  }`;
+    const res = await fetch(MORPHO_API, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ query: gql }),
+        signal: AbortSignal.timeout(15000),
+    });
+    if (!res.ok)
+        throw new Error(`Morpho API error: ${res.status}`);
+    const data = await res.json();
+    let vaults = data?.data?.vaults?.items ?? [];
+    // Filter by asset first
+    vaults = vaults.filter((v) => v.asset?.symbol?.toLowerCase() === asset.toLowerCase());
+    // Filter by vault name if provided
+    if (vaultName) {
+        const match = vaults.find((v) => v.name?.toLowerCase().includes(vaultName.toLowerCase()));
+        if (match)
+            vaults = [match];
+    }
+    // Take best APY vault
+    const vault = vaults[0];
+    if (!vault) {
+        return `No Morpho vault found for ${asset} on Base. Try base_query_vaults to see available vaults.`;
+    }
+    const apy = pct(vault.state?.netApy ?? vault.state?.apy ?? 0);
+    const tvl = fmt(vault.state?.totalAssetsUsd ?? 0);
+    return [
+        `Morpho Vault Deposit Instructions`,
+        ``,
+        `Vault: ${vault.name}`,
+        `Asset: ${vault.asset?.symbol}`,
+        `APY: ${apy}  |  TVL: ${tvl}`,
+        `Contract: ${vault.address}`,
+        ``,
+        `Steps to deposit ${amount} ${asset}:`,
+        `1. Go to app.morpho.org or use the vault address above`,
+        `2. Connect your wallet (ensure you have ${amount} ${asset})`,
+        `3. Approve the vault contract to spend your ${asset}`,
+        `4. Call deposit(${amount}, yourAddress) on the vault contract`,
+        `5. You'll receive vault shares representing your deposit`,
+        ``,
+        `Expected yield: ~${apy} on ${amount} ${asset}`,
+        `Note: APY is variable and changes based on market conditions.`,
+    ].join("\n");
+}
+// ── Handler ────────────────────────────────────────────────────────────────────
+async function handleBaseTool(name, args) {
+    const a = (args ?? {});
+    switch (name) {
+        case "base_query_vaults": {
+            const text = await fetchMorphoVaults(a.asset, a.limit ?? 10);
+            return { content: [{ type: "text", text }] };
+        }
+        case "base_list_markets": {
+            const text = await fetchMoonwellMarkets(a.asset);
+            return { content: [{ type: "text", text }] };
+        }
+        case "base_prepare_deposit": {
+            const text = await prepareDeposit(a.vaultName, a.asset, a.amount);
+            return { content: [{ type: "text", text }] };
+        }
+        case "base_chain_stats": {
+            const text = await fetchBaseStats();
+            return { content: [{ type: "text", text }] };
+        }
+        default:
+            return null;
+    }
+}