@blockrun/mcp 0.18.1 → 0.19.0

package/README.md

@@ -142,6 +142,7 @@ $5 covers ~5,000 market queries, ~500 Exa searches, ~250 image generations, or ~
 | `blockrun_video` | xAI Grok Imagine Video + ByteDance Seedance 1.5/2.0/2.0-fast (720p + audio defaults); RealFace asset → real-person video | $0.05–0.298/sec |
 | `blockrun_realface` | Enroll a real person (phone liveness → `ta_xxxx` asset) for Seedance 2.0 real-person video | free; $0.01 to enroll |
 | `blockrun_music` | MiniMax music generation | per track |
+| `blockrun_speech` | ElevenLabs text-to-speech (Flash/Turbo/Multilingual/v3, 8 voice aliases) + cinematic sound effects; free voice listing | $0.05–0.10/1k chars; $0.0525/effect |
 | `blockrun_price` | Pyth-backed realtime + OHLC — crypto / FX / commodity (free), 12 stock markets (paid) | free or $0.001/call |
 | `blockrun_markets` | Polymarket (markets, candles, trades, orderbooks, leaderboards, smart-wallet PnL/clusters, UMA oracle), Kalshi, Limitless, Opinion, Predict.Fun, dFlow, Binance Futures, cross-platform match + search | $0.001–0.005/query |
 | `blockrun_surf` | Surf (asksurf.ai) — 84 endpoints: CEX market data, on-chain SQL (13 chains, 80+ ClickHouse tables), 100M+ labeled wallets, Polymarket + Kalshi side-by-side, social mindshare, news, search, Surf-1.5 chat with citations | $0.001–0.02/call |
@@ -185,13 +186,16 @@ What kinds of questions can Claude (or any LLM agent) answer once BlockRun MCP i
 5. **Image generation with on-image text**
    > *"Generate a poster announcing GPT-5.5 on BlockRun, retro-futuristic, with the headline 'NOW LIVE'."* → `blockrun_image` + the `image-prompting` skill 5-section framework
 
-6. **Voice phone-out**
+6. **Give your agent a voice**
+   > *"Use blockrun to speak this with the sarah voice."* → `blockrun_speech` action:`speak` (default), `input` + `voice` → hosted MP3 URL. Sound effects via action:`sound_effect`
+
+7. **Voice phone-out**
    > *"Call +1-415-555-... and confirm the appointment on Friday at 3pm."* → `blockrun_phone` path:`voice/call`, body: `{ to, task, from }` (provision `from` first via `phone/numbers/buy`), then poll `voice/call/{call_id}`
 
-7. **Multi-agent research with budget cap**
+8. **Multi-agent research with budget cap**
    > *"Spawn 3 research agents on competing L1 narratives. Cap each at $0.50."* → `blockrun_wallet delegate × 3` → children call `blockrun_chat` + `blockrun_exa` with their `agent_id`
 
-8. **Cross-chain SQL forensics**
+9. **Cross-chain SQL forensics**
    > *"Top 10 tokens by DEX volume on Base in the last 24h."* → `blockrun_surf` path:`onchain/sql`, body: `{ sql: "SELECT..." }`
 
 ---
