@blockrun/mcp 0.6.7 → 0.6.9

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

@@ -653,8 +653,148 @@ Error: ${errMsg}` }],
   );
 }
 
-// src/tools/search.ts
+// src/tools/music.ts
 import { z as z5 } from "zod";
+import { privateKeyToAccount } from "viem/accounts";
+import {
+  createPaymentPayload,
+  parsePaymentRequired,
+  extractPaymentDetails
+} from "@blockrun/llm";
+var BLOCKRUN_API = "https://blockrun.ai/api";
+var MUSIC_TIMEOUT = 2e5;
+function registerMusicTool(server) {
+  server.registerTool(
+    "blockrun_music",
+    {
+      description: `Generate music tracks via BlockRun x402.
+
+Generates a full-length ~3 minute MP3 track. Takes 1-3 minutes to complete.
+
+Models: minimax/music-2.5+ ($0.1575), minimax/music-2.5 ($0.1575)
+
+Returns a time-limited CDN URL \u2014 download immediately if you need to keep the file.`,
+      inputSchema: {
+        prompt: z5.string().describe("Music style, mood, or description. E.g. 'upbeat synthwave with neon pads', 'chill lo-fi beats', 'epic orchestral film score'"),
+        instrumental: z5.boolean().optional().default(true).describe("Generate without vocals (default: true)"),
+        lyrics: z5.string().optional().describe("Custom lyrics. Cannot be used with instrumental: true"),
+        model: z5.enum(["minimax/music-2.5+", "minimax/music-2.5"]).optional().default("minimax/music-2.5+").describe("Music model to use")
+      }
+    },
+    async ({ prompt, instrumental, lyrics, model }) => {
+      try {
+        if (instrumental && lyrics?.trim()) {
+          return {
+            content: [{ type: "text", text: formatError("Cannot specify lyrics when instrumental is true") }],
+            isError: true
+          };
+        }
+        const privateKey = getOrCreateWalletKey();
+        const account = privateKeyToAccount(privateKey);
+        const url = `${BLOCKRUN_API}/v1/audio/generations`;
+        const body = { model, prompt, instrumental };
+        if (lyrics?.trim()) body.lyrics = lyrics.trim();
+        const resp402 = await fetchWithTimeout(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 = parsePaymentRequired(prHeader);
+        const details = extractPaymentDetails(paymentRequired);
+        const paymentPayload = await createPaymentPayload(
+          privateKey,
+          account.address,
+          details.recipient,
+          details.amount,
+          details.network || "eip155:8453",
+          {
+            resourceUrl: details.resource?.url || url,
+            resourceDescription: details.resource?.description || "BlockRun Music Generation",
+            maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+            extra: details.extra
+          }
+        );
+        const resp = await fetchWithTimeout(url, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "PAYMENT-SIGNATURE": paymentPayload
+          },
+          body: JSON.stringify(body)
+        }, MUSIC_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 track = data.data?.[0];
+        if (!track?.url) throw new Error("No track URL in response");
+        const txHash = resp.headers.get("X-Payment-Receipt") || resp.headers.get("x-payment-receipt");
+        const lines = [
+          `\u{1F3B5} Track ready!`,
+          `URL: ${track.url}`,
+          `Duration: ${track.duration_seconds ? `${track.duration_seconds}s` : "~3 min"}`,
+          `Model: ${data.model || model}`,
+          ...track.lyrics ? [`Lyrics: ${track.lyrics.slice(0, 200)}${track.lyrics.length > 200 ? "..." : ""}`] : [],
+          ...txHash ? [`Tx: ${txHash}`] : [],
+          ``,
+          `Note: This URL expires in ~24h. Download it now if you need to keep the file.`
+        ];
+        return {
+          content: [{ type: "text", text: lines.join("\n") }],
+          structuredContent: {
+            url: track.url,
+            duration_seconds: track.duration_seconds,
+            model: data.model || model,
+            ...track.lyrics ? { lyrics: track.lyrics } : {},
+            ...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: `Music 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")) {
+          return {
+            content: [{ type: "text", text: `Music generation timed out. This can happen during peak load \u2014 please try again.
+Error: ${errMsg}` }],
+            isError: true
+          };
+        }
+        return {
+          content: [{ type: "text", text: formatError(`Music generation failed: ${errMsg}`) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+async function fetchWithTimeout(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 z6 } from "zod";
 function registerSearchTool(server) {
   server.registerTool(
     "blockrun_search",
@@ -666,11 +806,11 @@ Pricing: ~$0.01/search
 
 Returns a summary with cited sources.`,
       inputSchema: {
-        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)")
+        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)")
       }
     },
     async ({ query, sources, max_results, from_date, to_date }) => {
@@ -698,7 +838,7 @@ Returns a summary with cited sources.`,
 }
 
 // src/tools/exa.ts
-import { z as z6 } from "zod";
+import { z as z7 } from "zod";
 function registerExaTool(server) {
   server.registerTool(
     "blockrun_exa",
@@ -711,14 +851,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: 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")
+        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")
       }
     },
     async ({ action, query, url, urls, num_results, category, include_domains, exclude_domains }) => {
@@ -771,7 +911,7 @@ Actions:
 }
 
 // src/tools/markets.ts
-import { z as z7 } from "zod";
+import { z as z8 } from "zod";
 function registerMarketsTool(server) {
   server.registerTool(
     "blockrun_markets",
@@ -786,9 +926,9 @@ Example paths:
 
 $0.001/call.`,
       inputSchema: {
-        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)")
+        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)")
       }
     },
     async ({ path: path2, params, body }) => {
@@ -811,7 +951,7 @@ $0.001/call.`,
 }
 
 // src/tools/dex.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 function registerDexTool(server) {
   server.registerTool(
     "blockrun_dex",
@@ -828,10 +968,10 @@ Examples:
   blockrun_dex({ token: "So11...xxx" })    -> Get specific token data
   blockrun_dex({ symbol: "PEPE" })         -> Search by symbol`,
       inputSchema: {
-        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.)")
+        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.)")
       }
     },
     async ({ query, token, symbol, chain }) => {
@@ -899,6 +1039,7 @@ function initializeMcpServer(server) {
   registerChatTool(server, budget);
   registerModelsTool(server, modelCache);
   registerImageTool(server);
+  registerMusicTool(server);
   registerSearchTool(server);
   registerExaTool(server);
   registerMarketsTool(server);
@@ -939,15 +1080,30 @@ function initializeMcpServer(server) {
 }
 
 // src/index.ts
+var VERSION = "0.6.8";
+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.6"
+    version: VERSION
   });
   initializeMcpServer(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("BlockRun MCP Server started (v0.6.6) \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.7",
+  "version": "0.6.9",
   "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",