@blockrun/mcp 0.9.0 → 0.11.0

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 -y @blockrun/mcp@latest
+claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
 ```
 
 Wallet auto-created. Fund with $5 USDC. Ask Claude anything.
@@ -45,13 +45,37 @@ After BlockRun, it can. Each query costs fractions of a cent, billed from a loca
 
 ---
 
+## Showcase
+
+Posters generated through `blockrun_image` with `openai/gpt-image-2`. Each is a single API call routed through BlockRun, paid in USDC on Base.
+
+### Latest — GPT-5.5 now live on BlockRun
+
+<p align="center">
+  <img src="assets/posters/gpt-5-5-launch.png" width="640" alt="gpt-5.5 — now live on BlockRun. Pay per call. No subscription. No keys.">
+</p>
+
+### Gallery
+
+| | | |
+|:---:|:---:|:---:|
+| <img src="assets/posters/cornell-2026-popular-booth.png" width="280" alt="Thank you, Cornell — BlockRun at the Cornell Blockchain Conference 2026, packed booth"> | <img src="assets/posters/cornell-2026.png" width="280" alt="Thank you, Cornell — BlockRun at the Cornell Blockchain Conference 2026"> | <img src="skills/image-prompting/example-100t-poster.jpg" width="280" alt="100 Trillion Tokens served — synthwave milestone poster"> |
+| **Cornell Blockchain Conference 2026** — packed booth recap | **Cornell Blockchain Conference 2026** — quiet variant | **100 Trillion Tokens** — milestone synthwave poster |
+
+Prompts and a worked example for these are in [`skills/image-prompting/SKILL.md`](skills/image-prompting/SKILL.md).
+
+---
+
 ## Install
 
 **Claude Code (recommended)**
 ```bash
