@blockrun/mcp 0.21.4 → 0.22.0

package/README.md

@@ -14,6 +14,15 @@ Wallet auto-created. Fund with $5 USDC. Ask Claude anything.
 
 ---
 
+## Documentation
+
+Full docs: **https://blockrun.ai/docs**
+
+- MCP tools & setup: https://blockrun.ai/docs/mcp/blockrun-mcp
+- All BlockRun SDKs & APIs: https://blockrun.ai/docs
+
+---
+
 ## What changes
 
 Before BlockRun, Claude can't answer:
@@ -84,6 +93,25 @@ 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`.
 
+**Tool profiles** — expose a trimmed tool set so the client loads fewer schemas into
+context. Pass `--profile <name>` (or set `BLOCKRUN_MCP_PROFILE`); omit it for the full set.
+
+| Profile | Tools |
+|---------|-------|
+| `full` *(default)* | everything |
+| `media` | `wallet` `models` `image` `video` `realface` `music` `speech` |
+| `trading` | `wallet` `price` `dex` `markets` `surf` `defi` `rpc` |
+| `research` | `wallet` `models` `chat` `search` `exa` `surf` |
+| `chat` | `wallet` `models` `chat` |
+
+```bash
+# e.g. a media-only install
+claude mcp add blockrun-media -s user -- npx -y @blockrun/mcp@latest --profile media
+# or a trading-only install
+claude mcp add blockrun-trading -s user -- npx -y @blockrun/mcp@latest --profile trading
+```
+Equivalent via env: `BLOCKRUN_MCP_PROFILE=trading`. An unknown profile name falls back to `full`. `modal` and `phone` are available in the `full` profile only.
+
 **Claude Desktop** — add to `claude_desktop_config.json`:
 ```json
 {
@@ -117,7 +145,7 @@ ensures `-y` is passed to `npx`, not parsed by `claude mcp add`.
 
 ## Fund your wallet
 
-Run `blockrun_wallet` to see your address. Send USDC on Base.
+Run `blockrun_wallet` to see your address. The server pays on **Base** by default. Send USDC on Base:
 
 | Method | Steps |
 |--------|-------|
@@ -126,6 +154,24 @@ Run `blockrun_wallet` to see your address. Send USDC on Base.
 
 $5 covers ~5,000 market queries, ~500 Exa searches, ~250 image generations, or ~10 Seedance 1.5-pro clips (5s @ 720p+audio, ~$0.46 each).
 
+### Pay on Solana
+
+Prefer to pay in USDC on Solana? It's two tool calls — no env vars, no file editing, no restart:
+
+```
+blockrun_wallet action:"chain" chain:"solana"   # provisions + activates the Solana wallet
+blockrun_wallet action:"setup"                  # shows the Solana address + funding QR
+```
+
+Then send USDC (SPL) on the **Solana** network — from Coinbase (pick "Solana"), Phantom, Solflare, or Backpack. Switch back anytime with `blockrun_wallet action:"chain" chain:"base"`. The server keeps both wallets; switching just changes which one pays.
+
+**Base-only — these fall back to Base regardless of active chain:**
+
+- Tools: `blockrun_image`, `blockrun_music`, `blockrun_speech`, `blockrun_video`, paid stock `blockrun_price`. In Solana mode they return a "switch to Base" message instead of charging.
+- `blockrun_chat routing:"smart"` (ClawRouter) and native Anthropic (`claude-*`) passthrough — on Solana, pass `model:` or `mode:` explicitly.
+
+> Advanced: chain selection can also be forced before startup via files/env (`~/.blockrun/.chain`, `SOLANA_WALLET_KEY`) — see [Environment Variables](#environment-variables). The `action:"chain"` command above is the recommended path.
+
 ---
 
 ## Tools
@@ -261,10 +307,16 @@ Chain selection priority (see `src/utils/wallet.ts`):
 
 **Switching chains:**
 
-- 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)
+The recommended way is the tool itself — it provisions both wallets, applies instantly (no restart), and shows the funding QR:
+
+```
+blockrun_wallet action:"chain" chain:"solana"   # or chain:"base"
+blockrun_wallet action:"setup"                  # funding instructions for the active chain
+```
+
+*Advanced (force a chain before startup, e.g. in CI):* `echo solana > ~/.blockrun/.chain` then set `SOLANA_WALLET_KEY` or create `~/.blockrun/.solana-session`; `echo base > ~/.blockrun/.chain` reuses the existing `.session` (same Base wallet). These edit the same preference file that `action:"chain"` writes — prefer the tool unless you need pre-startup control.
 
-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.
+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 — plus `blockrun_chat routing:"smart"` and native Anthropic (`claude-*`) passthrough. In Solana mode these return a "switch to Base" message instead of charging.
 
 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

@@ -209,6 +209,18 @@ async function getChainBalance(chain, address) {
   return chain === "solana" ? getSolanaUsdcBalance() : getBaseUsdcBalance(address);
 }
 
+// src/utils/model-cache.ts
+var CACHE_TTL_MS = 5 * 60 * 1e3;
+async function loadModels(llm, cache) {
+  if (!cache.models) {
+    cache.models = llm.listAllModels ? await llm.listAllModels() : await llm.listModels();
+    setTimeout(() => {
+      cache.models = null;
+    }, CACHE_TTL_MS).unref();
+  }
+  return cache.models;
+}
+
 // src/tools/wallet.ts
 import { z } from "zod";
 
@@ -376,6 +388,14 @@ Call this to set spending limits before spawning child agents.
 
 The server holds TWO wallets \u2014 one on Base, one on Solana \u2014 but pays on ONE
 active chain at a time. status shows both addresses/balances and which is active.
+Default chain is Base.
+
+To pay on Solana (no env vars, no file editing, no restart):
+  1. action:"chain" chain:"solana"   \u2192 provisions + activates the Solana wallet
+  2. action:"setup"                   \u2192 Solana address + funding QR (send USDC SPL on Solana)
+Switch back with action:"chain" chain:"base". Base-only \u2014 these ignore Solana and
+need Base: blockrun_image, blockrun_music, blockrun_speech, blockrun_video, paid
+blockrun_price, blockrun_chat routing:"smart", and native Anthropic (claude-*).
 
 Actions:
 - status (default): Both wallet addresses + USDC balances, active chain, session spending
@@ -1043,14 +1063,7 @@ function registerModelsTool(server, modelCache) {
       }
     },
     async ({ category, provider }) => {
-      const llm = getClient();
-      if (!modelCache.models) {
-        modelCache.models = "listAllModels" in llm ? await llm.listAllModels() : await llm.listModels();
-        setTimeout(() => {
-          modelCache.models = null;
-        }, 5 * 60 * 1e3);
-      }
-      let models = modelCache.models;
+      let models = await loadModels(getClient(), modelCache);
       if (provider) {
         const p = provider.toLowerCase();
         models = models.filter((m) => m.id.toLowerCase().startsWith(p + "/"));
@@ -1243,6 +1256,26 @@ Error: ${errMsg}` }],
 
 // src/tools/music.ts
 import { z as z5 } from "zod";
+
+// src/utils/http.ts
+async function fetchWithTimeout(url, options, timeoutMs) {
+  const controller = new AbortController();
+  const id = setTimeout(() => controller.abort(), timeoutMs);
+  id.unref?.();
+  try {
+    return await fetch(url, { ...options, signal: controller.signal });
+  } finally {
+    clearTimeout(id);
+  }
+}
+function isTimeoutError(err) {
+  const name = err instanceof Error ? err.name : "";
+  if (name === "AbortError" || name === "TimeoutError") return true;
+  const msg = (err instanceof Error ? err.message : String(err)).toLowerCase();
+  return msg.includes("abort") || msg.includes("timeout") || msg.includes("timed out") || msg.includes("did not complete within");
+}
+
+// src/tools/music.ts
 import { privateKeyToAccount } from "viem/accounts";
 import {
   createPaymentPayload,
@@ -1372,7 +1405,7 @@ Error: ${errMsg}` }],
             isError: true
           };
         }
