@blockrun/mcp 0.21.5 → 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

@@ -388,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
@@ -3022,58 +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 models = await loadModels(getClient(), modelCache);
-      return {
-        contents: [{
-          uri: "blockrun://models",
-          mimeType: "application/json",
-          text: JSON.stringify(models, null, 2)
-        }]
-      };
-    }
-  );
+  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)
+          }]
+        };
+      }
+    );
+  }
+  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
@@ -3173,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.",
       ""
@@ -3211,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.5",
+  "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": [