@blockrun/mcp 0.19.2 → 0.21.0

package/README.md

@@ -132,10 +132,10 @@ $5 covers ~5,000 market queries, ~500 Exa searches, ~250 image generations, or ~
 
 | Tool | Data source | Cost |
 |------|-------------|------|
-| `blockrun_chat` | 55+ LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K2.6, GLM, NVIDIA free tier, ...) with `mode` tier routing | per token |
-| `blockrun_image` | DALL-E 3, GPT Image 1/2, Grok Imagine, Flux, CogView-4, Nano Banana — generation + editing | $0.015–0.12 |
-| `blockrun_video` | xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0/2.0-fast (720p + audio defaults); RealFace asset → real-person video | $0.05–0.298/sec |
-| `blockrun_realface` | Enroll a real person (phone liveness → `ta_xxxx` asset) for Seedance 2.0 real-person video | free; $0.01 to enroll |
+| `blockrun_chat` | 66+ LLMs (GPT, Claude, Gemini, DeepSeek, Kimi K2.6, GLM, NVIDIA free tier, ...) with `mode` tier routing | per token |
+| `blockrun_image` | GPT Image 1/2, Nano Banana / Pro (up to 4K), Grok Imagine, CogView-4 — generation + img2img editing | $0.015–0.15 |
+| `blockrun_video` | Sora 2 + xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0/2.0-fast (720p + audio defaults); RealFace asset → real-person video | $0.05–0.30/sec |
+| `blockrun_realface` | Enroll a real person (phone liveness) or an AI character (Virtual Portrait, no liveness) as a `ta_xxxx` asset for Seedance 2.0 video | free; $0.01 to enroll |
 | `blockrun_music` | MiniMax music generation | per track |
 | `blockrun_speech` | ElevenLabs text-to-speech (Flash/Turbo/Multilingual/v3, 8 voice aliases) + cinematic sound effects; free voice listing | $0.05–0.10/1k chars; $0.0525/effect |
 | `blockrun_price` | Pyth-backed realtime + OHLC — crypto / FX / commodity (free), 12 stock markets (paid) | free or $0.001/call |
@@ -144,6 +144,10 @@ $5 covers ~5,000 market queries, ~500 Exa searches, ~250 image generations, or ~
 | `blockrun_exa` | Neural web search (Exa) — research, competitors, papers, URL content | $0.01/query |
 | `blockrun_search` | Grok Live Search — web + news with citations | $0.025 × max_results (default 10) |
 | `blockrun_dex` | Live DEX prices via DexScreener | free |
+| `blockrun_rpc` | Raw JSON-RPC on 40+ chains (Ethereum, Base, Solana, Bitcoin, Sui, NEAR, ...) via Tatum gateway — eth_call, balances, blocks, logs | $0.002/call |
+| `blockrun_defi` | DefiLlama — protocol TVL, chain TVL, yield pools (APY), token prices | $0.001–0.005/call |
+| `blockrun_modal` | Isolated code execution in a BlockRun-hosted Modal sandbox — disposable container, optional GPU (T4 → H100) | $0.01 create; $0.001/op |
+| `blockrun_phone` | Outbound AI voice calls (Bland) + wallet-owned US/CA numbers (Twilio), carrier + fraud lookups | $0.54/call; $5/number |
 | `blockrun_models` | Live catalogue of every LLM/image/video/music model + pricing | free |
 | `blockrun_wallet` | Balance, spending, agent budgets, setup QR | free |
 

package/dist/index.js

@@ -1092,13 +1092,39 @@ var GENERATE_MODEL_COST = {
   "zai/cogview-4": 0.015,
   "xai/grok-imagine-image": 0.02,
   "xai/grok-imagine-image-pro": 0.07,
+  "openai/gpt-image-1": 0.02,
+  "openai/gpt-image-2": 0.06,
+  "google/nano-banana": 0.05,
+  "google/nano-banana-pro": 0.1
+};
+var LARGE_SIZE_COST = {
   "openai/gpt-image-1": 0.04,
   "openai/gpt-image-2": 0.12,
-  "openai/dall-e-3": 0.08,
-  "google/nano-banana": 0.05,
-  "together/flux-schnell": 3e-3
+  "google/nano-banana-pro": 0.15
+  // 4096x4096 tier
 };
