@blockrun/mcp 0.6.0 → 0.6.2

package/README.md

@@ -5,7 +5,7 @@
 [![npm version](https://img.shields.io/npm/v/@blockrun/mcp)](https://www.npmjs.com/package/@blockrun/mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
 
-BlockRun MCP is a Model Context Protocol server that gives Claude Code (and any MCP-compatible agent) access to real-time web search, neural research, prediction markets, crypto DEX data, X/Twitter intelligence, and 41 LLM models — all paid via x402 micropayments in USDC. No API keys. No subscriptions. No accounts.
+BlockRun MCP gives your AI agent access to live data it can't get on its own — real-time web search, neural research, prediction markets, crypto DEX prices, and X/Twitter intelligence. All paid via x402 micropayments in USDC. No API keys. No subscriptions. No accounts.
 
 ---
 
@@ -39,7 +39,7 @@ No Node.js. No npm. Works from any MCP client. Pass your wallet key via `X-Walle
 | `blockrun_markets` | Prediction markets — Polymarket, Kalshi | $0.001/call |
 | `blockrun_dex` | Real-time DEX prices and liquidity via DexScreener | FREE |
 | `blockrun_image` | Image generation and editing (DALL-E 3, Flux) | $0.02–0.08 |
-| `blockrun_chat` | 41 AI models — get a second opinion or use a specialized model | per token |
+| `blockrun_chat` | Second opinion from another model (GPT, Gemini, DeepSeek, etc.) | per token |
 | `blockrun_wallet` | Wallet balance, agent budgets, spending reports | FREE |
 | `blockrun_models` | List all models with pricing | FREE |
 
@@ -94,7 +94,7 @@ Wallet resolution order:
 
 - **Website:** [blockrun.ai](https://blockrun.ai)
 - **npm:** [@blockrun/mcp](https://www.npmjs.com/package/@blockrun/mcp)
-- **Hosted MCP:** [mcp.blockrun.ai](https://mcp.blockrun.ai)
+- **Hosted MCP:** [mcp.blockrun.ai/mcp](https://mcp.blockrun.ai/mcp)
 - **GitHub:** [github.com/blockrunai/blockrun-mcp](https://github.com/blockrunai/blockrun-mcp)
 - **Telegram:** [t.me/+mroQv4-4hGgzOGUx](https://t.me/+mroQv4-4hGgzOGUx)
 - **X:** [@BlockRunAI](https://x.com/BlockRunAI)

package/dist/index.js

@@ -433,35 +433,13 @@ function registerChatTool(server, budget) {
   server.registerTool(
     "blockrun_chat",
     {
-      description: `Chat with 41 AI models from 7 providers via BlockRun micropayments. No API keys needed.
-Recommended for agents: use routing: "smart" to auto-select the optimal model via ClawRouter.
-routing_profile: "free" (zero cost NVIDIA), "eco" (budget), "auto" (balanced, default), "premium" (best quality)
-
-Three ways to use:
-1. ClawRouter (recommended): routing: "smart" \u2014 auto-selects optimal model via 14-dimension AI routing
-2. Direct model: model: "openai/gpt-5.4"
-3. Smart routing: mode: "fast"|"balanced"|"powerful"|"cheap"|"reasoning"|"free"|"coding"
-4. Multi-turn: pass messages[] array (conversation history) \u2014 "message" is appended as the final user turn
-
-All providers (format: provider/model-id):
-\u2022 OpenAI (13): gpt-5.4, gpt-5.4-pro, gpt-5.3, gpt-5.2, gpt-5.4-mini, gpt-5-mini, gpt-5.4-nano, gpt-5.2-pro, gpt-5.3-codex, o1, o1-mini, o3, o3-mini
-\u2022 Anthropic (4): claude-haiku-4.5, claude-sonnet-4.6, claude-opus-4.5, claude-opus-4.6
-\u2022 Google (7): gemini-3.1-pro, gemini-3-pro-preview, gemini-3-flash-preview, gemini-2.5-pro, gemini-2.5-flash, gemini-3.1-flash-lite, gemini-2.5-flash-lite
-\u2022 DeepSeek (2): deepseek-chat, deepseek-reasoner
-\u2022 NVIDIA (12, most FREE*): gpt-oss-120b*, gpt-oss-20b*, kimi-k2.5, nemotron-ultra-253b*, nemotron-3-super-120b*, nemotron-super-49b*, deepseek-v3.2*, mistral-large-3-675b*, qwen3-coder-480b*, devstral-2-123b*, glm-4.7*, llama-4-maverick*
-\u2022 ZAI (2): glm-5, glm-5-turbo
-\u2022 MiniMax (1): minimax-m2.7
-
-Smart routing modes:
-- fast: Gemini Flash, GPT-5 Mini (lowest latency)
-- balanced: GPT-5.4, Claude Sonnet 4.6, Gemini Pro (best default)
-- powerful: GPT-5.4-Pro, Claude Opus 4.6 (highest quality)
-- cheap: NVIDIA free + DeepSeek (lowest cost)
-- reasoning: o3, o1, DeepSeek Reasoner (complex logic)
-- free: All free NVIDIA models (zero cost)
-- coding: GPT-5.3-Codex, Qwen3-Coder, Devstral (code tasks)
-
-Run blockrun_models for live pricing.`,
+      description: `Get a second opinion from another AI model, or use a specialized model for a specific task. Useful when you want to cross-check analysis, use a reasoning model (o3, DeepSeek Reasoner) for hard problems, or use a free NVIDIA model for bulk tasks.
+
+Use routing:"smart" to auto-select the best model, or pick directly: model:"openai/o3", model:"deepseek/deepseek-reasoner", model:"nvidia/deepseek-v3.2" (free).
+
+Prefer blockrun_search or blockrun_exa for research \u2014 they're purpose-built for that.
+
+Run blockrun_models to see all available models with pricing.`,
       inputSchema: {
         message: z2.string().describe("Your message to the AI"),
         model: z2.string().optional().describe("Specific model ID (e.g., 'openai/gpt-4o')"),
@@ -915,6 +893,87 @@ Pricing: $0.001/GET, $0.005/POST`,
   );
 }
 
