@blockrun/mcp 0.8.0 → 0.9.1

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 -y @blockrun/mcp@latest
+claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest
 ```
 
 Wallet auto-created. Fund with $5 USDC. Ask Claude anything.
@@ -49,9 +49,12 @@ After BlockRun, it can. Each query costs fractions of a cent, billed from a loca
 
 **Claude Code (recommended)**
 ```bash
-claude mcp add blockrun npx -y @blockrun/mcp@latest
+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`.
+
 **Claude Desktop** — add to `claude_desktop_config.json`:
 ```json
 {
@@ -66,7 +69,7 @@ claude mcp add blockrun npx -y @blockrun/mcp@latest
 
 **Hosted (no install, always latest)**
 ```bash
-claude mcp add --transport http blockrun https://mcp.blockrun.ai/mcp
+claude mcp add blockrun -s user --transport http https://mcp.blockrun.ai/mcp
 ```
 
 ---

package/dist/index.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
+import { readFileSync } from "fs";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
@@ -8,6 +9,7 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import {
   LLMClient,
   ImageClient,
+  PriceClient,
   getOrCreateWallet,
   getPaymentLinks,
   formatWalletCreatedMessage,
@@ -15,6 +17,7 @@ import {
 } from "@blockrun/llm";
 var _client = null;
 var _imageClient = null;
+var _priceClient = null;
 var _walletInfo = null;
 function ensureWallet() {
   if (!_walletInfo) {
@@ -43,6 +46,13 @@ function getImageClient() {
   }
   return _imageClient;
 }
+function getPriceClient() {
+  if (!_priceClient) {
+    const privateKey = getOrCreateWalletKey();
+    _priceClient = new PriceClient({ privateKey });
+  }
+  return _priceClient;
+}
 function getWalletInfo() {
   const info = ensureWallet();
   const links = getPaymentLinks(info.address);
@@ -103,12 +113,12 @@ var USDC_ADDRESS = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
 var BASE_CHAIN_ID = "8453";
 var MODEL_TIERS = {
   fast: ["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", "openai/gpt-5.3", "google/gemini-3.1-pro"],
-  powerful: ["openai/gpt-5.4-pro", "anthropic/claude-opus-4.6", "anthropic/claude-opus-4.5", "openai/o3", "openai/gpt-5.4"],
+  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"],
+  powerful: ["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: ["openai/o3", "openai/o1", "openai/o3-mini", "deepseek/deepseek-reasoner", "openai/gpt-5.3-codex"],
+  reasoning: ["openai/o3", "openai/o1", "openai/o3-mini", "deepseek/deepseek-reasoner", "moonshot/kimi-k2.6", "openai/gpt-5.3-codex"],
   free: ["nvidia/gpt-oss-120b", "nvidia/deepseek-v3.2", "nvidia/nemotron-ultra-253b", "nvidia/nemotron-super-49b", "nvidia/qwen3-coder-480b", "nvidia/llama-4-maverick", "nvidia/gpt-oss-20b", "nvidia/glm-4.7"],
-  coding: ["zai/glm-5", "openai/gpt-5.3-codex", "nvidia/qwen3-coder-480b", "nvidia/devstral-2-123b", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4"],
+  coding: ["zai/glm-5", "openai/gpt-5.3-codex", "moonshot/kimi-k2.6", "nvidia/qwen3-coder-480b", "nvidia/devstral-2-123b", "anthropic/claude-sonnet-4.6", "openai/gpt-5.4"],
   glm: ["zai/glm-5", "zai/glm-5-turbo", "nvidia/glm-4.7"]
 };
 
@@ -1099,8 +1109,235 @@ $0.001/call.`,
   );
 }
 
-// src/tools/dex.ts
+// src/tools/price.ts
 import { z as z10 } from "zod";
+var CATEGORY = z10.enum(["crypto", "fx", "commodity", "usstock", "stocks"]);
+var MARKET = z10.enum([
+  "us",
+  "hk",
+  "jp",
+  "kr",
+  "gb",
+  "de",
+  "fr",
+  "nl",
+  "ie",
+  "lu",
+  "cn",
+  "ca"
+]);
+var RESOLUTION = z10.enum(["1", "5", "15", "60", "240", "D", "W", "M"]);
+var SESSION = z10.enum(["pre", "post", "on"]);
+var ACTION = z10.enum(["price", "history", "list"]);
+function registerPriceTool(server) {
+  server.registerTool(
+    "blockrun_price",
+    {
+      description: `Realtime quotes and OHLC history for crypto, FX, commodities and 12 global stock markets (Pyth-backed).
+
+- action="price" \u2014 realtime quote for a symbol
+- action="history" \u2014 OHLC bars between from/to (unix seconds)
+- action="list" \u2014 discovery: list available symbols (free)
+
+Pricing:
+- crypto / fx / commodity: FREE across price, history and list
+- stocks / usstock: $0.001 per price or history call (list free)
+
+Stocks markets: us, hk, jp, kr, gb, de, fr, nl, ie, lu, cn, ca (required when category="stocks").
+
+Examples:
+- { action: "price", category: "crypto", symbol: "BTC-USD" }
+- { action: "price", category: "stocks", symbol: "AAPL", market: "us" }
+- { action: "history", category: "crypto", symbol: "ETH-USD", resolution: "D", from: 1700000000, to: 1710000000 }
+- { action: "list", category: "crypto", query: "sol" }`,
+      inputSchema: {
+        action: ACTION.describe("Which endpoint to hit: price, history, or list."),
+        category: CATEGORY.describe("Market category."),
+        symbol: z10.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: z10.number().optional().describe("History window start (unix seconds)."),
+        to: z10.number().optional().describe("History window end (unix seconds)."),
+        query: z10.string().optional().describe("Free-text filter for list."),
+        limit: z10.number().optional().describe("Max items for list (default 100, max 2000).")
+      }
+    },
+    async ({ action, category, symbol, market, session, resolution, from, to, query, limit }) => {
+      try {
+        const priceClient = getPriceClient();
+        if (action === "price") {
+          if (!symbol) throw new Error("symbol is required for action='price'");
+          const result2 = await priceClient.price(category, symbol, {
+            market,
+            session
+          });
+          return {
+            content: [{ type: "text", text: JSON.stringify(result2, null, 2) }],
+            structuredContent: result2
+          };
+        }
+        if (action === "history") {
+          if (!symbol) throw new Error("symbol is required for action='history'");
+          if (!from) throw new Error("from (unix seconds) is required for action='history'");
+          const result2 = await priceClient.history(category, symbol, {
+            market,
+            session,
+            resolution: resolution ?? "D",
+            from,
+            to
+          });
+          return {
+            content: [{ type: "text", text: JSON.stringify(result2, null, 2) }],
+            structuredContent: result2
+          };
+        }
+        const result = await priceClient.listSymbols(category, {
+          market,
+          query,
+          limit
+        });
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: result
+        };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          content: [{ type: "text", text: formatError(msg) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/twitter.ts
+import { z as z11 } from "zod";
+var ACTION2 = z11.enum([
+  "user_lookup",
+  "user_info",
+  "followers",
+  "followings",
+  "verified_followers",
+  "user_tweets",
+  "user_mentions",
+  "tweet_lookup",
+  "tweet_replies",
+  "tweet_thread",
+  "search"
+]);
+function registerTwitterTool(server) {
+  server.registerTool(
+    "blockrun_x",
+    {
+      description: `Structured X/Twitter data via AttentionVC partner API.
+
+Actions:
+- user_lookup (usernames: string | string[])
+- user_info (username)
+- followers (username, cursor?)
+- followings (username, cursor?)
+- verified_followers (user_id, cursor?)
+- user_tweets (username, includeReplies?, cursor?)
+- user_mentions (username, sinceTime?, untilTime?, cursor?)
+- tweet_lookup (tweet_ids: string | string[])
+- tweet_replies (tweet_id, cursor?, queryType?)
+- tweet_thread (tweet_id, cursor?)
+- search (query, queryType?, cursor?)
+
+Paid per request via x402; prices scale with the endpoint (e.g. user_lookup ~ $0.02, followers ~ $0.05/page).`,
+      inputSchema: {
+        action: ACTION2,
+        usernames: z11.union([z11.string(), z11.array(z11.string())]).optional(),
+        username: z11.string().optional(),
+        user_id: z11.string().optional(),
+        tweet_id: z11.string().optional(),
+        tweet_ids: z11.union([z11.string(), z11.array(z11.string())]).optional(),
+        query: z11.string().optional(),
+        queryType: z11.enum(["Latest", "Top", "Default"]).optional(),
+        cursor: z11.string().optional(),
+        sinceTime: z11.string().optional(),
+        untilTime: z11.string().optional(),
+        includeReplies: z11.boolean().optional()
+      }
+    },
+    async (args) => {
+      try {
+        const llm = getClient();
+        const a = args.action;
+        const require2 = (value, name) => {
+          if (value === void 0 || value === null || value === "") {
+            throw new Error(`${name} is required for action='${a}'`);
+          }
+          return value;
+        };
+        let result;
+        switch (a) {
+          case "user_lookup":
+            result = await llm.xUserLookup(require2(args.usernames, "usernames"));
+            break;
+          case "user_info":
+            result = await llm.xUserInfo(require2(args.username, "username"));
+            break;
+          case "followers":
+            result = await llm.xFollowers(require2(args.username, "username"), args.cursor);
+            break;
+          case "followings":
+            result = await llm.xFollowings(require2(args.username, "username"), args.cursor);
+            break;
+          case "verified_followers":
+            result = await llm.xVerifiedFollowers(require2(args.user_id, "user_id"), args.cursor);
+            break;
+          case "user_tweets":
+            result = await llm.xUserTweets(
+              require2(args.username, "username"),
+              args.includeReplies,
+              args.cursor
+            );
+            break;
+          case "user_mentions":
+            result = await llm.xUserMentions(
+              require2(args.username, "username"),
+              args.sinceTime,
+              args.untilTime,
+              args.cursor
+            );
+            break;
+          case "tweet_lookup":
+            result = await llm.xTweetLookup(require2(args.tweet_ids, "tweet_ids"));
+            break;
+          case "tweet_replies":
+            result = await llm.xTweetReplies(
+              require2(args.tweet_id, "tweet_id"),
+              args.queryType,
+              args.cursor
+            );
+            break;
+          case "tweet_thread":
+            result = await llm.xTweetThread(require2(args.tweet_id, "tweet_id"), args.cursor);
+            break;
+          case "search":
+            result = await llm.xSearch(require2(args.query, "query"), args.queryType, args.cursor);
+            break;
+        }
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          structuredContent: result
+        };
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          content: [{ type: "text", text: formatError(msg) }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
+// src/tools/dex.ts
+import { z as z12 } from "zod";
 function registerDexTool(server) {
   server.registerTool(
     "blockrun_dex",
@@ -1117,10 +1354,10 @@ Examples:
   blockrun_dex({ token: "So11...xxx" })    -> Get specific token data
   blockrun_dex({ symbol: "PEPE" })         -> Search by symbol`,
       inputSchema: {
-        query: z10.string().optional().describe("Search query (token name, symbol, or address)"),
-        token: z10.string().optional().describe("Token address for direct lookup"),
-        symbol: z10.string().optional().describe("Token symbol to search"),
-        chain: z10.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
+        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.)")
       }
     },
     async ({ query, token, symbol, chain }) => {
@@ -1181,7 +1418,7 @@ ${lines.join("\n\n")}` }],
 }
 
 // src/tools/modal.ts
-import { z as z11 } from "zod";
+import { z as z13 } from "zod";
 var MODAL_GPU_TYPES = ["T4", "L4", "A10G", "A100", "A100-80GB", "H100"];
 function registerModalTool(server) {
   server.registerTool(
@@ -1201,17 +1438,17 @@ Pricing:
 - create: $0.01
 - exec/status/terminate: $0.001 each`,
       inputSchema: {
-        action: z11.enum(["create", "exec", "status", "terminate"]).describe(
+        action: z13.enum(["create", "exec", "status", "terminate"]).describe(
           "Sandbox action to perform"
         ),
-        sandbox_id: z11.string().optional().describe("Sandbox ID returned by a previous create"),
-        command: z11.array(z11.string()).optional().describe('Command array for exec, for example ["python", "-c", "print(2+2)"]'),
-        image: z11.string().optional().describe("Container image for create (default: python:3.11)"),
-        timeout: z11.number().optional().describe("Timeout in seconds for create or exec"),
-        cpu: z11.number().optional().describe("CPU cores for create"),
-        memory: z11.number().optional().describe("Memory in MB for create"),
-        gpu: z11.enum(MODAL_GPU_TYPES).optional().describe("Optional GPU type for create"),
-        setup_commands: z11.array(z11.string()).optional().describe("Shell commands to run during sandbox setup")
+        sandbox_id: z13.string().optional().describe("Sandbox ID returned by a previous create"),
+        command: z13.array(z13.string()).optional().describe('Command array for exec, for example ["python", "-c", "print(2+2)"]'),
+        image: z13.string().optional().describe("Container image for create (default: python:3.11)"),
+        timeout: z13.number().optional().describe("Timeout in seconds for create or exec"),
+        cpu: z13.number().optional().describe("CPU cores for create"),
+        memory: z13.number().optional().describe("Memory in MB for create"),
+        gpu: z13.enum(MODAL_GPU_TYPES).optional().describe("Optional GPU type for create"),
+        setup_commands: z13.array(z13.string()).optional().describe("Shell commands to run during sandbox setup")
       }
     },
     async ({ action, sandbox_id, command, image, timeout, cpu, memory, gpu, setup_commands }) => {
@@ -1280,6 +1517,8 @@ function initializeMcpServer(server) {
   registerSearchTool(server);
   registerExaTool(server);
   registerMarketsTool(server);
+  registerPriceTool(server);
+  registerTwitterTool(server);
   registerDexTool(server);
   registerModalTool(server);
   server.registerResource(
@@ -1392,7 +1631,7 @@ function warnOnLeakedKeys() {
   console.error("    3. Reconnect using the local package (signs locally, key");
   console.error("       never leaves your machine):");
   console.error("         claude mcp remove blockrun");
-  console.error("         claude mcp add blockrun npx -y @blockrun/mcp@latest");
+  console.error("         claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest");
   console.error("");
   console.error("  Details: https://github.com/BlockRunAI/blockrun-mcp-server/issues/1");
   console.error("");
@@ -1400,7 +1639,9 @@ function warnOnLeakedKeys() {
 }
 
 // src/index.ts
-var VERSION = "0.7.2";
+var { version: VERSION } = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf-8")
+);
 async function checkForUpdate() {
   try {
     const resp = await fetch("https://registry.npmjs.org/@blockrun/mcp/latest", {
@@ -1409,7 +1650,7 @@ async function checkForUpdate() {
     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`);
+      console.error(`[BlockRun] Run: claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest`);
     }
   } catch {
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blockrun/mcp",
-  "version": "0.8.0",
+  "version": "0.9.1",
   "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",
@@ -44,7 +44,7 @@
     "url": "https://github.com/blockrunai/blockrun-mcp/issues"
   },
   "dependencies": {
-    "@blockrun/llm": "^1.5.0",
+    "@blockrun/llm": "^1.8.0",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "open": "^11.0.0",
     "qrcode": "^1.5.4",