-claude mcp add blockrun npx -y @blockrun/mcp@latest
+claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
 ```
 
+The `-s user` flag installs globally (available in every project). The `--` separator
+ensures `-y` is passed to `npx`, not parsed by `claude mcp add`.
+
 **Claude Desktop** — add to `claude_desktop_config.json`:
 ```json
 {
@@ -66,7 +90,7 @@ claude mcp add blockrun npx -y @blockrun/mcp@latest
 
 **Hosted (no install, always latest)**
 ```bash
-claude mcp add --transport http blockrun https://mcp.blockrun.ai/mcp
+claude mcp add blockrun -s user --transport http https://mcp.blockrun.ai/mcp
 ```
 
 ---
@@ -80,7 +104,7 @@ Run `blockrun_wallet` to see your address. Send USDC on Base.
 | 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.
+$5 covers ~5,000 market queries, ~500 Exa searches, ~250 image generations, or ~30 Seedance 1.5-pro clips (5s).
 
 ---
 
@@ -88,14 +112,18 @@ $5 covers ~5,000 market queries, ~500 Exa searches, or ~250 image generations.
 
 | 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 | $0.03–0.30/sec |
+| `blockrun_music` | MiniMax music generation | per track |
+| `blockrun_price` | Pyth-backed realtime + OHLC — crypto / FX / commodity (free), 12 stock markets (paid) | free or $0.001/call |
 | `blockrun_markets` | Polymarket, Kalshi, dFlow, Binance Futures | $0.001/query |
+| `blockrun_x` | X/Twitter — profiles, tweets, followers, mentions, search (AttentionVC) | per call |
 | `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_search` | Grok Live Search — web + news with citations | ~$0.025 per source |
 | `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 |
+| `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

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { readFileSync } from "fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -116,8 +117,8 @@ var MODEL_TIERS = {
   powerful: ["openai/gpt-5.4-pro", "anthropic/claude-opus-4.7", "anthropic/claude-opus-4.6", "openai/o3", "openai/gpt-5.4"],
   cheap: ["zai/glm-5", "zai/glm-5-turbo", "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", "moonshot/kimi-k2.6", "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", "nvidia/glm-4.7"],
-  coding: ["zai/glm-5", "openai/gpt-5.3-codex", "moonshot/kimi-k2.6", "nvidia/qwen3-coder-480b", "nvidia/devstral-2-123b", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4"],
+  free: ["nvidia/qwen3-next-80b-a3b-thinking", "nvidia/mistral-small-4-119b", "nvidia/gpt-oss-120b", "nvidia/deepseek-v3.2", "nvidia/qwen3-coder-480b", "nvidia/llama-4-maverick", "nvidia/gpt-oss-20b", "nvidia/glm-4.7"],
+  coding: ["zai/glm-5", "openai/gpt-5.3-codex", "moonshot/kimi-k2.6", "nvidia/qwen3-coder-480b", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4"],
   glm: ["zai/glm-5", "zai/glm-5-turbo", "nvidia/glm-4.7"]
 };
 
@@ -610,13 +611,14 @@ Generation models:
 - 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 (default for edits)`,
+Edit models: openai/gpt-image-1, openai/gpt-image-2 (default for edits)`,
       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", "xai/grok-imagine-image", "xai/grok-imagine-image-pro"]).optional().describe("Model to use (default: dall-e-3 for generate, gpt-image-1 for edit). xai/grok-imagine-image is stylized and fast; xai/grok-imagine-image-pro is higher quality."),
+        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."),
         image: z4.string().optional().describe("Source image for edit action: base64-encoded image or URL"),
         size: z4.enum(["1024x1024", "1792x1024", "1024x1792"]).optional().default("1024x1024"),
         quality: z4.enum(["standard", "hd"]).optional().default("standard")
@@ -634,7 +636,7 @@ Edit models: openai/gpt-image-1 (default for edits)`,
             };
           }
           response = await imgClient.edit(prompt, image, {
-            model: model || "openai/gpt-image-1",
+            model: model || "openai/gpt-image-2",
             size
           });
         } else {
@@ -824,41 +826,46 @@ import {
   extractPaymentDetails as extractPaymentDetails2
 } from "@blockrun/llm";
 var BLOCKRUN_API2 = "https://blockrun.ai/api";
-var VIDEO_TIMEOUT = 3e5;
+var TOTAL_BUDGET_MS = 3e5;
+var POLL_INTERVAL_MS = 5e3;
 function registerVideoTool(server) {
   server.registerTool(
     "blockrun_video",
     {
-      description: `Generate short AI videos via BlockRun x402.
+      description: `Generate short AI videos via BlockRun x402 (async, client-polled).
 
-Uses xAI's Grok Imagine Video to turn a text prompt (and optional seed image) into an 8-second MP4 clip. The call blocks until the video is ready (30-120s typical).
+Turns a text prompt (and optional seed image) into a short MP4 clip. The tool submits the job, then polls until the video is ready (typical total wall-time 60-180s; 5 min hard cap). Payment is settled only when upstream returns a finished video \u2014 if the job fails or we give up, you are not charged.
 
-Model: xai/grok-imagine-video ($0.05/sec, 8s default -> $0.42/clip)
+Models:
+- xai/grok-imagine-video ($0.05/sec, 8s default -> $0.42/clip) \u2014 stylized, fast
+- bytedance/seedance-1.5-pro ($0.03/sec, 720p, 5s default up to 10s) \u2014 cheapest
+- bytedance/seedance-2.0-fast ($0.15/sec, ~60-80s gen) \u2014 sweet-spot price/quality
+- bytedance/seedance-2.0 ($0.30/sec, 720p Pro) \u2014 highest quality
 
 Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GCS so URLs don't expire).`,
       inputSchema: {
         prompt: z6.string().describe("Text description of the video to generate. E.g. 'a red apple slowly spinning on a wooden table', 'a hummingbird hovering near a red flower, ultra slow motion'"),
         image_url: z6.string().url().optional().describe("Optional seed image URL for image-to-video generation"),
-        duration_seconds: z6.number().int().min(1).max(60).optional().describe("Duration to bill for (defaults to the model's 8s default). Must not exceed max_duration_seconds."),
-        model: z6.enum(["xai/grok-imagine-video"]).optional().default("xai/grok-imagine-video").describe("Video model to use")
+        duration_seconds: z6.number().int().min(1).max(60).optional().describe("Duration to bill for (defaults to the model's default \u2014 8s for xAI, 5s for Seedance; Seedance supports up to 10s)."),
+        model: z6.enum(["xai/grok-imagine-video", "bytedance/seedance-1.5-pro", "bytedance/seedance-2.0-fast", "bytedance/seedance-2.0"]).optional().default("xai/grok-imagine-video").describe("Video model to use")
       }
     },
     async ({ prompt, image_url, duration_seconds, model }) => {
       try {
         const privateKey = getOrCreateWalletKey();
         const account = privateKeyToAccount2(privateKey);
-        const url = `${BLOCKRUN_API2}/v1/videos/generations`;
+        const submitUrl = `${BLOCKRUN_API2}/v1/videos/generations`;
         const body = { model, prompt };
         if (image_url) body.image_url = image_url;
         if (duration_seconds !== void 0) body.duration_seconds = duration_seconds;
-        const resp402 = await fetchWithTimeout2(url, {
+        const resp402 = await fetchWithTimeout2(submitUrl, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(body)
         }, 15e3);
         if (resp402.status !== 402) {
-          const data2 = await resp402.json();
-          throw new Error(`Expected 402, got ${resp402.status}: ${JSON.stringify(data2)}`);
+          const data = await resp402.json();
+          throw new Error(`Expected 402, got ${resp402.status}: ${JSON.stringify(data)}`);
         }
         const prHeader = resp402.headers.get("payment-required") || resp402.headers.get("PAYMENT-REQUIRED");
         if (!prHeader) throw new Error("No PAYMENT-REQUIRED header in 402 response");
@@ -871,50 +878,91 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
           details.amount,
           details.network || "eip155:8453",
           {
-            resourceUrl: details.resource?.url || url,
+            resourceUrl: details.resource?.url || submitUrl,
             resourceDescription: details.resource?.description || "BlockRun Video Generation",
-            maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+            // Bump to 10 min so the signed authorization stays valid through the
+            // async polling window. Default (~5 min) is tight when upstream is slow.
+            maxTimeoutSeconds: Math.max(details.maxTimeoutSeconds || 0, 600),
             extra: details.extra
           }
         );
-        const resp = await fetchWithTimeout2(url, {
+        const submitResp = await fetchWithTimeout2(submitUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
             "PAYMENT-SIGNATURE": paymentPayload
           },
           body: JSON.stringify(body)
-        }, VIDEO_TIMEOUT);
-        if (resp.status === 402) {
+        }, 3e4);
+        if (submitResp.status === 402) {
           throw new Error("Payment rejected. Check your wallet balance.");
         }
-        if (!resp.ok) {
-          const errBody = await resp.json().catch(() => ({ error: "Request failed" }));
-          throw new Error(`API error ${resp.status}: ${JSON.stringify(errBody)}`);
+        if (!submitResp.ok && submitResp.status !== 202) {
+          const errBody = await submitResp.json().catch(() => ({ error: "Submit failed" }));
+          throw new Error(`API error ${submitResp.status}: ${JSON.stringify(errBody)}`);
+        }
+        const submitData = await submitResp.json();
+        if (!submitData.id || !submitData.poll_url) {
+          throw new Error(`Submit response missing id/poll_url: ${JSON.stringify(submitData)}`);
+        }
+        const pollAbsoluteUrl = submitData.poll_url.startsWith("http") ? submitData.poll_url : `${BLOCKRUN_API2.replace(/\/api$/, "")}${submitData.poll_url}`;
+        const startedAt = Date.now();
+        let lastStatus = submitData.status || "queued";
+        let completed = null;
+        while (Date.now() - startedAt < TOTAL_BUDGET_MS) {
+          await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+          const pollResp = await fetchWithTimeout2(pollAbsoluteUrl, {
+            method: "GET",
+            headers: { "PAYMENT-SIGNATURE": paymentPayload }
+          }, 9e4);
+          const pollData = await pollResp.json().catch(() => ({}));
+          lastStatus = pollData.status || lastStatus;
+          if (pollResp.status === 202 && (lastStatus === "queued" || lastStatus === "in_progress")) {
+            continue;
+          }
+          if (lastStatus === "failed") {
+            throw new Error(`Upstream generation failed: ${pollData.error || "unknown"}. No payment taken.`);
+          }
+          if (pollResp.ok && lastStatus === "completed") {
+            const clip = pollData.data?.[0];
+            if (!clip?.url) throw new Error("Completed poll missing video URL");
+            completed = {
+              url: clip.url,
+              source_url: clip.source_url,
+              duration_seconds: clip.duration_seconds,
+              request_id: clip.request_id,
+              backed_up: clip.backed_up,
+              modelReturned: pollData.model,
+              txHash: pollResp.headers.get("X-Payment-Receipt") || pollResp.headers.get("x-payment-receipt") || void 0
+            };
+            break;
+          }
+          if (!pollResp.ok && pollResp.status !== 202 && pollResp.status !== 504) {
+            throw new Error(`Poll error ${pollResp.status}: ${JSON.stringify(pollData)}`);
+          }
+        }
+        if (!completed) {
+          throw new Error(`Video generation did not complete within ${Math.round(TOTAL_BUDGET_MS / 1e3)}s (last status: ${lastStatus}). No payment was taken.`);
         }
-        const data = await resp.json();
-        const clip = data.data?.[0];
-        if (!clip?.url) throw new Error("No video URL in response");
-        const txHash = resp.headers.get("X-Payment-Receipt") || resp.headers.get("x-payment-receipt");
         const lines = [
           `\u{1F3AC} Video ready!`,
-          `URL: ${clip.url}`,
-          `Duration: ${clip.duration_seconds ? `${clip.duration_seconds}s` : "8s"}`,
-          `Model: ${data.model || model}`,
-          ...clip.backed_up ? [`Backed up to BlockRun storage (URL is permanent)`] : clip.source_url ? [`Source URL: ${clip.source_url}`] : [],
-          ...clip.request_id ? [`Request ID: ${clip.request_id}`] : [],
-          ...txHash ? [`Tx: ${txHash}`] : []
+          `URL: ${completed.url}`,
+          `Duration: ${completed.duration_seconds ? `${completed.duration_seconds}s` : "8s"}`,
+          `Model: ${completed.modelReturned || model}`,
+          ...completed.backed_up ? [`Backed up to BlockRun storage (URL is permanent)`] : completed.source_url ? [`Source URL: ${completed.source_url}`] : [],
+          ...completed.request_id ? [`Request ID: ${completed.request_id}`] : [],
+          ...completed.txHash ? [`Tx: ${completed.txHash}`] : []
         ];
         return {
           content: [{ type: "text", text: lines.join("\n") }],
           structuredContent: {
-            url: clip.url,
-            ...clip.source_url ? { source_url: clip.source_url } : {},
-            duration_seconds: clip.duration_seconds,
-            model: data.model || model,
-            ...clip.request_id ? { request_id: clip.request_id } : {},
-            ...clip.backed_up !== void 0 ? { backed_up: clip.backed_up } : {},
-            ...txHash ? { txHash } : {}
+            url: completed.url,
+            ...completed.source_url ? { source_url: completed.source_url } : {},
+            duration_seconds: completed.duration_seconds,
+            model: completed.modelReturned || model,
+            ...completed.request_id ? { request_id: completed.request_id } : {},
+            ...completed.backed_up !== void 0 ? { backed_up: completed.backed_up } : {},
+            ...completed.txHash ? { txHash: completed.txHash } : {}
           }
         };
       } catch (err) {
@@ -926,9 +974,9 @@ Error: ${errMsg}` }],
             isError: true
           };
         }
-        if (errMsg.includes("abort") || errMsg.includes("timeout") || errMsg.includes("Timeout") || errMsg.includes("timed out")) {
+        if (errMsg.includes("abort") || errMsg.includes("timeout") || errMsg.includes("Timeout") || errMsg.includes("timed out") || errMsg.includes("did not complete within")) {
           return {
-            content: [{ type: "text", text: `Video generation timed out. xAI's async job didn't complete in time \u2014 please try again.
+            content: [{ type: "text", text: `Video generation timed out. The upstream async job didn't complete in time \u2014 please try again.
 Error: ${errMsg}` }],
             isError: true
           };
@@ -1630,7 +1678,7 @@ function warnOnLeakedKeys() {
   console.error("    3. Reconnect using the local package (signs locally, key");
   console.error("       never leaves your machine):");
   console.error("         claude mcp remove blockrun");
-  console.error("         claude mcp add blockrun npx -y @blockrun/mcp@latest");
+  console.error("         claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest");
   console.error("");
   console.error("  Details: https://github.com/BlockRunAI/blockrun-mcp-server/issues/1");
   console.error("");
@@ -1638,7 +1686,9 @@ function warnOnLeakedKeys() {
 }
 
 // src/index.ts
-var VERSION = "0.7.2";
+var { version: VERSION } = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf-8")
+);
 async function checkForUpdate() {
   try {
     const resp = await fetch("https://registry.npmjs.org/@blockrun/mcp/latest", {
@@ -1647,7 +1697,7 @@ async function checkForUpdate() {
     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`);
+      console.error(`[BlockRun] Run: claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest`);
     }
   } catch {
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.9.0",
+  "version": "0.11.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",
@@ -44,7 +44,7 @@
     "url": "https://github.com/blockrunai/blockrun-mcp/issues"
   },
   "dependencies": {
-    "@blockrun/llm": "^1.8.0",
+    "@blockrun/llm": "^1.9.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "open": "^11.0.0",
     "qrcode": "^1.5.4",