@blockrun/mcp 0.6.4 → 0.6.6

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BlockRun AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,58 +1,127 @@
-# @blockrun/mcp
-
-**Live data for AI agents — search, research, markets, crypto, X/Twitter.**
+# BlockRun MCP
 
 [![npm](https://img.shields.io/npm/v/@blockrun/mcp)](https://www.npmjs.com/package/@blockrun/mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
+
+**Real-time data for Claude — markets, research, X/Twitter, crypto. No API keys. Pay per call.**
 
 ```bash
 claude mcp add blockrun npx @blockrun/mcp
 ```
 
-Wallet auto-created. Fund with USDC on Base. Done.
+Wallet auto-created. Fund with $5 USDC. Ask Claude anything.
 
 ---
 
-## Tools
+## What changes
 
-| Tool | What it does | Cost |
-|------|-------------|------|
-| `blockrun_search` | Web + news search | ~$0.01 |
-| `blockrun_exa` | Neural research — papers, competitors, similar products | $0.01 |
-| `blockrun_twitter` | X/Twitter via Grok — trends, sentiment, @handles | per token |
-| `blockrun_markets` | Prediction markets — Polymarket, Kalshi | $0.001 |
-| `blockrun_dex` | DEX prices via DexScreener | free |
-| `blockrun_image` | Image gen (DALL-E 3, Flux) | $0.02-0.08 |
-| `blockrun_chat` | Second opinion from GPT, Gemini, DeepSeek, etc. | per token |
-| `blockrun_wallet` | Balance, budgets, spending | free |
-| `blockrun_models` | List models + pricing | free |
+Before BlockRun, Claude can't answer:
+
+- *"What's the current Polymarket probability that Bitcoin hits $100k this year?"*
+- *"Find me the top 5 papers on RAG published in the last 30 days"*
+- *"What are people saying about @sama on X right now?"*
+- *"What's the 24h volume on the PEPE/ETH pair on Uniswap?"*
+
+After BlockRun, it can. Each query costs fractions of a cent, billed from a local USDC wallet. No subscriptions. No API dashboards. No key rotation.
 
 ---
 
-## Fund Your Wallet
+## Demo
 
-Run `blockrun_wallet` to see your address, then send USDC on Base. $5 = ~500 Exa searches.
+> **User:** What's Polymarket saying about the Fed rate decision next month?
 
-| Method | How |
-|--------|-----|
-| Coinbase | Send → USDC → Base network → paste address |
-| Bridge | [bridge.base.org](https://bridge.base.org) |
+> **Claude:** According to Polymarket, the market currently puts a **73% probability** on the Fed holding rates steady at the May meeting, with 24% on a 25bp cut and 3% on a hike. Volume over the last 24h: $2.1M. The "Hold" contract last traded at $0.73.
+>
+> *(via `blockrun_markets` · cost: $0.001)*
 
 ---
 
-## How It Works
-
-Pay-per-call via [x402](https://x402.org) micropayments in USDC. Wallet stored locally at `~/.blockrun/.session`. Private key never leaves your machine.
+> **User:** Find recent papers on speculative decoding and summarize the key approaches
 
-For multi-agent systems: delegate budgets to child agents with `agent_id`. Auto-blocked when budget runs out.
+> **Claude:** I found 8 papers from the last 60 days via neural search. The dominant approaches are: (1) draft model selection — smaller models predicting N tokens ahead for the larger model to verify in parallel...
+>
+> *(via `blockrun_exa` · cost: $0.01)*
 
 ---
 
-## Hosted (no install)
+## Install
+
+**Claude Code (recommended)**
+```bash
+claude mcp add blockrun npx @blockrun/mcp
+```
+
+**Claude Desktop** — add to `claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "blockrun": {
+      "command": "npx",
+      "args": ["-y", "@blockrun/mcp"]
+    }
+  }
+}
+```
 
+**Hosted (no install, always latest)**
 ```bash
 claude mcp add --transport http blockrun https://mcp.blockrun.ai/mcp
 ```
 
 ---
 
-[blockrun.ai](https://blockrun.ai) · [npm](https://www.npmjs.com/package/@blockrun/mcp) · [github](https://github.com/blockrunai/blockrun-mcp) · [@BlockRunAI](https://x.com/BlockRunAI)
+## Fund your wallet
+
+Run `blockrun_wallet` to see your address. Send USDC on Base.
+
+| Method | Steps |
+|--------|-------|
+| Coinbase | Send → USDC → Base network → paste address |
+| Bridge from Ethereum | [bridge.base.org](https://bridge.base.org) |
+
+$5 covers ~5,000 market queries, ~500 Exa searches, or ~250 image generations.
+
+---
+
+## Tools
+
+| Tool | Data source | Cost |
+|------|-------------|------|
+| `blockrun_markets` | Polymarket, Kalshi, dFlow, Binance Futures | $0.001/query |
+| `blockrun_exa` | Neural web search (Exa) — research, competitors, papers, URL content | $0.01/query |
+| `blockrun_search` | Web + news with citations | ~$0.01 |
+| `blockrun_twitter` | X/Twitter — profiles, tweets, trends, Grok sentiment | per token |
+| `blockrun_dex` | Live DEX prices via DexScreener | free |
+| `blockrun_image` | DALL-E 3, Flux image generation + editing | $0.02–0.08 |
+| `blockrun_chat` | GPT-4o, Gemini, DeepSeek, 30+ models | per token |
+| `blockrun_wallet` | Balance, spending, agent budgets | free |
+
+---
+
+## Why not just use the APIs directly?
+
+| | Direct APIs | BlockRun |
+|---|---|---|
+| Exa | Sign up, $20/mo minimum | $0.01/call, no subscription |
+| Polymarket | Undocumented, rate-limited | $0.001/call, clean JSON |
+| Twitter/X API | $100–$5000/month | $0.03/page, no approval |
+| Multiple sources | 4 accounts, 4 API keys, 4 billing pages | 1 wallet |
+
+One wallet. All sources. No dashboards.
+
+---
+
+## Multi-agent budget delegation
+
+Delegate a spending budget to a child agent with `agent_id`. The child is auto-blocked when the budget runs out — useful for autonomous agents that shouldn't run up unbounded costs.
+
+---
+
+## How it works
+
+Pay-per-call via [x402](https://x402.org) micropayments in USDC on Base. Your wallet lives at `~/.blockrun/.session`. Private key never leaves your machine.
+
+---
+
+[blockrun.ai](https://blockrun.ai) · [npm](https://www.npmjs.com/package/@blockrun/mcp) · [@BlockRunAI](https://x.com/BlockRunAI)

package/dist/index.js

@@ -132,7 +132,6 @@ import { z } from "zod";
 
 // src/utils/qr.ts
 import QRCode from "qrcode";
-import { Jimp } from "jimp";
 import open from "open";
 import * as fs2 from "fs";
 function getEip681Uri(address, amountUsdc = 1) {
@@ -141,28 +140,16 @@ function getEip681Uri(address, amountUsdc = 1) {
 }
 async function generateQrPng(address) {
   const eip681Uri = getEip681Uri(address);
-  const qrBuffer = await QRCode.toBuffer(eip681Uri, {
+  if (!fs2.existsSync(WALLET_DIR)) {
+    fs2.mkdirSync(WALLET_DIR, { recursive: true, mode: 448 });
+  }
+  await QRCode.toFile(QR_FILE, eip681Uri, {
     type: "png",
     width: 400,
     margin: 2,
     errorCorrectionLevel: "H",
     color: { dark: "#000000", light: "#FFFFFF" }
   });
-  const qrImage = await Jimp.read(qrBuffer);
-  try {
-    const logoUrl = "https://avatars.githubusercontent.com/u/108554348?s=200&v=4";
-    const logo = await Jimp.read(logoUrl);
-    const logoSize = Math.floor(qrImage.width * 0.2);
-    logo.resize({ w: logoSize, h: logoSize });
-    const x = Math.floor((qrImage.width - logoSize) / 2);
-    const y = Math.floor((qrImage.height - logoSize) / 2);
-    qrImage.composite(logo, x, y);
-  } catch {
-  }
-  if (!fs2.existsSync(WALLET_DIR)) {
-    fs2.mkdirSync(WALLET_DIR, { recursive: true, mode: 448 });
-  }
-  await qrImage.write(QR_FILE);
   return QR_FILE;
 }
 async function openQrInViewer(qrPath) {
@@ -855,19 +842,15 @@ function registerMarketsTool(server) {
   server.registerTool(
     "blockrun_markets",
     {
-      description: `Prediction market data via Predexon. Real-time data from Polymarket, Kalshi, dFlow, and Binance Futures.
-
-Usage:
-- GET: blockrun_markets with path + optional params
-- POST: blockrun_markets with path + body
+      description: `Prediction market data. Real-time from Polymarket, Kalshi.
 
 Example paths:
 - "polymarket/events" \u2014 list active events
-- "polymarket/search" + params: { q: "bitcoin" } \u2014 search events
+- "polymarket/markets" \u2014 list markets
+- "kalshi/markets" \u2014 Kalshi markets
 - "kalshi/markets/KXBTC-25MAR14" \u2014 specific market
-- "polymarket/query" + body: { filter: "active", limit: 10 } \u2014 structured query
 
-Pricing: $0.001/GET, $0.005/POST`,
+$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"),
@@ -1026,12 +1009,12 @@ function initializeMcpServer(server) {
 async function main() {
   const server = new McpServer({
     name: "blockrun-mcp",
-    version: "0.6.3"
+    version: "0.6.5"
   });
   initializeMcpServer(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("BlockRun MCP Server started (v0.6.3) \u2014 stdio transport");
+  console.error("BlockRun MCP Server started (v0.6.5) \u2014 stdio transport");
 }
 main().catch((error) => {
   console.error("Fatal error:", error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "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",
@@ -46,7 +46,6 @@
   "dependencies": {
     "@blockrun/llm": "^1.5.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "jimp": "^1.6.0",
     "open": "^11.0.0",
     "qrcode": "^1.5.4",
     "viem": "^2.21.0",