@blockrun/mcp 0.19.1 → 0.20.0

package/README.md

@@ -96,11 +96,6 @@ ensures `-y` is passed to `npx`, not parsed by `claude mcp add`.
 }
 ```
 
-**Hosted (no install, always latest)**
-```bash
-claude mcp add blockrun -s user --transport http https://mcp.blockrun.ai/mcp
-```
-
 **Cursor** — add to `~/.cursor/mcp.json` (macOS / Linux) or `%APPDATA%\Cursor\mcp.json` (Windows):
 ```json
 {
@@ -137,9 +132,9 @@ $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_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 → `ta_xxxx` asset) for Seedance 2.0 real-person 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 |
@@ -149,6 +144,9 @@ $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_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);
@@ -2780,6 +2806,74 @@ 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/mcp-handler.ts
 function initializeMcpServer(server) {
   const budget = { limit: null, spent: 0, calls: 0, agents: /* @__PURE__ */ new Map() };
@@ -2800,6 +2894,7 @@ function initializeMcpServer(server) {
   registerModalTool(server, budget);
   registerPhoneTool(server, budget);
   registerSurfTool(server, budget);
+  registerRpcTool(server, budget);
   server.registerResource(
     "wallet",
     "blockrun://wallet",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.19.1",
+  "version": "0.20.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",