-        if (errMsg.includes("abort") || errMsg.includes("timeout") || errMsg.includes("Timeout")) {
+        if (isTimeoutError(err)) {
           return {
             content: [{ type: "text", text: `Music generation timed out. This can happen during peak load \u2014 please try again.
 Error: ${errMsg}` }],
@@ -1387,15 +1420,6 @@ Error: ${errMsg}` }],
     }
   );
 }
-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/speech.ts
 import { z as z6 } from "zod";
@@ -1514,7 +1538,7 @@ Returns a hosted audio URL \u2014 download immediately if you need to keep the f
         }
         const privateKey = getOrCreateWalletKey();
         const account = privateKeyToAccount2(privateKey);
-        const resp402 = await fetchWithTimeout2(endpoint, {
+        const resp402 = await fetchWithTimeout(endpoint, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(body)
@@ -1540,7 +1564,7 @@ Returns a hosted audio URL \u2014 download immediately if you need to keep the f
             extra: details.extra
           }
         );
-        const resp = await fetchWithTimeout2(endpoint, {
+        const resp = await fetchWithTimeout(endpoint, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -1593,7 +1617,7 @@ Error: ${errMsg}` }],
             isError: true
           };
         }
-        if (errMsg.includes("abort") || errMsg.includes("timeout") || errMsg.includes("Timeout")) {
+        if (isTimeoutError(err)) {
           return {
             content: [{ type: "text", text: `Speech generation timed out \u2014 please try again.
 Error: ${errMsg}` }],
@@ -1610,7 +1634,7 @@ Error: ${errMsg}` }],
 }
 async function listVoices() {
   try {
-    const resp = await fetchWithTimeout2(`${BLOCKRUN_API2}/v1/audio/voices`, { method: "GET" }, VOICES_TIMEOUT);
+    const resp = await fetchWithTimeout(`${BLOCKRUN_API2}/v1/audio/voices`, { method: "GET" }, VOICES_TIMEOUT);
     if (resp.ok) {
       const payload = await resp.json();
       const voices = payload.data || [];
@@ -1637,15 +1661,6 @@ 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";
@@ -1749,7 +1764,7 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
         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 fetchWithTimeout3(submitUrl, {
+        const resp402 = await fetchWithTimeout(submitUrl, {
           method: "POST",
           headers: { "Content-Type": "application/json" },
           body: JSON.stringify(body)
@@ -1777,7 +1792,7 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
             extra: details.extra
           }
         );
-        const submitResp = await fetchWithTimeout3(submitUrl, {
+        const submitResp = await fetchWithTimeout(submitUrl, {
           method: "POST",
           headers: {
             "Content-Type": "application/json",
@@ -1802,7 +1817,7 @@ Returns a permanent blockrun-hosted MP4 URL (the gateway mirrors the asset to GC
         let completed = null;
         while (Date.now() - startedAt < TOTAL_BUDGET_MS) {
           await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
-          const pollResp = await fetchWithTimeout3(pollAbsoluteUrl, {
+          const pollResp = await fetchWithTimeout(pollAbsoluteUrl, {
             method: "GET",
             headers: { "PAYMENT-SIGNATURE": paymentPayload }
           }, 9e4);
@@ -1866,7 +1881,7 @@ Error: ${errMsg}` }],
             isError: true
           };
         }