@@ -261,7 +265,7 @@ Chain selection priority (see `src/utils/wallet.ts`):
 - Base → Solana: `echo solana > ~/.blockrun/.chain`, then set `SOLANA_WALLET_KEY` or create `~/.blockrun/.solana-session`
 - Solana → Base: `echo base > ~/.blockrun/.chain` (the existing `.session` is reused, so it's the same Base wallet)
 
-Some media and paid market-data tools still settle on Base only: `blockrun_image`, `blockrun_music`, `blockrun_video`, and paid stock `blockrun_price` calls. In Solana mode they fail before creating or charging a Base wallet.
+Some media and paid market-data tools still settle on Base only: `blockrun_image`, `blockrun_music`, `blockrun_speech`, `blockrun_video`, and paid stock `blockrun_price` calls. In Solana mode they fail before creating or charging a Base wallet.
 
 The server also runs a non-blocking npm registry check at startup and prints an `Update available` notice to stderr when a newer `@blockrun/mcp` version exists. Upgrade by re-running the install command — no manual `npm update` needed.
 

package/dist/index.js

@@ -229,7 +229,7 @@ var USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var BASE_CHAIN_ID = "8453";
 var MODEL_TIERS = {
   fast: ["google/gemini-3.5-flash", "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", "moonshot/kimi-k2.6", "openai/gpt-5.3", "google/gemini-3.1-pro"],
+  balanced: ["openai/gpt-5.5", "anthropic/claude-sonnet-4.6", "google/gemini-3.1-pro", "moonshot/kimi-k2.6", "openai/gpt-5.3", "openai/gpt-5.4"],
   powerful: ["anthropic/claude-opus-4.8", "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: ["anthropic/claude-opus-4.8", "openai/o3", "openai/o1", "openai/o3-mini", "deepseek/deepseek-reasoner", "moonshot/kimi-k2.6", "openai/gpt-5.3-codex"],
@@ -874,7 +874,7 @@ Run blockrun_models to see all 41+ models with pricing.`,
               z2.object({ type: z2.literal("image_url"), image_url: z2.object({ url: z2.string().describe("https URL or data:<mime>;base64,<...> URI") }) })
             ]))
           ]).describe("Plain text, or an array of parts for multimodal input (text + image_url). Images are honored on the native anthropic/claude-* path.")
-        })).optional().describe("Conversation history for multi-turn context. When provided, 'message' is appended as the final user turn. Use with explicit 'model' param (defaults to 'openai/gpt-5.4' if not specified). Note: if you include a role:'system' entry in messages[], do not also pass the system param to avoid duplicate system messages.")
+        })).optional().describe("Conversation history for multi-turn context. When provided, 'message' is appended as the final user turn. Use with explicit 'model' param (defaults to 'openai/gpt-5.5' if not specified). Note: if you include a role:'system' entry in messages[], do not also pass the system param to avoid duplicate system messages.")
       }
     },
     async ({ message, model, mode, routing, routing_profile, system, max_tokens, temperature, response_format, stop, thinking, agent_id, messages }) => {
@@ -945,7 +945,7 @@ ${result.response}` }],
         }
       }
       if (messages && messages.length > 0) {
-        const targetModel = model || MODEL_TIERS[mode ?? "balanced"]?.[0] || "openai/gpt-5.4";
+        const targetModel = model || MODEL_TIERS[mode ?? "balanced"]?.[0] || "openai/gpt-5.5";
         const fullMessages = [
           ...system ? [{ role: "system", content: system }] : [],
           ...messages,
@@ -1367,7 +1367,7 @@ async function fetchWithTimeout(url, options, timeoutMs) {
   }
 }
 
-// src/tools/video.ts
+// src/tools/speech.ts
 import { z as z6 } from "zod";
 import { privateKeyToAccount as privateKeyToAccount2 } from "viem/accounts";
 import {
@@ -1376,6 +1376,256 @@ import {
   extractPaymentDetails as extractPaymentDetails2
 } from "@blockrun/llm";
 var BLOCKRUN_API2 = "https://blockrun.ai/api";
+var SPEECH_TIMEOUT = 6e4;
+var VOICES_TIMEOUT = 15e3;
+var MARGIN = 1.05;
+var MIN_PAYMENT_USD = 1e-3;
+var SOUND_EFFECT_COST = 0.05 * MARGIN;
+var SPEECH_MODELS = {
+  "elevenlabs/flash-v2.5": { pricePer1kChars: 0.05, maxInputChars: 4e4 },
+  "elevenlabs/turbo-v2.5": { pricePer1kChars: 0.05, maxInputChars: 4e4 },
+  "elevenlabs/multilingual-v2": { pricePer1kChars: 0.1, maxInputChars: 1e4 },
+  "elevenlabs/v3": { pricePer1kChars: 0.1, maxInputChars: 5e3 }
+};
+var VOICE_ALIASES = [
+  { alias: "sarah", description: "Mature, reassuring, confident (default)" },
+  { alias: "george", description: "Warm, captivating storyteller" },
+  { alias: "laura", description: "Enthusiast, quirky" },
+  { alias: "charlie", description: "Deep, confident, energetic" },
+  { alias: "river", description: "Relaxed, neutral, informative" },
+  { alias: "roger", description: "Laid-back, casual, resonant" },
+  { alias: "callum", description: "Husky trickster" },
+  { alias: "harry", description: "Fierce warrior" }
+];
+function speechCost(model, charCount) {
+  const m = SPEECH_MODELS[model];
+  const raw = charCount / 1e3 * (m?.pricePer1kChars ?? 0.05) * MARGIN;
+  return Math.max(raw, MIN_PAYMENT_USD);
+}
+function registerSpeechTool(server, budget) {
+  server.registerTool(
+    "blockrun_speech",
+    {
+      description: `ElevenLabs voice via BlockRun x402 \u2014 speak text aloud, generate sound effects, list voices.
+
+Actions:
+- speak (default): text-to-speech. E.g. "speak this with the sarah voice". Price = chars/1000 \xD7 rate (min $0.001), quoted before payment.
+- sound_effect: cinematic sound effects from a text prompt, up to 22s ($0.0525/clip)
+- voices: list available voices (free)
+
+Models (speak): elevenlabs/flash-v2.5 ($0.05/1k chars, ~75ms, default), elevenlabs/turbo-v2.5 ($0.05/1k), elevenlabs/multilingual-v2 ($0.10/1k, narration), elevenlabs/v3 ($0.10/1k, most expressive)
+
+Voice aliases: sarah (default), george, laura, charlie, river, roger, callum, harry \u2014 or any raw ElevenLabs voice_id.
+
+Returns a hosted audio URL \u2014 download immediately if you need to keep the file.`,
+      inputSchema: {
+        action: z6.enum(["speak", "sound_effect", "voices"]).optional().default("speak").describe("speak: text-to-speech (default). sound_effect: generate a sound effect. voices: list voices (free)."),
+        input: z6.string().optional().describe("speak: text to synthesize. sound_effect: description of the sound, e.g. 'rain on a tin roof, distant thunder' (max 1000 chars)."),
+        voice: z6.string().optional().describe("Voice alias (sarah, george, laura, charlie, river, roger, callum, harry) or raw ElevenLabs voice_id. Default: sarah."),
+        model: z6.enum(["elevenlabs/flash-v2.5", "elevenlabs/turbo-v2.5", "elevenlabs/multilingual-v2", "elevenlabs/v3"]).optional().default("elevenlabs/flash-v2.5").describe("Speech model (speak only)"),
+        response_format: z6.enum(["mp3", "opus", "pcm", "wav"]).optional().default("mp3").describe("Audio format"),
+        speed: z6.number().min(0.7).max(1.2).optional().describe("Playback speed 0.7-1.2 (speak only)"),
+        duration_seconds: z6.number().min(0.5).max(22).optional().describe("Sound effect length in seconds (sound_effect only; default: auto)"),
+        prompt_influence: z6.number().min(0).max(1).optional().describe("How literally to follow the prompt, 0-1 (sound_effect only)"),
+        agent_id: z6.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+      }
+    },
+    async ({ action, input, voice, model, response_format, speed, duration_seconds, prompt_influence, agent_id }) => {
+      try {
+        if (action === "voices") {
+          return await listVoices();
+        }
+        if (getChain() !== "base") {
+          return {
+            content: [{ type: "text", text: formatError("blockrun_speech currently settles on Base only. Switch BlockRun to Base (for example: run blockrun_wallet with action:chain chain:base) and fund the Base wallet with USDC.") }],
+            isError: true
+          };
+        }
+        if (!input?.trim()) {
+          return {
+            content: [{ type: "text", text: formatError(`'input' is required for action:"${action}" \u2014 the text to ${action === "speak" ? "synthesize" : "describe the sound effect"}.`) }],
+            isError: true
+          };
+        }
+        let endpoint;
+        let body;
+        let cost;
+        if (action === "sound_effect") {
+          if (input.length > 1e3) {
+            return {
+              content: [{ type: "text", text: formatError(`Sound effect description too long: ${input.length} characters (max 1000).`) }],
+              isError: true
+            };
+          }
+          endpoint = `${BLOCKRUN_API2}/v1/audio/sound-effects`;
+          body = { model: "elevenlabs/sound-effects", text: input, response_format };
+          if (duration_seconds !== void 0) body.duration_seconds = duration_seconds;
+          if (prompt_influence !== void 0) body.prompt_influence = prompt_influence;
+          cost = SOUND_EFFECT_COST;
+        } else {
+          const modelInfo = SPEECH_MODELS[model] ?? SPEECH_MODELS["elevenlabs/flash-v2.5"];
+          if (input.length > modelInfo.maxInputChars) {
+            return {
+              content: [{ type: "text", text: formatError(`Input too long: ${input.length.toLocaleString("en-US")} characters (max ${modelInfo.maxInputChars.toLocaleString("en-US")} for ${model}). Split the text or use elevenlabs/flash-v2.5 (40k max).`) }],
+              isError: true
+            };
+          }
+          endpoint = `${BLOCKRUN_API2}/v1/audio/speech`;
+          body = { model, input, voice: voice || "sarah", response_format };
+          if (speed !== void 0) body.speed = speed;
+          cost = speechCost(model, input.length);
+        }
+        const budgetCheck = checkBudget(budget, agent_id, cost);
+        if (!budgetCheck.allowed) {
+          return {
+            content: [{ type: "text", text: `${budgetCheck.reason}. Use blockrun_wallet action:"report" to see usage or action:"delegate" to increase agent budget.` }],
+            isError: true
+          };
+        }
+        const privateKey = getOrCreateWalletKey();
+        const account = privateKeyToAccount2(privateKey);
+        const resp402 = await fetchWithTimeout2(endpoint, {
+          method: "POST",
+          headers: { "Content-Type": "application/json" },
+          body: JSON.stringify(body)
+        }, 15e3);
+        if (resp402.status !== 402) {
+          const data2 = await resp402.json().catch(() => ({}));
+          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 || endpoint,
+            resourceDescription: details.resource?.description || "BlockRun Speech",
+            maxTimeoutSeconds: details.maxTimeoutSeconds || 300,
+            extra: details.extra
+          }
+        );
+        const resp = await fetchWithTimeout2(endpoint, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json",
+            "PAYMENT-SIGNATURE": paymentPayload
+          },
+          body: JSON.stringify(body)
+        }, SPEECH_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 audio URL in response");
+        const txHash = resp.headers.get("X-Payment-Receipt") || resp.headers.get("x-payment-receipt");
+        recordSpending(budget, cost, agent_id);
+        const lines = [
+          action === "sound_effect" ? `\u{1F50A} Sound effect ready!` : `\u{1F5E3}\uFE0F Speech ready!`,
+          `URL: ${clip.url}`,
+          `Format: ${clip.format || response_format}`,
+          ...clip.characters !== void 0 ? [`Characters: ${clip.characters}`] : [],
+          ...clip.duration_seconds !== void 0 ? [`Duration: ${clip.duration_seconds}s`] : [],
+          `Model: ${data.model || (action === "sound_effect" ? "elevenlabs/sound-effects" : model)}`,
+          `Cost: $${cost.toFixed(4)}`,
+          ...txHash ? [`Tx: ${txHash}`] : [],
+          ``,
+          `Note: This URL may expire \u2014 download it now if you need to keep the file.`
+        ];
+        return {
+          content: [{ type: "text", text: lines.join("\n") }],
+          structuredContent: {
+            url: clip.url,
+            format: clip.format || response_format,
+            ...clip.characters !== void 0 ? { characters: clip.characters } : {},
+            ...clip.duration_seconds !== void 0 ? { duration_seconds: clip.duration_seconds } : {},
+            model: data.model || (action === "sound_effect" ? "elevenlabs/sound-effects" : model),
+            cost_usd: cost,
+            ...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: `Speech 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: `Speech generation timed out \u2014 please try again.
+Error: ${errMsg}` }],
+            isError: true
+          };
+        }
+        return {
+          content: [{ type: "text", text: formatError(`Speech generation failed: ${errMsg}`) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+async function listVoices() {
+  try {
+    const resp = await fetchWithTimeout2(`${BLOCKRUN_API2}/v1/audio/voices`, { method: "GET" }, VOICES_TIMEOUT);
+    if (resp.ok) {
+      const payload = await resp.json();
+      const voices = payload.data || [];
+      if (voices.length > 0) {
+        const lines2 = voices.map((v) => {
+          const tags = v.labels ? Object.values(v.labels).join(", ") : "";
+          return `- ${v.alias ? `${v.alias} ` : ""}(${v.voice_id})${v.name ? ` \u2014 ${v.name}` : ""}${tags ? ` [${tags}]` : ""}`;
+        });
+        return {
+          content: [{ type: "text", text: `Available voices (pass alias or voice_id as 'voice'):
+${lines2.join("\n")}` }],
+          structuredContent: { voices }
+        };
+      }
+    }
+  } catch {
+  }
+  const lines = VOICE_ALIASES.map((v) => `- ${v.alias} \u2014 ${v.description}`);
+  return {
+    content: [{ type: "text", text: `Built-in voice aliases (pass as 'voice'; full catalog temporarily unavailable):
+${lines.join("\n")}
+
+Any raw ElevenLabs voice_id also works.` }],
+    structuredContent: { voices: VOICE_ALIASES }
+  };
+}
+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/video.ts
+import { z as z7 } from "zod";
+import { privateKeyToAccount as privateKeyToAccount3 } from "viem/accounts";
+import {
+  createPaymentPayload as createPaymentPayload3,
+  parsePaymentRequired as parsePaymentRequired3,
+  extractPaymentDetails as extractPaymentDetails3
+} from "@blockrun/llm";
+var BLOCKRUN_API3 = "https://blockrun.ai/api";
 var TOTAL_BUDGET_MS = 3e5;
 var POLL_INTERVAL_MS = 5e3;
 var VIDEO_PRICE_PER_SECOND = {
@@ -1420,12 +1670,12 @@ RealFace: to generate video of a SPECIFIC real person, first enroll them with bl
 
 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"),
-        real_face_asset_id: z6.string().regex(/^ta_[A-Za-z0-9]+$/, "token360 asset id like 'ta_xxxx'").optional().describe("BytePlus RealFace asset id (from blockrun_realface enroll/list) to generate video of a specific real person. Seedance 2.0 / 2.0-fast only. Mutually exclusive with image_url."),
-        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(["azure/sora-2", "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"),
-        agent_id: z6.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        prompt: z7.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: z7.string().url().optional().describe("Optional seed image URL for image-to-video generation"),
+        real_face_asset_id: z7.string().regex(/^ta_[A-Za-z0-9]+$/, "token360 asset id like 'ta_xxxx'").optional().describe("BytePlus RealFace asset id (from blockrun_realface enroll/list) to generate video of a specific real person. Seedance 2.0 / 2.0-fast only. Mutually exclusive with image_url."),
+        duration_seconds: z7.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: z7.enum(["azure/sora-2", "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"),
+        agent_id: z7.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ prompt, image_url, real_face_asset_id, duration_seconds, model, agent_id }) => {
@@ -1463,13 +1713,13 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
           };
         }
         const privateKey = getOrCreateWalletKey();
-        const account = privateKeyToAccount2(privateKey);
-        const submitUrl = `${BLOCKRUN_API2}/v1/videos/generations`;
+        const account = privateKeyToAccount3(privateKey);
+        const submitUrl = `${BLOCKRUN_API3}/v1/videos/generations`;
         const body = { model: selectedModel, prompt };
         if (image_url) body.image_url = image_url;
         if (real_face_asset_id) body.real_face_asset_id = real_face_asset_id;
         if (duration_seconds !== void 0) body.duration_seconds = duration_seconds;
-        const resp402 = await fetchWithTimeout2(submitUrl, {
+        const resp402 = await fetchWithTimeout3(submitUrl, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(body)
@@ -1480,9 +1730,9 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
         }
         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(
+        const paymentRequired = parsePaymentRequired3(prHeader);
+        const details = extractPaymentDetails3(paymentRequired);
+        const paymentPayload = await createPaymentPayload3(
           privateKey,
           account.address,
           details.recipient,
@@ -1497,7 +1747,7 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
             extra: details.extra
           }
         );
-        const submitResp = await fetchWithTimeout2(submitUrl, {
+        const submitResp = await fetchWithTimeout3(submitUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -1516,13 +1766,13 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
         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 pollAbsoluteUrl = submitData.poll_url.startsWith("http") ? submitData.poll_url : `${BLOCKRUN_API3.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, {
+          const pollResp = await fetchWithTimeout3(pollAbsoluteUrl, {
             method: "GET",
             headers: { "PAYMENT-SIGNATURE": paymentPayload }
           }, 9e4);
@@ -1601,7 +1851,7 @@ Error: ${errMsg}` }],
     }
   );
 }
-async function fetchWithTimeout2(url, options, timeoutMs) {
+async function fetchWithTimeout3(url, options, timeoutMs) {
   const controller = new AbortController();
   const id = setTimeout(() => controller.abort(), timeoutMs);
   try {
@@ -1612,16 +1862,16 @@ async function fetchWithTimeout2(url, options, timeoutMs) {
 }
 
 // src/tools/realface.ts
-import { z as z7 } from "zod";
-import { privateKeyToAccount as privateKeyToAccount3 } from "viem/accounts";
+import { z as z8 } from "zod";
+import { privateKeyToAccount as privateKeyToAccount4 } from "viem/accounts";
 import {
-  createPaymentPayload as createPaymentPayload3,
-  parsePaymentRequired as parsePaymentRequired3,
-  extractPaymentDetails as extractPaymentDetails3
+  createPaymentPayload as createPaymentPayload4,
+  parsePaymentRequired as parsePaymentRequired4,
+  extractPaymentDetails as extractPaymentDetails4
 } from "@blockrun/llm";
-var BLOCKRUN_API3 = "https://blockrun.ai/api";
+var BLOCKRUN_API4 = "https://blockrun.ai/api";
 var ENROLLMENT_PRICE_USD = 0.01;
-async function fetchWithTimeout3(url, options, timeoutMs) {
+async function fetchWithTimeout4(url, options, timeoutMs) {
   const controller = new AbortController();
   const id = setTimeout(() => controller.abort(), timeoutMs);
   try {
@@ -1652,11 +1902,11 @@ Typical flow:
 
 Privacy: BlockRun does not store face/liveness data \u2014 only the asset id, name, and the photo URL you supply.`,
       inputSchema: {
-        action: z7.enum(["init", "status", "enroll", "list"]).describe("What to do"),
-        name: z7.string().min(1).max(64).optional().describe("Display name for the person (required for init and enroll)."),
-        group_id: z7.string().regex(/^legacy_rf_\d+$/).optional().describe("Asset-group id from init (required for status and enroll; pass to init to refresh an expired H5 link)."),
-        image_url: z7.string().url().optional().describe("Public HTTPS URL to a clear front-facing face photo (JPG/PNG/WEBP, \u226410MB). Required for enroll."),
-        agent_id: z7.string().optional().describe("Agent identifier for budget tracking and enforcement (enroll only).")
+        action: z8.enum(["init", "status", "enroll", "list"]).describe("What to do"),
+        name: z8.string().min(1).max(64).optional().describe("Display name for the person (required for init and enroll)."),
+        group_id: z8.string().regex(/^legacy_rf_\d+$/).optional().describe("Asset-group id from init (required for status and enroll; pass to init to refresh an expired H5 link)."),
+        image_url: z8.string().url().optional().describe("Public HTTPS URL to a clear front-facing face photo (JPG/PNG/WEBP, \u226410MB). Required for enroll."),
+        agent_id: z8.string().optional().describe("Agent identifier for budget tracking and enforcement (enroll only).")
       }
     },
     async ({ action, name, group_id, image_url, agent_id }) => {
@@ -1667,7 +1917,7 @@ Privacy: BlockRun does not store face/liveness data \u2014 only the asset id, na
           }
           const body = { name };
           if (group_id) body.groupId = group_id;
-          const resp = await fetchWithTimeout3(`${BLOCKRUN_API3}/v1/realface/init`, {
+          const resp = await fetchWithTimeout4(`${BLOCKRUN_API4}/v1/realface/init`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(body)
@@ -1716,7 +1966,7 @@ QR opened for scanning (${qrPath}).`;
           if (!group_id) {
             return { content: [{ type: "text", text: formatError('group_id is required for action:"status".') }], isError: true };
           }
-          const resp = await fetchWithTimeout3(`${BLOCKRUN_API3}/v1/realface/status?groupId=${encodeURIComponent(group_id)}`, {
+          const resp = await fetchWithTimeout4(`${BLOCKRUN_API4}/v1/realface/status?groupId=${encodeURIComponent(group_id)}`, {
             method: "GET"
           }, 3e4);
           const data = await resp.json().catch(() => ({}));
@@ -1744,8 +1994,8 @@ QR opened for scanning (${qrPath}).`;
           };
         }
         if (action === "list") {
-          const account = privateKeyToAccount3(getOrCreateWalletKey());
-          const resp = await fetchWithTimeout3(`${BLOCKRUN_API3}/v1/wallet/${account.address}/realfaces`, {
+          const account = privateKeyToAccount4(getOrCreateWalletKey());
+          const resp = await fetchWithTimeout4(`${BLOCKRUN_API4}/v1/wallet/${account.address}/realfaces`, {
             method: "GET"
           }, 3e4);
           const data = await resp.json().catch(() => ({}));
@@ -1783,10 +2033,10 @@ Enroll one: blockrun_realface action:"init" name:"\u2026".` }],
             return { content: [{ type: "text", text: `${budgetCheck.reason}. Use blockrun_wallet action:"report" to see usage or action:"delegate" to increase agent budget.` }], isError: true };
           }
           const privateKey = getOrCreateWalletKey();
-          const account = privateKeyToAccount3(privateKey);
-          const enrollUrl = `${BLOCKRUN_API3}/v1/realface/enroll`;
+          const account = privateKeyToAccount4(privateKey);
+          const enrollUrl = `${BLOCKRUN_API4}/v1/realface/enroll`;
           const reqBody = JSON.stringify({ name, image_url, group_id });
-          const resp402 = await fetchWithTimeout3(enrollUrl, {
+          const resp402 = await fetchWithTimeout4(enrollUrl, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: reqBody
@@ -1797,9 +2047,9 @@ Enroll one: blockrun_realface action:"init" name:"\u2026".` }],
           }
           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 = parsePaymentRequired3(prHeader);
-          const details = extractPaymentDetails3(paymentRequired);
-          const paymentPayload = await createPaymentPayload3(
+          const paymentRequired = parsePaymentRequired4(prHeader);
+          const details = extractPaymentDetails4(paymentRequired);
+          const paymentPayload = await createPaymentPayload4(
             privateKey,
             account.address,
             details.recipient,
@@ -1812,7 +2062,7 @@ Enroll one: blockrun_realface action:"init" name:"\u2026".` }],
               extra: details.extra
             }
           );
-          const resp = await fetchWithTimeout3(enrollUrl, {
+          const resp = await fetchWithTimeout4(enrollUrl, {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
@@ -1874,7 +2124,7 @@ Error: ${errMsg}` }],
 }
 
 // src/tools/search.ts
-import { z as z8 } from "zod";
+import { z as z9 } from "zod";
 
 // src/utils/body.ts
 function coerceBody(body) {
@@ -1910,9 +2160,9 @@ Common shape:
 
 Full request shape + worked examples in the \`search\` skill (\`skills/search/SKILL.md\`).`,
       inputSchema: {
-        path: z8.string().optional().default("").describe("Endpoint sub-path under /v1/search/ (default empty = root /v1/search). Reserved for future surfaces."),
-        body: z8.any().optional().describe("Request body. At minimum { query: '...' }. Sent as POST."),
-        agent_id: z8.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        path: z9.string().optional().default("").describe("Endpoint sub-path under /v1/search/ (default empty = root /v1/search). Reserved for future surfaces."),
+        body: z9.any().optional().describe("Request body. At minimum { query: '...' }. Sent as POST."),
+        agent_id: z9.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ path: path5, body, agent_id }) => {
@@ -1943,7 +2193,7 @@ Full request shape + worked examples in the \`search\` skill (\`skills/search/SK
 }
 
 // src/tools/exa.ts
-import { z as z9 } from "zod";
+import { z as z10 } from "zod";
 function estimateExaCost(path5, body) {
   const cleanPath = path5.replace(/^\/+/, "").replace(/^v1\/exa\//, "");
   if (cleanPath === "contents") {
@@ -1968,9 +2218,9 @@ Categories for search: "news", "research paper", "company", "tweet", "github", "
 
 Full request/response shapes + worked research workflows in the \`exa-research\` skill.`,
       inputSchema: {
-        path: z9.string().describe("Endpoint name under /v1/exa/, e.g. 'search', 'answer', 'contents', 'find-similar'"),
-        body: z9.any().optional().describe("JSON body for the call. Sent as POST. Required for all four endpoints."),
-        agent_id: z9.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        path: z10.string().describe("Endpoint name under /v1/exa/, e.g. 'search', 'answer', 'contents', 'find-similar'"),
+        body: z10.any().optional().describe("JSON body for the call. Sent as POST. Required for all four endpoints."),
+        agent_id: z10.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ path: path5, body, agent_id }) => {
@@ -2001,7 +2251,7 @@ Full request/response shapes + worked research workflows in the \`exa-research\`
 }
 
 // src/tools/markets.ts
-import { z as z10 } from "zod";
+import { z as z11 } from "zod";
 function estimateMarketCost(path5, body) {
   if (body !== void 0) return 5e-3;
   const p = path5.toLowerCase();
@@ -2066,10 +2316,10 @@ CROSS-PLATFORM:
 
 Pass query params via 'params' (GET). Use 'body' only for POST endpoints (e.g. polymarket/wallet/identities).`,
       inputSchema: {
-        path: z10.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14', 'polymarket/wallet/0xabc...', 'markets/search'"),
-        params: z10.record(z10.string(), z10.string()).optional().describe("Query parameters for GET requests (e.g. { limit: '20', active: 'true' })"),
-        body: z10.any().optional().describe("JSON body for POST queries (triggers pmQuery \u2014 most endpoints are GET)"),
-        agent_id: z10.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        path: z11.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14', 'polymarket/wallet/0xabc...', 'markets/search'"),
+        params: z11.record(z11.string(), z11.string()).optional().describe("Query parameters for GET requests (e.g. { limit: '20', active: 'true' })"),
+        body: z11.any().optional().describe("JSON body for POST queries (triggers pmQuery \u2014 most endpoints are GET)"),
+        agent_id: z11.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ path: path5, params, body, agent_id }) => {
@@ -2102,9 +2352,9 @@ Pass query params via 'params' (GET). Use 'body' only for POST endpoints (e.g. p
 }
 
 // src/tools/price.ts
-import { z as z11 } from "zod";
-var CATEGORY = z11.enum(["crypto", "fx", "commodity", "usstock", "stocks"]);
-var MARKET = z11.enum([
+import { z as z12 } from "zod";
+var CATEGORY = z12.enum(["crypto", "fx", "commodity", "usstock", "stocks"]);
+var MARKET = z12.enum([
   "us",
   "hk",
   "jp",
@@ -2118,9 +2368,9 @@ var MARKET = z11.enum([
   "cn",
   "ca"
 ]);
-var RESOLUTION = z11.enum(["1", "5", "15", "60", "240", "D", "W", "M"]);
-var SESSION = z11.enum(["pre", "post", "on"]);
-var ACTION = z11.enum(["price", "history", "list"]);
+var RESOLUTION = z12.enum(["1", "5", "15", "60", "240", "D", "W", "M"]);
+var SESSION = z12.enum(["pre", "post", "on"]);
+var ACTION = z12.enum(["price", "history", "list"]);
 function isPaidPriceCall(action, category) {
   return action !== "list" && (category === "stocks" || category === "usstock");
 }
@@ -2148,15 +2398,15 @@ Examples:
       inputSchema: {
         action: ACTION.describe("Which endpoint to hit: price, history, or list."),
         category: CATEGORY.describe("Market category."),
-        symbol: z11.string().optional().describe("Ticker (required for price+history). e.g. BTC-USD, AAPL, EUR-USD."),
+        symbol: z12.string().optional().describe("Ticker (required for price+history). e.g. BTC-USD, AAPL, EUR-USD."),
         market: MARKET.optional().describe("Stock market code \u2014 required when category='stocks'."),
         session: SESSION.optional().describe("Equity session hint (pre/post/on); ignored for non-equity."),
         resolution: RESOLUTION.optional().describe("Bar resolution for history (default D)."),
-        from: z11.number().optional().describe("History window start (unix seconds)."),
-        to: z11.number().optional().describe("History window end (unix seconds)."),
-        query: z11.string().optional().describe("Free-text filter for list."),
-        limit: z11.number().int().positive().max(2e3).optional().describe("Max items for list (default 100, max 2000)."),
-        agent_id: z11.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        from: z12.number().optional().describe("History window start (unix seconds)."),
+        to: z12.number().optional().describe("History window end (unix seconds)."),
+        query: z12.string().optional().describe("Free-text filter for list."),
+        limit: z12.number().int().positive().max(2e3).optional().describe("Max items for list (default 100, max 2000)."),
+        agent_id: z12.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ action, category, symbol, market, session, resolution, from, to, query, limit, agent_id }) => {
@@ -2229,7 +2479,7 @@ Examples:
 }
 
 // src/tools/dex.ts
-import { z as z12 } from "zod";
+import { z as z13 } from "zod";
 function registerDexTool(server) {
   server.registerTool(
     "blockrun_dex",
@@ -2246,10 +2496,10 @@ Examples:
   blockrun_dex({ token: "So11...xxx" })    -> Get specific token data
   blockrun_dex({ symbol: "PEPE" })         -> Search by symbol`,
       inputSchema: {
-        query: z12.string().optional().describe("Search query (token name, symbol, or address)"),
-        token: z12.string().optional().describe("Token address for direct lookup"),
-        symbol: z12.string().optional().describe("Token symbol to search"),
-        chain: z12.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
+        query: z13.string().optional().describe("Search query (token name, symbol, or address)"),
+        token: z13.string().optional().describe("Token address for direct lookup"),
+        symbol: z13.string().optional().describe("Token symbol to search"),
+        chain: z13.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
       }
     },
     async ({ query, token, symbol, chain }) => {
@@ -2310,7 +2560,7 @@ ${lines.join("\n\n")}` }],
 }
 
 // src/tools/modal.ts
-import { z as z13 } from "zod";
+import { z as z14 } from "zod";
 function estimateModalCost(path5) {
   return path5.includes("sandbox/create") ? 0.01 : 1e-3;
 }
@@ -2330,9 +2580,9 @@ Common paths (all POST):
 
 Full action shapes + GPU type details in the \`modal\` skill.`,
       inputSchema: {
-        path: z13.string().describe("Endpoint under /v1/modal/, e.g. 'sandbox/create', 'sandbox/exec'"),
-        body: z13.any().optional().describe("JSON body. Sent as POST."),
-        agent_id: z13.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        path: z14.string().describe("Endpoint under /v1/modal/, e.g. 'sandbox/create', 'sandbox/exec'"),
+        body: z14.any().optional().describe("JSON body. Sent as POST."),
+        agent_id: z14.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ path: path5, body, agent_id }) => {
@@ -2363,7 +2613,7 @@ Full action shapes + GPU type details in the \`modal\` skill.`,
 }
 
 // src/tools/phone.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 function estimatePhoneCost(path5, hasBody) {
   if (!hasBody && path5.startsWith("voice/call/")) return 0;
   if (path5 === "phone/numbers/release") return 0;
@@ -2396,9 +2646,9 @@ Voice presets: nat, josh, maya, june, paige, derek, florian. Phone numbers use E
 
 Voice call flow + voice preset details + full body shapes in the \`phone\` skill.`,
       inputSchema: {
-        path: z14.string().describe("Endpoint after /v1/. Use 'phone/...' for lookup + number ops, 'voice/call' for outbound AI calls, 'voice/call/{id}' (no body) to poll status."),
-        body: z14.any().optional().describe("JSON body. Sent as POST. Omit for the free GET poll (voice/call/{call_id})."),
-        agent_id: z14.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        path: z15.string().describe("Endpoint after /v1/. Use 'phone/...' for lookup + number ops, 'voice/call' for outbound AI calls, 'voice/call/{id}' (no body) to poll status."),
+        body: z15.any().optional().describe("JSON body. Sent as POST. Omit for the free GET poll (voice/call/{call_id})."),
+        agent_id: z15.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ path: path5, body, agent_id }) => {
@@ -2429,7 +2679,7 @@ Voice call flow + voice preset details + full body shapes in the \`phone\` skill
 }
 
 // src/tools/surf.ts
-import { z as z15 } from "zod";
+import { z as z16 } from "zod";
 var SURF_T3_PATHS = /* @__PURE__ */ new Set([
   "onchain/sql",
   "onchain/query",
@@ -2493,10 +2743,10 @@ Common paths (full 84-endpoint catalog in the surf skill):
 Method is auto-routed: pass 'body' for POST endpoints; otherwise GET with 'params'.
 Each Surf endpoint pre-validates required params before settling \u2014 you get a 400 (not a charge) if a required field is missing. Browse the full catalog: https://blockrun.ai/marketplace/surf`,
       inputSchema: {
-        path: z15.string().describe("Endpoint path under /v1/surf/, e.g. 'market/price', 'prediction-market/polymarket/ranking', 'wallet/detail', 'onchain/sql', 'chat/completions'"),
-        params: z15.record(z15.string(), z15.string()).optional().describe("Query parameters for GET endpoints, e.g. { symbol: 'BTC' } or { address: '0x...', chain: 'ethereum' }"),
-        body: z15.any().optional().describe("JSON body for POST endpoints. Provide for: onchain/query, onchain/sql, chat/completions. When set, the call is sent as POST; otherwise GET with params."),
-        agent_id: z15.string().optional().describe("Agent identifier for budget tracking and enforcement.")
+        path: z16.string().describe("Endpoint path under /v1/surf/, e.g. 'market/price', 'prediction-market/polymarket/ranking', 'wallet/detail', 'onchain/sql', 'chat/completions'"),
+        params: z16.record(z16.string(), z16.string()).optional().describe("Query parameters for GET endpoints, e.g. { symbol: 'BTC' } or { address: '0x...', chain: 'ethereum' }"),
+        body: z16.any().optional().describe("JSON body for POST endpoints. Provide for: onchain/query, onchain/sql, chat/completions. When set, the call is sent as POST; otherwise GET with params."),
+        agent_id: z16.string().optional().describe("Agent identifier for budget tracking and enforcement.")
       }
     },
     async ({ path: path5, params, body, agent_id }) => {
@@ -2538,6 +2788,7 @@ function initializeMcpServer(server) {
   registerModelsTool(server, modelCache);
   registerImageTool(server, budget);
   registerMusicTool(server, budget);
+  registerSpeechTool(server, budget);
   registerVideoTool(server, budget);
   registerRealfaceTool(server, budget);
   registerSearchTool(server, budget);

package/package.json

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