@blockrun/mcp 0.6.6 → 0.6.8

package/README.md

@@ -7,7 +7,7 @@
 **Real-time data for Claude — markets, research, X/Twitter, crypto. No API keys. Pay per call.**
 
 ```bash
-claude mcp add blockrun npx @blockrun/mcp
+claude mcp add blockrun npx -y @blockrun/mcp@latest
 ```
 
 Wallet auto-created. Fund with $5 USDC. Ask Claude anything.
@@ -49,7 +49,7 @@ After BlockRun, it can. Each query costs fractions of a cent, billed from a loca
 
 **Claude Code (recommended)**
 ```bash
-claude mcp add blockrun npx @blockrun/mcp
+claude mcp add blockrun npx -y @blockrun/mcp@latest
 ```
 
 **Claude Desktop** — add to `claude_desktop_config.json`:

package/dist/index.js

@@ -5,70 +5,29 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/utils/wallet.ts
-import { LLMClient, ImageClient } from "@blockrun/llm";
-import { generatePrivateKey, privateKeyToAccount } from "viem/accounts";
-import * as fs from "fs";
-
-// src/utils/constants.ts
-import * as path from "path";
-import * as os from "os";
-var WALLET_DIR = path.join(os.homedir(), ".blockrun");
-var WALLET_FILE = path.join(WALLET_DIR, ".session");
-var QR_FILE = path.join(WALLET_DIR, "qr.png");
-var USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
-var BASE_CHAIN_ID = "8453";
-var BASE_RPC_URLS = [
-  "https://mainnet.base.org",
-  "https://base.llamarpc.com",
-  "https://1rpc.io/base"
-];
-var MODEL_TIERS = {
-  fast: ["google/gemini-2.5-flash", "google/gemini-3.1-flash-lite", "openai/gpt-5-mini", "deepseek/deepseek-chat", "google/gemini-3-flash-preview"],
-  balanced: ["openai/gpt-5.4", "anthropic/claude-sonnet-4.6", "google/gemini-2.5-pro", "openai/gpt-5.3", "google/gemini-3.1-pro"],
-  powerful: ["openai/gpt-5.4-pro", "anthropic/claude-opus-4.6", "anthropic/claude-opus-4.5", "openai/o3", "openai/gpt-5.4"],
-  cheap: ["nvidia/gpt-oss-120b", "nvidia/deepseek-v3.2", "google/gemini-2.5-flash", "deepseek/deepseek-chat", "openai/gpt-5.4-nano"],
-  reasoning: ["openai/o3", "openai/o1", "openai/o3-mini", "deepseek/deepseek-reasoner", "openai/gpt-5.3-codex"],
-  free: ["nvidia/gpt-oss-120b", "nvidia/deepseek-v3.2", "nvidia/nemotron-ultra-253b", "nvidia/nemotron-super-49b", "nvidia/qwen3-coder-480b", "nvidia/llama-4-maverick", "nvidia/gpt-oss-20b"],
-  coding: ["openai/gpt-5.3-codex", "nvidia/qwen3-coder-480b", "nvidia/devstral-2-123b", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4"]
-};
-
-// src/utils/wallet.ts
-var _walletWasCreated = false;
-var _walletAddress = null;
+import {
+  LLMClient,
+  ImageClient,
+  getOrCreateWallet,
+  getPaymentLinks,
+  formatWalletCreatedMessage,
+  formatNeedsFundingMessage
+} from "@blockrun/llm";
 var _client = null;
 var _imageClient = null;
-function getOrCreateWalletKey() {
-  const envKey = process.env.BLOCKRUN_WALLET_KEY || process.env.BASE_CHAIN_WALLET_KEY;
-  if (envKey) {
-    const account2 = privateKeyToAccount(envKey);
-    _walletAddress = account2.address;
-    return envKey;
-  }
-  if (fs.existsSync(WALLET_FILE)) {
-    try {
-      const savedKey = fs.readFileSync(WALLET_FILE, "utf-8").trim();
-      if (savedKey.startsWith("0x") && savedKey.length === 66) {
-        const account2 = privateKeyToAccount(savedKey);
-        _walletAddress = account2.address;
-        return savedKey;
-      }
-    } catch {
-    }
-  }
-  const newKey = generatePrivateKey();
-  const account = privateKeyToAccount(newKey);
-  _walletAddress = account.address;
-  _walletWasCreated = true;
-  try {
-    if (!fs.existsSync(WALLET_DIR)) {
-      fs.mkdirSync(WALLET_DIR, { recursive: true, mode: 448 });
+var _walletInfo = null;
+function ensureWallet() {
+  if (!_walletInfo) {
+    _walletInfo = getOrCreateWallet();
+    if (_walletInfo.isNew) {
+      console.error(formatWalletCreatedMessage(_walletInfo.address));
     }
-    fs.writeFileSync(WALLET_FILE, newKey, { mode: 384 });
-    console.error(`[BlockRun] New wallet created and saved to ${WALLET_FILE}`);
-  } catch (err) {
-    console.error(`[BlockRun] Warning: Could not save wallet to file: ${err}`);
   }
-  return newKey;
+  return _walletInfo;
+}
+function getOrCreateWalletKey() {
+  const info = ensureWallet();
+  return info.privateKey;
 }
 function getClient() {
   if (!_client) {
@@ -85,28 +44,29 @@ function getImageClient() {
   return _imageClient;
 }
 function getWalletInfo() {
-  const llm = getClient();
-  const address = llm.getWalletAddress();
+  const info = ensureWallet();
+  const links = getPaymentLinks(info.address);
   return {
-    address,
+    address: info.address,
     network: "Base",
     chainId: 8453,
     currency: "USDC",
-    isNew: _walletWasCreated,
-    basescanUrl: `https://basescan.org/address/${address}`
+    isNew: info.isNew,
+    basescanUrl: links.basescan,
+    fundingUrl: links.blockrun
   };
 }
 async function getUsdcBalance(address) {
+  const USDC_ADDRESS2 = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+  const BASE_RPC_URLS = [
+    "https://mainnet.base.org",
+    "https://base.llamarpc.com",
+    "https://1rpc.io/base"
+  ];
   const data = {
     jsonrpc: "2.0",
     method: "eth_call",
-    params: [
-      {
-        to: USDC_ADDRESS,
-        data: `0x70a08231000000000000000000000000${address.slice(2)}`
-      },
-      "latest"
-    ],
+    params: [{ to: USDC_ADDRESS2, data: `0x70a08231000000000000000000000000${address.slice(2)}` }, "latest"],
     id: 1
   };
   for (const rpcUrl of BASE_RPC_URLS) {
@@ -117,9 +77,7 @@ async function getUsdcBalance(address) {
         body: JSON.stringify(data)
       });
       const result = await response.json();
-      if (result.result) {
-        return parseInt(result.result, 16) / 1e6;
-      }
+      if (result.result) return parseInt(result.result, 16) / 1e6;
     } catch {
       continue;
     }
@@ -133,15 +91,35 @@ import { z } from "zod";
 // src/utils/qr.ts
 import QRCode from "qrcode";
 import open from "open";
-import * as fs2 from "fs";
+import * as fs from "fs";
+
+// src/utils/constants.ts
+import * as path from "path";
+import * as os from "os";
+var WALLET_DIR = path.join(os.homedir(), ".blockrun");
+var WALLET_FILE = path.join(WALLET_DIR, ".session");
+var QR_FILE = path.join(WALLET_DIR, "qr.png");
+var USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+var BASE_CHAIN_ID = "8453";
+var MODEL_TIERS = {
+  fast: ["google/gemini-2.5-flash", "google/gemini-3.1-flash-lite", "openai/gpt-5-mini", "deepseek/deepseek-chat", "google/gemini-3-flash-preview"],
+  balanced: ["openai/gpt-5.4", "anthropic/claude-sonnet-4.6", "google/gemini-2.5-pro", "openai/gpt-5.3", "google/gemini-3.1-pro"],
+  powerful: ["openai/gpt-5.4-pro", "anthropic/claude-opus-4.6", "anthropic/claude-opus-4.5", "openai/o3", "openai/gpt-5.4"],
+  cheap: ["nvidia/gpt-oss-120b", "nvidia/deepseek-v3.2", "google/gemini-2.5-flash", "deepseek/deepseek-chat", "openai/gpt-5.4-nano"],
+  reasoning: ["openai/o3", "openai/o1", "openai/o3-mini", "deepseek/deepseek-reasoner", "openai/gpt-5.3-codex"],
+  free: ["nvidia/gpt-oss-120b", "nvidia/deepseek-v3.2", "nvidia/nemotron-ultra-253b", "nvidia/nemotron-super-49b", "nvidia/qwen3-coder-480b", "nvidia/llama-4-maverick", "nvidia/gpt-oss-20b"],
+  coding: ["openai/gpt-5.3-codex", "nvidia/qwen3-coder-480b", "nvidia/devstral-2-123b", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4"]
+};
+
+// src/utils/qr.ts
 function getEip681Uri(address, amountUsdc = 1) {
   const amountWei = Math.floor(amountUsdc * 1e6);
   return `ethereum:${USDC_ADDRESS}@${BASE_CHAIN_ID}/transfer?address=${address}&uint256=${amountWei}`;
 }
 async function generateQrPng(address) {
   const eip681Uri = getEip681Uri(address);
-  if (!fs2.existsSync(WALLET_DIR)) {
-    fs2.mkdirSync(WALLET_DIR, { recursive: true, mode: 448 });
+  if (!fs.existsSync(WALLET_DIR)) {
+    fs.mkdirSync(WALLET_DIR, { recursive: true, mode: 448 });
   }
   await QRCode.toFile(QR_FILE, eip681Uri, {
     type: "png",
@@ -675,52 +653,8 @@ Error: ${errMsg}` }],
   );
 }
 
-// src/tools/twitter.ts
-import { z as z5 } from "zod";
-function registerTwitterTool(server, budget) {
-  server.registerTool(
-    "blockrun_twitter",
-    {
-      description: `Search real-time X/Twitter via Grok. Use for trending topics, @handles, breaking news.`,
-      inputSchema: {
-        query: z5.string().describe("Search query (can include @handles, topics)"),
-        max_results: z5.number().optional().default(10).describe("Max results (1-25)")
-      }
-    },
-    async ({ query, max_results }) => {
-      const budgetCheck = checkBudget(budget);
-      if (!budgetCheck.allowed) {
-        return {
-          content: [{ type: "text", text: `Budget limit reached ($${budget.spent.toFixed(4)} of $${budget.limit?.toFixed(2)}). Use blockrun_wallet with action: "budget" to adjust.` }],
-          isError: true
-        };
-      }
-      try {
-        const llm = getClient();
-        const response = await llm.chat("xai/grok-3", query, {
-          system: `Real-time X/Twitter search. Focus on recent posts, key accounts, engagement. Max results: ${max_results}`,
-          search: true
-        });
-        recordSpending(budget, 2e-3);
-        return {
-          content: [{ type: "text", text: `[X/Twitter via Grok]
-
-${response}` }],
-          structuredContent: { query, model: "xai/grok-3", response }
-        };
-      } catch (error) {
-        const errorMessage = error instanceof Error ? error.message : String(error);
-        return {
-          content: [{ type: "text", text: formatError(errorMessage) }],
-          isError: true
-        };
-      }
-    }
-  );
-}
-
 // src/tools/search.ts
-import { z as z6 } from "zod";
+import { z as z5 } from "zod";
 function registerSearchTool(server) {
   server.registerTool(
     "blockrun_search",
@@ -732,11 +666,11 @@ Pricing: ~$0.01/search
 
 Returns a summary with cited sources.`,
       inputSchema: {
-        query: z6.string().describe("Search query"),
-        sources: z6.array(z6.enum(["web", "x", "news"])).optional().describe("Sources to search (default: web + x + news)"),
-        max_results: z6.number().optional().default(10).describe("Max results per source (1-20)"),
-        from_date: z6.string().optional().describe("Start date filter (YYYY-MM-DD)"),
-        to_date: z6.string().optional().describe("End date filter (YYYY-MM-DD)")
+        query: z5.string().describe("Search query"),
+        sources: z5.array(z5.enum(["web", "x", "news"])).optional().describe("Sources to search (default: web + x + news)"),
+        max_results: z5.number().optional().default(10).describe("Max results per source (1-20)"),
+        from_date: z5.string().optional().describe("Start date filter (YYYY-MM-DD)"),
+        to_date: z5.string().optional().describe("End date filter (YYYY-MM-DD)")
       }
     },
     async ({ query, sources, max_results, from_date, to_date }) => {
@@ -764,7 +698,7 @@ Returns a summary with cited sources.`,
 }
 
 // src/tools/exa.ts
-import { z as z7 } from "zod";
+import { z as z6 } from "zod";
 function registerExaTool(server) {
   server.registerTool(
     "blockrun_exa",
@@ -777,14 +711,14 @@ Actions:
 - contents: Fetch full Markdown text from URLs, ready for LLM context ($0.002/URL)
 - similar: Find pages semantically similar to a given URL ($0.01/call)`,
       inputSchema: {
-        action: z7.enum(["search", "answer", "contents", "similar"]).describe("Action to perform"),
-        query: z7.string().optional().describe("Natural language query (for search/answer)"),
-        url: z7.string().optional().describe("Reference URL to find similar pages (for similar action)"),
-        urls: z7.array(z7.string()).optional().describe("URLs to fetch content from (for contents action, up to 100)"),
-        num_results: z7.number().optional().describe("Number of results to return (default: 10)"),
-        category: z7.string().optional().describe("Category filter: 'news', 'research paper', 'company', 'tweet', 'github', 'pdf'"),
-        include_domains: z7.array(z7.string()).optional().describe("Only search within these domains"),
-        exclude_domains: z7.array(z7.string()).optional().describe("Exclude these domains from results")
+        action: z6.enum(["search", "answer", "contents", "similar"]).describe("Action to perform"),
+        query: z6.string().optional().describe("Natural language query (for search/answer)"),
+        url: z6.string().optional().describe("Reference URL to find similar pages (for similar action)"),
+        urls: z6.array(z6.string()).optional().describe("URLs to fetch content from (for contents action, up to 100)"),
+        num_results: z6.number().optional().describe("Number of results to return (default: 10)"),
+        category: z6.string().optional().describe("Category filter: 'news', 'research paper', 'company', 'tweet', 'github', 'pdf'"),
+        include_domains: z6.array(z6.string()).optional().describe("Only search within these domains"),
+        exclude_domains: z6.array(z6.string()).optional().describe("Exclude these domains from results")
       }
     },
     async ({ action, query, url, urls, num_results, category, include_domains, exclude_domains }) => {
@@ -837,7 +771,7 @@ Actions:
 }
 
 // src/tools/markets.ts
-import { z as z8 } from "zod";
+import { z as z7 } from "zod";
 function registerMarketsTool(server) {
   server.registerTool(
     "blockrun_markets",
@@ -852,9 +786,9 @@ Example paths:
 
 $0.001/call.`,
       inputSchema: {
-        path: z8.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14'"),
-        params: z8.record(z8.string(), z8.string()).optional().describe("Query parameters for GET requests"),
-        body: z8.any().optional().describe("JSON body for POST queries (triggers pmQuery)")
+        path: z7.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14'"),
+        params: z7.record(z7.string(), z7.string()).optional().describe("Query parameters for GET requests"),
+        body: z7.any().optional().describe("JSON body for POST queries (triggers pmQuery)")
       }
     },
     async ({ path: path2, params, body }) => {
@@ -877,7 +811,7 @@ $0.001/call.`,
 }
 
 // src/tools/dex.ts
-import { z as z9 } from "zod";
+import { z as z8 } from "zod";
 function registerDexTool(server) {
   server.registerTool(
     "blockrun_dex",
@@ -894,10 +828,10 @@ Examples:
   blockrun_dex({ token: "So11...xxx" })    -> Get specific token data
   blockrun_dex({ symbol: "PEPE" })         -> Search by symbol`,
       inputSchema: {
-        query: z9.string().optional().describe("Search query (token name, symbol, or address)"),
-        token: z9.string().optional().describe("Token address for direct lookup"),
-        symbol: z9.string().optional().describe("Token symbol to search"),
-        chain: z9.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
+        query: z8.string().optional().describe("Search query (token name, symbol, or address)"),
+        token: z8.string().optional().describe("Token address for direct lookup"),
+        symbol: z8.string().optional().describe("Token symbol to search"),
+        chain: z8.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
       }
     },
     async ({ query, token, symbol, chain }) => {
@@ -965,7 +899,6 @@ function initializeMcpServer(server) {
   registerChatTool(server, budget);
   registerModelsTool(server, modelCache);
   registerImageTool(server);
-  registerTwitterTool(server, budget);
   registerSearchTool(server);
   registerExaTool(server);
   registerMarketsTool(server);
@@ -1006,15 +939,30 @@ function initializeMcpServer(server) {
 }
 
 // src/index.ts
+var VERSION = "0.6.7";
+async function checkForUpdate() {
+  try {
+    const resp = await fetch("https://registry.npmjs.org/@blockrun/mcp/latest", {
+      signal: AbortSignal.timeout(3e3)
+    });
+    const data = await resp.json();
+    if (data.version && data.version !== VERSION) {
+      console.error(`[BlockRun] Update available: v${VERSION} \u2192 v${data.version}`);
+      console.error(`[BlockRun] Run: claude mcp add blockrun npx -y @blockrun/mcp@latest`);
+    }
+  } catch {
+  }
+}
 async function main() {
   const server = new McpServer({
     name: "blockrun-mcp",
-    version: "0.6.5"
+    version: VERSION
   });
   initializeMcpServer(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("BlockRun MCP Server started (v0.6.5) \u2014 stdio transport");
+  console.error(`BlockRun MCP Server started (v${VERSION}) \u2014 stdio transport`);
+  checkForUpdate();
 }
 main().catch((error) => {
   console.error("Fatal error:", error);

package/package.json

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