@blockrun/mcp 0.7.2 → 0.8.0

package/dist/index.js

@@ -597,15 +597,17 @@ Actions:
 - edit: Transform an existing image using img2img
 
 Generation models:
-- zai/cogview-4 ($0.02) \u2014 Zhipu CogView-4, photorealistic, great for detailed scenes
+- 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/dall-e-3 ($0.04-0.08) \u2014 High quality, prompt adherence
-- together/flux-schnell ($0.02) \u2014 Fast, stylized
-- google/nano-banana \u2014 Google image model
+- google/nano-banana ($0.05) \u2014 Google image model
 Edit models: openai/gpt-image-1 (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"]).optional().describe("Model to use (default: dall-e-3 for generate, gpt-image-1 for edit). zai/cogview-4 is Zhipu's photorealistic model."),
+        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."),
         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")
@@ -804,8 +806,144 @@ async function fetchWithTimeout(url, options, timeoutMs) {
   }
 }
 
-// src/tools/search.ts
+// src/tools/video.ts
 import { z as z6 } from "zod";
+import { privateKeyToAccount as privateKeyToAccount2 } from "viem/accounts";
+import {
+  createPaymentPayload as createPaymentPayload2,
+  parsePaymentRequired as parsePaymentRequired2,
+  extractPaymentDetails as extractPaymentDetails2
+} from "@blockrun/llm";
+var BLOCKRUN_API2 = "https://blockrun.ai/api";
+var VIDEO_TIMEOUT = 3e5;
+function registerVideoTool(server) {
+  server.registerTool(
+    "blockrun_video",
+    {
+      description: `Generate short AI videos via BlockRun x402.
+
+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).
+
+Model: xai/grok-imagine-video ($0.05/sec, 8s default -> $0.42/clip)
+
+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")
+      }
+    },
+    async ({ prompt, image_url, duration_seconds, model }) => {
+      try {
+        const privateKey = getOrCreateWalletKey();
+        const account = privateKeyToAccount2(privateKey);
+        const url = `${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, {
+          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 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 = parsePaymentRequired2(prHeader);
+        const details = extractPaymentDetails2(paymentRequired);
+        const paymentPayload = await createPaymentPayload2(
+          privateKey,
+          account.address,
+          details.recipient,
+          details.amount,
+          details.network || "eip155:8453",
+          {
+            resourceUrl: details.resource?.url || url,
+            resourceDescription: details.resource?.description || "BlockRun Video Generation",
+            maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+            extra: details.extra
+          }
+        );
+        const resp = await fetchWithTimeout2(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "PAYMENT-SIGNATURE": paymentPayload
+          },
+          body: JSON.stringify(body)
+        }, VIDEO_TIMEOUT);
+        if (resp.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)}`);
+        }
+        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}`] : []
+        ];
+        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 } : {}
+          }
+        };
+      } catch (err) {
+        const errMsg = err instanceof Error ? err.message : String(err);
+        if (errMsg.includes("balance") || errMsg.includes("payment") || errMsg.includes("402") || errMsg.includes("rejected")) {
+          return {
+            content: [{ type: "text", text: `Video generation requires payment. Run blockrun_wallet with action: "setup" for funding instructions.
+Error: ${errMsg}` }],
+            isError: true
+          };
+        }
+        if (errMsg.includes("abort") || errMsg.includes("timeout") || errMsg.includes("Timeout") || errMsg.includes("timed out")) {
+          return {
+            content: [{ type: "text", text: `Video generation timed out. xAI's async job didn't complete in time \u2014 please try again.
+Error: ${errMsg}` }],
+            isError: true
+          };
+        }
+        return {
+          content: [{ type: "text", text: formatError(`Video generation failed: ${errMsg}`) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+async function fetchWithTimeout2(url, options, timeoutMs) {
+  const controller = new AbortController();
+  const id = setTimeout(() => controller.abort(), timeoutMs);
+  try {
+    return await fetch(url, { ...options, signal: controller.signal });
+  } finally {
+    clearTimeout(id);
+  }
+}
+
+// src/tools/search.ts
+import { z as z7 } from "zod";
 function registerSearchTool(server) {
   server.registerTool(
     "blockrun_search",
@@ -817,11 +955,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: z7.string().describe("Search query"),
+        sources: z7.array(z7.enum(["web", "x", "news"])).optional().describe("Sources to search (default: web + x + news)"),
+        max_results: z7.number().optional().default(10).describe("Max results per source (1-20)"),
+        from_date: z7.string().optional().describe("Start date filter (YYYY-MM-DD)"),
+        to_date: z7.string().optional().describe("End date filter (YYYY-MM-DD)")
       }
     },
     async ({ query, sources, max_results, from_date, to_date }) => {
@@ -849,7 +987,7 @@ Returns a summary with cited sources.`,
 }
 
 // src/tools/exa.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 function registerExaTool(server) {
   server.registerTool(
     "blockrun_exa",
@@ -862,14 +1000,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: z8.enum(["search", "answer", "contents", "similar"]).describe("Action to perform"),
+        query: z8.string().optional().describe("Natural language query (for search/answer)"),
+        url: z8.string().optional().describe("Reference URL to find similar pages (for similar action)"),
+        urls: z8.array(z8.string()).optional().describe("URLs to fetch content from (for contents action, up to 100)"),
+        num_results: z8.number().optional().describe("Number of results to return (default: 10)"),
+        category: z8.string().optional().describe("Category filter: 'news', 'research paper', 'company', 'tweet', 'github', 'pdf'"),
+        include_domains: z8.array(z8.string()).optional().describe("Only search within these domains"),
+        exclude_domains: z8.array(z8.string()).optional().describe("Exclude these domains from results")
       }
     },
     async ({ action, query, url, urls, num_results, category, include_domains, exclude_domains }) => {
@@ -922,7 +1060,7 @@ Actions:
 }
 
 // src/tools/markets.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 function registerMarketsTool(server) {
   server.registerTool(
     "blockrun_markets",
@@ -937,9 +1075,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: z9.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14'"),
+        params: z9.record(z9.string(), z9.string()).optional().describe("Query parameters for GET requests"),
+        body: z9.any().optional().describe("JSON body for POST queries (triggers pmQuery)")
       }
     },
     async ({ path: path3, params, body }) => {
@@ -962,7 +1100,7 @@ $0.001/call.`,
 }
 
 // src/tools/dex.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 function registerDexTool(server) {
   server.registerTool(
     "blockrun_dex",
@@ -979,10 +1117,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: z10.string().optional().describe("Search query (token name, symbol, or address)"),
+        token: z10.string().optional().describe("Token address for direct lookup"),
+        symbol: z10.string().optional().describe("Token symbol to search"),
+        chain: z10.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
       }
     },
     async ({ query, token, symbol, chain }) => {
@@ -1043,7 +1181,7 @@ ${lines.join("\n\n")}` }],
 }
 
 // src/tools/modal.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 var MODAL_GPU_TYPES = ["T4", "L4", "A10G", "A100", "A100-80GB", "H100"];
 function registerModalTool(server) {
   server.registerTool(
@@ -1063,17 +1201,17 @@ Pricing:
 - create: $0.01
 - exec/status/terminate: $0.001 each`,
       inputSchema: {
-        action: z10.enum(["create", "exec", "status", "terminate"]).describe(
+        action: z11.enum(["create", "exec", "status", "terminate"]).describe(
           "Sandbox action to perform"
         ),
-        sandbox_id: z10.string().optional().describe("Sandbox ID returned by a previous create"),
-        command: z10.array(z10.string()).optional().describe('Command array for exec, for example ["python", "-c", "print(2+2)"]'),
-        image: z10.string().optional().describe("Container image for create (default: python:3.11)"),
-        timeout: z10.number().optional().describe("Timeout in seconds for create or exec"),
-        cpu: z10.number().optional().describe("CPU cores for create"),
-        memory: z10.number().optional().describe("Memory in MB for create"),
-        gpu: z10.enum(MODAL_GPU_TYPES).optional().describe("Optional GPU type for create"),
-        setup_commands: z10.array(z10.string()).optional().describe("Shell commands to run during sandbox setup")
+        sandbox_id: z11.string().optional().describe("Sandbox ID returned by a previous create"),
+        command: z11.array(z11.string()).optional().describe('Command array for exec, for example ["python", "-c", "print(2+2)"]'),
+        image: z11.string().optional().describe("Container image for create (default: python:3.11)"),
+        timeout: z11.number().optional().describe("Timeout in seconds for create or exec"),
+        cpu: z11.number().optional().describe("CPU cores for create"),
+        memory: z11.number().optional().describe("Memory in MB for create"),
+        gpu: z11.enum(MODAL_GPU_TYPES).optional().describe("Optional GPU type for create"),
+        setup_commands: z11.array(z11.string()).optional().describe("Shell commands to run during sandbox setup")
       }
     },
     async ({ action, sandbox_id, command, image, timeout, cpu, memory, gpu, setup_commands }) => {
@@ -1138,6 +1276,7 @@ function initializeMcpServer(server) {
   registerModelsTool(server, modelCache);
   registerImageTool(server);
   registerMusicTool(server);
+  registerVideoTool(server);
   registerSearchTool(server);
   registerExaTool(server);
   registerMarketsTool(server);

package/package.json

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