+// src/tools/dex.ts
+import { z as z9 } from "zod";
+function registerDexTool(server) {
+  server.registerTool(
+    "blockrun_dex",
+    {
+      description: `Get real-time DEX data from DexScreener. FREE - no payment required.
+
+Use for:
+- Token prices and liquidity across chains
+- Trading volume and price changes
+- Finding token pairs and contracts
+
+Examples:
+  blockrun_dex({ query: "SOL" })           -> Search for SOL pairs
+  blockrun_dex({ token: "So11...xxx" })    -> Get specific token data
+  blockrun_dex({ symbol: "PEPE" })         -> Search by symbol`,
+      inputSchema: {
+        query: z9.string().optional().describe("Search query (token name, symbol, or address)"),
+        token: z9.string().optional().describe("Token address for direct lookup"),
+        symbol: z9.string().optional().describe("Token symbol to search"),
+        chain: z9.string().optional().describe("Filter by chain (ethereum, solana, base, etc.)")
+      }
+    },
+    async ({ query, token, symbol, chain }) => {
+      try {
+        let url;
+        let searchTerm = query || symbol || "";
+        if (token) {
+          url = `https://api.dexscreener.com/latest/dex/tokens/${token}`;
+        } else if (searchTerm) {
+          url = `https://api.dexscreener.com/latest/dex/search?q=${encodeURIComponent(searchTerm)}`;
+        } else {
+          return {
+            content: [{ type: "text", text: "Provide query, token address, or symbol" }],
+            isError: true
+          };
+        }
+        const response = await fetch(url);
+        if (!response.ok) {
+          throw new Error(`DexScreener API error: ${response.status}`);
+        }
+        const data = await response.json();
+        let pairs = data.pairs || [];
+        if (chain && pairs.length > 0) {
+          const chainLower = chain.toLowerCase();
+          pairs = pairs.filter((p) => p.chainId.toLowerCase().includes(chainLower));
+        }
+        pairs = pairs.sort((a, b) => (b.volume?.h24 || 0) - (a.volume?.h24 || 0)).slice(0, 10);
+        if (pairs.length === 0) {
+          return {
+            content: [{ type: "text", text: `No pairs found for: ${searchTerm || token}` }]
+          };
+        }
+        const lines = pairs.map((p) => {
+          const price = p.priceUsd ? `$${parseFloat(p.priceUsd).toFixed(6)}` : "N/A";
+          const change = p.priceChange?.h24 ? `${p.priceChange.h24 > 0 ? "+" : ""}${p.priceChange.h24.toFixed(2)}%` : "";
+          const vol = p.volume?.h24 ? `$${(p.volume.h24 / 1e6).toFixed(2)}M` : "";
+          const liq = p.liquidity?.usd ? `$${(p.liquidity.usd / 1e6).toFixed(2)}M liq` : "";
+          const buySell = p.txns?.h24 ? `${p.txns.h24.buys}B/${p.txns.h24.sells}S` : "";
+          return `${p.baseToken.symbol}/${p.quoteToken.symbol} (${p.chainId}/${p.dexId})
+  Price: ${price} ${change} | Vol: ${vol} | ${liq} | Txns: ${buySell}
+  Token: ${p.baseToken.address}`;
+        });
+        return {
+          content: [{ type: "text", text: `[DexScreener - FREE]
+
+${lines.join("\n\n")}` }],
+          structuredContent: { pairs, count: pairs.length }
+        };
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+          content: [{ type: "text", text: `DexScreener error: ${errorMessage}` }],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // src/mcp-handler.ts
 function initializeMcpServer(server) {
   const budget = { limit: null, spent: 0, calls: 0, agents: /* @__PURE__ */ new Map() };
@@ -927,6 +986,7 @@ function initializeMcpServer(server) {
   registerSearchTool(server);
   registerExaTool(server);
   registerMarketsTool(server);
+  registerDexTool(server);
   server.registerResource(
     "wallet",
     "blockrun://wallet",
@@ -966,12 +1026,12 @@ function initializeMcpServer(server) {
 async function main() {
   const server = new McpServer({
     name: "blockrun-mcp",
-    version: "0.6.0"
+    version: "0.6.1"
   });
   initializeMcpServer(server);
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error("BlockRun MCP Server started (v0.6.0) \u2014 stdio transport");
+  console.error("BlockRun MCP Server started (v0.6.1) \u2014 stdio transport");
 }
 main().catch((error) => {
   console.error("Fatal error:", error);

package/package.json

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