-var EDIT_MODELS = /* @__PURE__ */ new Set(["openai/gpt-image-1", "openai/gpt-image-2"]);
+var EDIT_MODELS = /* @__PURE__ */ new Set([
+  "openai/gpt-image-1",
+  "openai/gpt-image-2",
+  "google/nano-banana",
+  "google/nano-banana-pro"
+]);
+var IMAGE_MODELS = [
+  "zai/cogview-4",
+  "google/nano-banana",
+  "google/nano-banana-pro",
+  "openai/gpt-image-1",
+  "openai/gpt-image-2",
+  "xai/grok-imagine-image",
+  "xai/grok-imagine-image-pro"
+];
+function estimateCost(model, size) {
+  const base = GENERATE_MODEL_COST[model] ?? 0.06;
+  if (size !== "1024x1024" && LARGE_SIZE_COST[model]) {
+    return LARGE_SIZE_COST[model];
+  }
+  return base;
+}
 function registerImageTool(server, budget) {
   server.registerTool(
     "blockrun_image",
@@ -1109,21 +1135,22 @@ Actions:
 - generate (default): Create image from text prompt
 - edit: Transform an existing image using img2img
 
-Generation models:
-- zai/cogview-4 ($0.015) \u2014 Zhipu CogView-4, photorealistic, great for detailed scenes
-- xai/grok-imagine-image ($0.02) \u2014 xAI Grok Imagine, stylized, fast
-- xai/grok-imagine-image-pro ($0.07) \u2014 xAI Grok Imagine Pro, higher quality
-- openai/gpt-image-1 ($0.02-0.04) \u2014 GPT native image generation
-- openai/gpt-image-2 ($0.06-0.12) \u2014 ChatGPT Images 2.0, reasoning-driven, multilingual text rendering + character consistency
-- openai/dall-e-3 ($0.04-0.08) \u2014 High quality, prompt adherence
-- google/nano-banana ($0.05) \u2014 Google image model
-Edit models: openai/gpt-image-1, openai/gpt-image-2 (default for edits)`,
+Generation models (1024x1024 base price; larger sizes cost more on gpt-image-*):
+- openai/gpt-image-2 ($0.06\u20130.12) \u2014 flagship, reasoning-driven, multilingual on-image text + character consistency (default)
+- openai/gpt-image-1 ($0.02\u20130.04) \u2014 GPT native image generation
+- google/nano-banana ($0.05) \u2014 Gemini-family image model
+- google/nano-banana-pro ($0.10; $0.15 at 4096px) \u2014 up to 4K, strongest photorealism
+- xai/grok-imagine-image ($0.02) \u2014 stylized, fast
+- xai/grok-imagine-image-pro ($0.07) \u2014 higher quality Grok Imagine
+- zai/cogview-4 ($0.015) \u2014 cheapest, photorealistic detailed scenes
+
+Edit (img2img) models: openai/gpt-image-2 (default), openai/gpt-image-1, google/nano-banana, google/nano-banana-pro`,
       inputSchema: {
         prompt: z4.string().describe("Image description or edit instructions"),
         action: z4.enum(["generate", "edit"]).optional().default("generate").describe("generate: create from text; edit: transform existing image"),
-        model: z4.enum(["zai/cogview-4", "openai/dall-e-3", "together/flux-schnell", "google/nano-banana", "openai/gpt-image-1", "openai/gpt-image-2", "xai/grok-imagine-image", "xai/grok-imagine-image-pro"]).optional().describe("Model to use (default: dall-e-3 for generate, gpt-image-2 for edit). xai/grok-imagine-image is stylized and fast; xai/grok-imagine-image-pro is higher quality; gpt-image-2 is the newest edit-capable model with stronger instruction following."),
+        model: z4.enum(IMAGE_MODELS).optional().describe("Model to use (default: openai/gpt-image-2 for both generate and edit). gpt-image-2 renders on-image text best; nano-banana-pro for 4K photorealism; cogview-4 / grok-imagine-image for cheap drafts."),
         image: z4.string().optional().describe("Source image for edit action: base64-encoded image or URL"),
-        size: z4.enum(["1024x1024", "1792x1024", "1024x1792"]).optional().default("1024x1024"),
+        size: z4.string().optional().default("1024x1024").describe("Image size. Common values: 1024x1024 (all models), 1536x1024 / 1024x1536 (gpt-image-*), 2048x2048 / 4096x4096 (nano-banana-pro)"),
         quality: z4.enum(["standard", "hd"]).optional().default("standard"),
         agent_id: z4.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
@@ -1136,6 +1163,7 @@ Edit models: openai/gpt-image-1, openai/gpt-image-2 (default for edits)`,
             isError: true
           };
         }
+        const selectedModel = model || "openai/gpt-image-2";
         let response;
         if (action === "edit") {
           if (!image) {
@@ -1144,14 +1172,13 @@ Edit models: openai/gpt-image-1, openai/gpt-image-2 (default for edits)`,
               isError: true
             };
           }
-          const selectedModel = model || "openai/gpt-image-2";
           if (!EDIT_MODELS.has(selectedModel)) {
             return {
-              content: [{ type: "text", text: formatError("Image edits support only openai/gpt-image-1 or openai/gpt-image-2") }],
+              content: [{ type: "text", text: formatError("Image edits support openai/gpt-image-1, openai/gpt-image-2, google/nano-banana, or google/nano-banana-pro") }],
               isError: true
             };
           }
-          const estimatedCost = selectedModel === "openai/gpt-image-2" ? 0.12 : 0.04;
+          const estimatedCost = estimateCost(selectedModel, size);
           const budgetCheck = checkBudget(budget, agent_id, estimatedCost);
           if (!budgetCheck.allowed) {
             return {
@@ -1165,8 +1192,7 @@ Edit models: openai/gpt-image-1, openai/gpt-image-2 (default for edits)`,
           });
           recordSpending(budget, estimatedCost, agent_id);
         } else {
-          const selectedModel = model || "openai/dall-e-3";
-          const estimatedCost = GENERATE_MODEL_COST[selectedModel] ?? 0.05;
+          const estimatedCost = estimateCost(selectedModel, size);
           const budgetCheck = checkBudget(budget, agent_id, estimatedCost);
           if (!budgetCheck.allowed) {
             return {
@@ -1191,8 +1217,8 @@ Edit models: openai/gpt-image-1, openai/gpt-image-2 (default for edits)`,
         return {
           content: [{ type: "text", text: `Image: ${imageUrl}
 Prompt: ${prompt}
-Model: ${action === "edit" ? model || "openai/gpt-image-2" : model || "openai/dall-e-3"}` }],
-          structuredContent: { url: imageUrl, prompt, model: action === "edit" ? model || "openai/gpt-image-2" : model || "openai/dall-e-3" }
+Model: ${selectedModel}` }],
+          structuredContent: { url: imageUrl, prompt, model: selectedModel }
         };
       } catch (err) {
         const errMsg = err instanceof Error ? err.message : String(err);
@@ -1881,6 +1907,46 @@ async function fetchWithTimeout4(url, options, timeoutMs) {
     clearTimeout(id);
   }
 }
+async function payAndPostJson(url, reqBody, fallbackDescription) {
+  const privateKey = getOrCreateWalletKey();
+  const account = privateKeyToAccount4(privateKey);
+  const resp402 = await fetchWithTimeout4(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: reqBody
+  }, 15e3);
+  if (resp402.status !== 402) {
+    const data2 = await resp402.json().catch(() => ({}));
+    throw new Error(`Expected 402, got ${resp402.status}: ${data2.message || data2.error || JSON.stringify(data2)}`);
+  }
+  const prHeader = resp402.headers.get("payment-required") || resp402.headers.get("PAYMENT-REQUIRED");
+  if (!prHeader) throw new Error("No PAYMENT-REQUIRED header in 402 response");
+  const paymentRequired = parsePaymentRequired4(prHeader);
+  const details = extractPaymentDetails4(paymentRequired);
+  const paymentPayload = await createPaymentPayload4(
+    privateKey,
+    account.address,
+    details.recipient,
+    details.amount,
+    details.network || "eip155:8453",
+    {
+      resourceUrl: details.resource?.url || url,
+      resourceDescription: details.resource?.description || fallbackDescription,
+      maxTimeoutSeconds: Math.max(details.maxTimeoutSeconds || 0, 120),
+      extra: details.extra
+    }
+  );
+  const resp = await fetchWithTimeout4(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "PAYMENT-SIGNATURE": paymentPayload
+    },
+    body: reqBody
+  }, 9e4);
+  const data = await resp.json().catch(() => ({}));
+  return { status: resp.status, data };
+}
 function registerRealfaceTool(server, budget) {
   server.registerTool(
     "blockrun_realface",
@@ -1893,7 +1959,8 @@ Actions:
 - init: FREE. Create an asset group + a phone H5 link. The tool renders the link as a QR code and opens it; the real person scans it on their phone and completes the ~1 min liveness check. Pass group_id to refresh an expired link.
 - status: FREE. Poll a group until status:"active" (ready_to_finalize:true). The H5 link is valid ~120s \u2014 re-init if it expires.
 - enroll: PAID ($0.01 USDC, Base only). After the group is active, upload a clear front-facing photo (image_url) of the SAME person. Returns the ta_xxxx asset id.
-- list: FREE. List the RealFace assets enrolled by this wallet (their ta_xxxx ids + names) so you can pick one for blockrun_video.
+- portrait: PAID ($0.01 USDC, Base only). Virtual Portrait \u2014 enroll an AI-GENERATED character from an image URL directly, NO liveness needed (one step: name + image_url \u2192 ta_xxxx). For fictional/AI characters only; for a real person use the init\u2192status\u2192enroll liveness flow.
+- list: FREE. List the RealFace + Virtual Portrait assets enrolled by this wallet (their ta_xxxx ids + names) so you can pick one for blockrun_video.
 
 Typical flow:
   1. blockrun_realface action:"init" name:"Alice"          \u2192 scan QR on phone, do liveness
@@ -1903,10 +1970,10 @@ Typical flow:
 
 Privacy: BlockRun does not store face/liveness data \u2014 only the asset id, name, and the photo URL you supply.`,
       inputSchema: {
-        action: z8.enum(["init", "status", "enroll", "list"]).describe("What to do"),
-        name: z8.string().min(1).max(64).optional().describe("Display name for the person (required for init and enroll)."),
-        group_id: z8.string().regex(/^legacy_rf_\d+$/).optional().describe("Asset-group id from init (required for status and enroll; pass to init to refresh an expired H5 link)."),
-        image_url: z8.string().url().optional().describe("Public HTTPS URL to a clear front-facing face photo (JPG/PNG/WEBP, \u226410MB). Required for enroll."),
+        action: z8.enum(["init", "status", "enroll", "portrait", "list"]).describe("What to do"),
+        name: z8.string().min(1).max(64).optional().describe("Display name for the person/character (required for init, enroll, and portrait)."),
+        group_id: z8.string().regex(/^legacy_rf_\d+$/).optional().describe("Asset-group id from init (required for status and enroll; pass to init to refresh an expired H5 link). Not used by portrait."),
+        image_url: z8.string().url().optional().describe("Public HTTPS URL to a clear front-facing face image (JPG/PNG/WEBP, \u226410MB). Required for enroll and portrait."),
         agent_id: z8.string().optional().describe("Agent identifier for budget tracking and enforcement (enroll only).")
       }
     },
@@ -1996,30 +2063,88 @@ QR opened for scanning (${qrPath}).`;
         }
         if (action === "list") {
           const account = privateKeyToAccount4(getOrCreateWalletKey());
-          const resp = await fetchWithTimeout4(`${BLOCKRUN_API4}/v1/wallet/${account.address}/realfaces`, {
-            method: "GET"
-          }, 3e4);
-          const data = await resp.json().catch(() => ({}));
-          if (!resp.ok) {
-            return { content: [{ type: "text", text: formatError(`list failed (${resp.status}): ${data.error || JSON.stringify(data)}`) }], isError: true };
+          const [rfResp, vpResp] = await Promise.all([
+            fetchWithTimeout4(`${BLOCKRUN_API4}/v1/wallet/${account.address}/realfaces`, { method: "GET" }, 3e4),
+            fetchWithTimeout4(`${BLOCKRUN_API4}/v1/wallet/${account.address}/portraits`, { method: "GET" }, 3e4).catch(() => null)
+          ]);
+          const data = await rfResp.json().catch(() => ({}));
+          if (!rfResp.ok) {
+            return { content: [{ type: "text", text: formatError(`list failed (${rfResp.status}): ${data.error || JSON.stringify(data)}`) }], isError: true };
           }
           const faces = Array.isArray(data.realfaces) ? data.realfaces : [];
-          if (faces.length === 0) {
+          let portraits = [];
+          if (vpResp?.ok) {
+            const vpData = await vpResp.json().catch(() => ({}));
+            portraits = Array.isArray(vpData.portraits) ? vpData.portraits : [];
+          }
+          if (faces.length === 0 && portraits.length === 0) {
             return {
-              content: [{ type: "text", text: `No RealFace assets enrolled for ${account.address}.
-Enroll one: blockrun_realface action:"init" name:"\u2026".` }],
-              structuredContent: { wallet: account.address, realfaces: [], count: 0 }
+              content: [{ type: "text", text: `No RealFace or Virtual Portrait assets enrolled for ${account.address}.
+Enroll one: blockrun_realface action:"init" name:"\u2026" (real person) or action:"portrait" name:"\u2026" image_url:"https://\u2026" (AI character).` }],
+              structuredContent: { wallet: account.address, realfaces: [], portraits: [], count: 0 }
             };
           }
+          const first = faces[0] ?? portraits[0];
           const lines = [
-            `RealFace assets for ${account.address} (${faces.length}):`,
-            ...faces.map((f) => `  \u2022 ${f.assetId}  \u2014  "${f.name}"${f.createdAt ? `  (${f.createdAt})` : ""}`),
+            `Assets for ${account.address} (${faces.length} RealFace, ${portraits.length} Virtual Portrait):`,
+            ...faces.map((f) => `  \u2022 ${f.assetId}  \u2014  "${f.name}" [realface]${f.createdAt ? `  (${f.createdAt})` : ""}`),
+            ...portraits.map((p) => `  \u2022 ${p.assetId}  \u2014  "${p.name}" [portrait]${p.createdAt ? `  (${p.createdAt})` : ""}`),
             ``,
-            `Use one: blockrun_video model:"bytedance/seedance-2.0" real_face_asset_id:"${faces[0].assetId}" prompt:"\u2026".`
+            `Use one: blockrun_video model:"bytedance/seedance-2.0" real_face_asset_id:"${first.assetId}" prompt:"\u2026".`
           ];
           return {
             content: [{ type: "text", text: lines.join("\n") }],
-            structuredContent: { wallet: account.address, realfaces: faces, count: faces.length }
+            structuredContent: { wallet: account.address, realfaces: faces, portraits, count: faces.length + portraits.length }
+          };
+        }
+        if (action === "portrait") {
+          if (getChain() !== "base") {
+            return { content: [{ type: "text", text: formatError("blockrun_realface portrait settles on Base only. Switch BlockRun to Base (run blockrun_wallet with action:chain chain:base) and fund the Base wallet with USDC.") }], isError: true };
+          }
+          if (!name || !image_url) {
+            return { content: [{ type: "text", text: formatError("portrait requires name and image_url (public HTTPS URL of an AI-generated character image).") }], isError: true };
+          }
+          const budgetCheck = checkBudget(budget, agent_id, ENROLLMENT_PRICE_USD);
+          if (!budgetCheck.allowed) {
+            return { content: [{ type: "text", text: `${budgetCheck.reason}. Use blockrun_wallet action:"report" to see usage or action:"delegate" to increase agent budget.` }], isError: true };
+          }
+          const { status, data } = await payAndPostJson(
+            `${BLOCKRUN_API4}/v1/portrait/enroll`,
+            JSON.stringify({ name, image_url }),
+            "BlockRun Virtual Portrait enrollment"
+          );
+          if (status === 402) {
+            throw new Error("Payment rejected. Check your wallet balance.");
+          }
+          if (status === 422) {
+            return { content: [{ type: "text", text: formatError(`Portrait rejected \u2014 ${data.hint || data.message || "use a clear front-facing character image"}. No payment taken.`) }], isError: true };
+          }
+          if (status < 200 || status >= 300) {
+            throw new Error(`Portrait enroll error ${status}: ${data.error || JSON.stringify(data)}`);
+          }
+          const assetId = data.asset_id;
+          if (!assetId) throw new Error(`Portrait response missing asset_id: ${JSON.stringify(data)}`);
+          recordSpending(budget, ENROLLMENT_PRICE_USD, agent_id);
+          const txHash = data.settlement?.tx_hash || void 0;
+          const lines = [
+            `\u2705 Virtual Portrait enrolled!`,
+            `Asset ID: ${assetId}`,
+            `Name: ${data.name || name}`,
+            `Cost: $${ENROLLMENT_PRICE_USD.toFixed(2)} USDC`,
+            ...txHash ? [`Tx: ${txHash}`] : [],
+            ``,
+            `Use it: blockrun_video model:"bytedance/seedance-2.0" real_face_asset_id:"${assetId}" prompt:"\u2026".`
+          ];
+          return {
+            content: [{ type: "text", text: lines.join("\n") }],
+            structuredContent: {
+              asset_id: assetId,
+              group_id: data.group_id,
+              name: data.name || name,
+              image_url: data.image_url,
+              price_usd: ENROLLMENT_PRICE_USD,
+              ...txHash ? { txHash } : {}
+            }
           };
         }
         if (action === "enroll") {
@@ -2780,6 +2905,131 @@ Each Surf endpoint pre-validates required params before settling \u2014 you get
   );
 }
 
+// src/tools/rpc.ts
+import { z as z17 } from "zod";
+var RPC_PRICE_USD = 2e-3;
+function registerRpcTool(server, budget) {
+  server.registerTool(
+    "blockrun_rpc",
+    {
+      description: `Raw JSON-RPC against 40+ blockchains \u2014 one endpoint, no node, no API key. $0.002 per call (batch charges per element).
+
+Use when you need data the higher-level tools don't cover: contract reads (eth_call), balances, blocks, txs, logs, gas, or any chain-native RPC method.
+
+Networks (full catalog in the rpc skill): ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, solana, bitcoin, sui, near, ripple, polkadot, dogecoin, litecoin, monad, berachain, unichain, hyperevm, sonic, and 20+ more.
+
+Examples:
+  blockrun_rpc({ network: "ethereum", method: "eth_blockNumber" })
+  blockrun_rpc({ network: "base", method: "eth_getBalance", params: ["0xabc...", "latest"] })
+  blockrun_rpc({ network: "solana", method: "getSlot" })
+  blockrun_rpc({ network: "bitcoin", method: "getblockchaininfo" })
+  blockrun_rpc({ network: "ethereum", body: [{jsonrpc:"2.0",id:1,method:"eth_blockNumber"},{...}] })  // batch
+
+Prefer blockrun_price (free quotes), blockrun_dex (free DEX data), or blockrun_surf (labeled/aggregated data) when they cover the question \u2014 this tool is for raw chain access.`,
+      inputSchema: {
+        network: z17.string().describe("Chain key, e.g. 'ethereum', 'base', 'solana', 'bitcoin', 'arbitrum', 'polygon'. Unknown slugs pass through to the Tatum gateway."),
+        method: z17.string().optional().describe("JSON-RPC method, e.g. 'eth_blockNumber', 'eth_call', 'getSlot' (Solana), 'getblockchaininfo' (Bitcoin). Required unless 'body' is set."),
+        params: z17.any().optional().describe("JSON-RPC params array for the method, e.g. ['0xabc...', 'latest']."),
+        body: z17.any().optional().describe("Full JSON-RPC 2.0 body or an array of them (batch). Overrides method/params when set."),
+        agent_id: z17.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+      }
+    },
+    async ({ network, method, params, body, agent_id }) => {
+      try {
+        body = coerceBody(body);
+        if (body === void 0) {
+          if (!method) {
+            return {
+              content: [{ type: "text", text: formatError("Provide either 'method' (with optional 'params') or a full JSON-RPC 'body'.") }],
+              isError: true
+            };
+          }
+          body = { jsonrpc: "2.0", id: 1, method, params: params ?? [] };
+        }
+        const batchCount = Array.isArray(body) ? Math.max(body.length, 1) : 1;
+        const estimatedCost = RPC_PRICE_USD * batchCount;
+        const budgetCheck = checkBudget(budget, agent_id, estimatedCost);
+        if (!budgetCheck.allowed) {
+          return {
+            content: [{ type: "text", text: `${budgetCheck.reason}. Use blockrun_wallet action:"report" to see usage or action:"delegate" to increase agent budget.` }],
+            isError: true
+          };
+        }
+        const cleanNetwork = network.trim().toLowerCase().replace(/^\/+|\/+$/g, "");
+        const client = getClient();
+        const result = await client.requestWithPaymentRaw(`/v1/rpc/${cleanNetwork}`, body);
+        recordSpending(budget, estimatedCost, agent_id);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: typeof result === "object" && result !== null && !Array.isArray(result) ? result : { result }
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: formatError(extractErrorMessage(err)) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/defi.ts
+import { z as z18 } from "zod";
+function estimateDefiCost(path5) {
+  return path5.startsWith("prices") ? 1e-3 : 5e-3;
+}
+function registerDefiTool(server, budget) {
+  server.registerTool(
+    "blockrun_defi",
+    {
+      description: `DeFi fundamentals via DefiLlama \u2014 protocol TVL, chain TVL, yield pools (APY), token prices. Pays per call in USDC, no API key.
+
+Paths (GET only):
+- protocols                      ($0.005) \u2014 all DeFi protocols ranked by TVL
+- protocol/{slug}                ($0.005) \u2014 one protocol's TVL history + chain breakdown, e.g. protocol/aave-v3
+- chains                         ($0.005) \u2014 TVL by chain
+- yields                         ($0.005) \u2014 yield pools with APY + TVL (large; filter client-side)
+- prices/{coins}                 ($0.001) \u2014 token prices, coins like 'base:0x833589...,coingecko:ethereum'
+
+Examples:
+  blockrun_defi({ path: "protocol/uniswap-v3" })
+  blockrun_defi({ path: "prices/coingecko:bitcoin,coingecko:ethereum" })
+  blockrun_defi({ path: "chains" })
+
+Use blockrun_price (free) for plain spot quotes, blockrun_dex (free) for DEX pairs, blockrun_surf for labeled on-chain data \u2014 this tool is for protocol/TVL/yield fundamentals.`,
+      inputSchema: {
+        path: z18.string().describe("Endpoint under /v1/defillama/, e.g. 'protocols', 'protocol/aave-v3', 'chains', 'yields', 'prices/coingecko:ethereum'"),
+        agent_id: z18.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+      }
+    },
+    async ({ path: path5, agent_id }) => {
+      try {
+        const cleanPath = path5.replace(/^\/+/, "").replace(/^v1\/defillama\//, "").replace(/^api\/v1\/defillama\//, "");
+        const estimatedCost = estimateDefiCost(cleanPath);
+        const budgetCheck = checkBudget(budget, agent_id, estimatedCost);
+        if (!budgetCheck.allowed) {
+          return {
+            content: [{ type: "text", text: `${budgetCheck.reason}. Use blockrun_wallet action:"report" to see usage or action:"delegate" to increase agent budget.` }],
+            isError: true
+          };
+        }
+        const client = getClient();
+        const result = await client.getWithPaymentRaw(`/v1/defillama/${cleanPath}`);
+        recordSpending(budget, estimatedCost, agent_id);
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: typeof result === "object" && result !== null && !Array.isArray(result) ? result : { result }
+        };
+      } catch (err) {
+        return {
+          content: [{ type: "text", text: formatError(extractErrorMessage(err)) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/mcp-handler.ts
 function initializeMcpServer(server) {
   const budget = { limit: null, spent: 0, calls: 0, agents: /* @__PURE__ */ new Map() };
@@ -2800,6 +3050,8 @@ function initializeMcpServer(server) {
   registerModalTool(server, budget);
   registerPhoneTool(server, budget);
   registerSurfTool(server, budget);
+  registerRpcTool(server, budget);
+  registerDefiTool(server, budget);
   server.registerResource(
     "wallet",
     "blockrun://wallet",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.19.2",
+  "version": "0.21.0",
   "mcpName": "io.github.BlockRunAI/blockrun-mcp",
   "description": "BlockRun MCP Server - Give your AI agent web search, deep research, prediction markets, crypto data, X/Twitter intelligence. Paid via x402 micropayments.",
   "type": "module",