-        if (errMsg.includes("abort") || errMsg.includes("timeout") || errMsg.includes("Timeout") || errMsg.includes("timed out") || errMsg.includes("did not complete within")) {
+        if (isTimeoutError(err)) {
           return {
             content: [{ type: "text", text: `Video generation timed out. The upstream async job didn't complete in time \u2014 please try again.
 Error: ${errMsg}` }],
@@ -1881,15 +1896,6 @@ Error: ${errMsg}` }],
     }
   );
 }
-async function fetchWithTimeout3(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/realface.ts
 import { z as z8 } from "zod";
@@ -1901,19 +1907,10 @@ import {
 } from "@blockrun/llm";
 var BLOCKRUN_API4 = "https://blockrun.ai/api";
 var ENROLLMENT_PRICE_USD = 0.01;
-async function fetchWithTimeout4(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);
-  }
-}
 async function payAndPostJson(url, reqBody, fallbackDescription) {
   const privateKey = getOrCreateWalletKey();
   const account = privateKeyToAccount4(privateKey);
-  const resp402 = await fetchWithTimeout4(url, {
+  const resp402 = await fetchWithTimeout(url, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: reqBody
@@ -1939,7 +1936,7 @@ async function payAndPostJson(url, reqBody, fallbackDescription) {
       extra: details.extra
     }
   );
-  const resp = await fetchWithTimeout4(url, {
+  const resp = await fetchWithTimeout(url, {
     method: "POST",
     headers: {
       "Content-Type": "application/json",
@@ -1988,7 +1985,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 fetchWithTimeout4(`${BLOCKRUN_API4}/v1/realface/init`, {
+          const resp = await fetchWithTimeout(`${BLOCKRUN_API4}/v1/realface/init`, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: JSON.stringify(body)
@@ -2037,7 +2034,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 fetchWithTimeout4(`${BLOCKRUN_API4}/v1/realface/status?groupId=${encodeURIComponent(group_id)}`, {
+          const resp = await fetchWithTimeout(`${BLOCKRUN_API4}/v1/realface/status?groupId=${encodeURIComponent(group_id)}`, {
             method: "GET"
           }, 3e4);
           const data = await resp.json().catch(() => ({}));
@@ -2067,8 +2064,8 @@ QR opened for scanning (${qrPath}).`;
         if (action === "list") {
           const account = privateKeyToAccount4(getOrCreateWalletKey());
           const [rfResp, vpResp] = await Promise.all([
-            fetchWithTimeout4(`${BLOCKRUN_API4}/v1/wallet/${account.address}/realfaces`, { method: "GET" }, 3e4),
-            fetchWithTimeout4(`${BLOCKRUN_API4}/v1/wallet/${account.address}/portraits`, { method: "GET" }, 3e4).catch(() => null)
+            fetchWithTimeout(`${BLOCKRUN_API4}/v1/wallet/${account.address}/realfaces`, { method: "GET" }, 3e4),
+            fetchWithTimeout(`${BLOCKRUN_API4}/v1/wallet/${account.address}/portraits`, { method: "GET" }, 3e4).catch(() => null)
           ]);
           const data = await rfResp.json().catch(() => ({}));
           if (!rfResp.ok) {
@@ -2165,7 +2162,7 @@ Enroll one: blockrun_realface action:"init" name:"\u2026" (real person) or actio
           const account = privateKeyToAccount4(privateKey);
           const enrollUrl = `${BLOCKRUN_API4}/v1/realface/enroll`;
           const reqBody = JSON.stringify({ name, image_url, group_id });
-          const resp402 = await fetchWithTimeout4(enrollUrl, {
+          const resp402 = await fetchWithTimeout(enrollUrl, {
             method: "POST",
             headers: { "Content-Type": "application/json" },
             body: reqBody
@@ -2191,7 +2188,7 @@ Enroll one: blockrun_realface action:"init" name:"\u2026" (real person) or actio
               extra: details.extra
             }
           );
-          const resp = await fetchWithTimeout4(enrollUrl, {
+          const resp = await fetchWithTimeout(enrollUrl, {
             method: "POST",
             headers: {
               "Content-Type": "application/json",
@@ -3033,64 +3030,127 @@ Use blockrun_price (free) for plain spot quotes, blockrun_dex (free) for DEX pai
   );
 }
 
+// src/profiles.ts
+var ALL_TOOLS = [
+  "wallet",
+  "chat",
+  "models",
+  "image",
+  "music",
+  "speech",
+  "video",
+  "realface",
+  "search",
+  "exa",
+  "markets",
+  "price",
+  "dex",
+  "modal",
+  "phone",
+  "surf",
+  "rpc",
+  "defi"
+];
+var PROFILES = {
+  full: "all",
+  // Generative media: image/video/realface plus the other media-generation
+  // tools (music, speech), with wallet (funding/balance — media calls cost
+  // USDC) and models (discover what's available).
+  media: ["wallet", "models", "image", "video", "realface", "music", "speech"],
+  // Markets & on-chain data: prediction markets, realtime prices, DEX/CEX
+  // data, DeFi metrics, and raw RPC, plus the wallet for balance/funding.
+  trading: ["wallet", "price", "dex", "markets", "surf", "defi", "rpc"],
+  // Web research & analysis: live search, neural search, Surf's news/SQL,
+  // and chat for synthesis, plus wallet and the model catalogue.
+  research: ["wallet", "models", "chat", "search", "exa", "surf"],
+  // Minimal LLM gateway: just chat + model discovery + wallet.
+  chat: ["wallet", "models", "chat"]
+};
+var DEFAULT_PROFILE = "full";
+function resolveProfileName(argv = process.argv.slice(2), env = process.env) {
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (arg === "--profile") return (argv[i + 1] ?? DEFAULT_PROFILE).toLowerCase();
+    if (arg.startsWith("--profile=")) return arg.slice("--profile=".length).toLowerCase();
+  }
+  if (env.BLOCKRUN_MCP_PROFILE) return env.BLOCKRUN_MCP_PROFILE.toLowerCase();
+  return DEFAULT_PROFILE;
+}
+function resolveTools(argv, env) {
+  const requested = resolveProfileName(argv, env);
+  const spec = PROFILES[requested];
+  if (!spec) {
+    return { profile: DEFAULT_PROFILE, tools: new Set(ALL_TOOLS) };
+  }
+  return {
+    profile: requested,
+    tools: new Set(spec === "all" ? ALL_TOOLS : spec)
+  };
+}
+
 // src/mcp-handler.ts
-function initializeMcpServer(server) {
+function initializeMcpServer(server, profileArgs) {
   const budget = { limit: null, spent: 0, calls: 0, agents: /* @__PURE__ */ new Map() };
   const modelCache = { models: null };
-  registerWalletTool(server, budget);
-  registerChatTool(server, budget);
-  registerModelsTool(server, modelCache);
-  registerImageTool(server, budget);
-  registerMusicTool(server, budget);
-  registerSpeechTool(server, budget);
-  registerVideoTool(server, budget);
-  registerRealfaceTool(server, budget);
-  registerSearchTool(server, budget);
-  registerExaTool(server, budget);
-  registerMarketsTool(server, budget);
-  registerPriceTool(server, budget);
-  registerDexTool(server);
-  registerModalTool(server, budget);
-  registerPhoneTool(server, budget);
-  registerSurfTool(server, budget);
-  registerRpcTool(server, budget);
-  registerDefiTool(server, budget);
-  server.registerResource(
-    "wallet",
-    "blockrun://wallet",
-    { description: "Wallet address and status", mimeType: "application/json" },
-    async () => {
-      const info = await getWalletInfo();
-      return {
-        contents: [{
-          uri: "blockrun://wallet",
-          mimeType: "application/json",
-          text: JSON.stringify(info, null, 2)
-        }]
-      };
-    }
-  );
-  server.registerResource(
-    "models",
-    "blockrun://models",
-    { description: "Available AI models with pricing", mimeType: "application/json" },
-    async () => {
-      const llm = getClient();
-      if (!modelCache.models) {
-        modelCache.models = "listAllModels" in llm ? await llm.listAllModels() : await llm.listModels();
-        setTimeout(() => {
-          modelCache.models = null;
-        }, 5 * 60 * 1e3);
+  const { profile, tools } = resolveTools(profileArgs?.argv, profileArgs?.env);
+  const registrars = {
+    wallet: () => registerWalletTool(server, budget),
+    chat: () => registerChatTool(server, budget),
+    models: () => registerModelsTool(server, modelCache),
+    image: () => registerImageTool(server, budget),
+    music: () => registerMusicTool(server, budget),
+    speech: () => registerSpeechTool(server, budget),
+    video: () => registerVideoTool(server, budget),
+    realface: () => registerRealfaceTool(server, budget),
+    search: () => registerSearchTool(server, budget),
+    exa: () => registerExaTool(server, budget),
+    markets: () => registerMarketsTool(server, budget),
+    price: () => registerPriceTool(server, budget),
+    dex: () => registerDexTool(server),
+    modal: () => registerModalTool(server, budget),
+    phone: () => registerPhoneTool(server, budget),
+    surf: () => registerSurfTool(server, budget),
+    rpc: () => registerRpcTool(server, budget),
+    defi: () => registerDefiTool(server, budget)
+  };
+  for (const [name, register] of Object.entries(registrars)) {
+    if (tools.has(name)) register();
+  }
+  if (tools.has("wallet")) {
+    server.registerResource(
+      "wallet",
+      "blockrun://wallet",
+      { description: "Wallet address and status", mimeType: "application/json" },
+      async () => {
+        const info = await getWalletInfo();
+        return {
+          contents: [{
+            uri: "blockrun://wallet",
+            mimeType: "application/json",
+            text: JSON.stringify(info, null, 2)
+          }]
+        };
       }
-      return {
-        contents: [{
-          uri: "blockrun://models",
-          mimeType: "application/json",
-          text: JSON.stringify(modelCache.models, null, 2)
-        }]
-      };
-    }
-  );
+    );
+  }
+  if (tools.has("models")) {
+    server.registerResource(
+      "models",
+      "blockrun://models",
+      { description: "Available AI models with pricing", mimeType: "application/json" },
+      async () => {
+        const models = await loadModels(getClient(), modelCache);
+        return {
+          contents: [{
+            uri: "blockrun://models",
+            mimeType: "application/json",
+            text: JSON.stringify(models, null, 2)
+          }]
+        };
+      }
+    );
+  }
+  return { profile, tools: [...tools] };
 }
 
 // src/utils/key-leak-scanner.ts
@@ -3190,6 +3250,7 @@ function printHelp() {
       "Options:",
       "  -h, --help       Show this help message",
       "  -v, --version    Print the package version",
+      `      --profile <name>  Tool profile to expose: ${Object.keys(PROFILES).join(" | ")} (default: full)`,
       "",
       "When no metadata flag is provided, the server starts on stdio for MCP clients.",
       ""
@@ -3228,10 +3289,11 @@ async function main() {
     name: "blockrun-mcp",
     version: VERSION
   });
-  initializeMcpServer(server);
+  const { profile, tools } = initializeMcpServer(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(`BlockRun MCP Server started (v${VERSION}) \u2014 stdio transport`);
+  const profileNote = profile === "full" ? `${tools.length} tools` : `profile "${profile}" \u2014 ${tools.length} tools: ${tools.join(", ")}`;
+  console.error(`BlockRun MCP Server started (v${VERSION}) \u2014 stdio transport \u2014 ${profileNote}`);
   checkForUpdate();
 }
 main().catch((error) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.21.4",
+  "version": "0.22.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",
@@ -18,6 +18,7 @@
     "dev": "tsx watch src/index.ts",
     "start": "node dist/index.js",
     "typecheck": "tsc --noEmit",
+    "test": "tsx --test test/*.test.ts",
     "prepublishOnly": "npm run build"
   },
   "keywords": [