@blockrun/mcp 0.11.0 → 0.13.0

package/README.md

@@ -117,7 +117,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 | $0.03–0.30/sec |
 | `blockrun_music` | MiniMax music generation | per track |
 | `blockrun_price` | Pyth-backed realtime + OHLC — crypto / FX / commodity (free), 12 stock markets (paid) | free or $0.001/call |
-| `blockrun_markets` | Polymarket, Kalshi, dFlow, Binance Futures | $0.001/query |
+| `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_x` | X/Twitter — profiles, tweets, followers, mentions, search (AttentionVC) | per call |
 | `blockrun_exa` | Neural web search (Exa) — research, competitors, papers, URL content | $0.01/query |
 | `blockrun_search` | Grok Live Search — web + news with citations | ~$0.025 per source |

package/dist/index.js

@@ -596,6 +596,7 @@ ${lines.join("\n")}` }],
 
 // src/tools/image.ts
 import { z as z4 } from "zod";
+import { PaymentError } from "@blockrun/llm";
 function registerImageTool(server) {
   server.registerTool(
     "blockrun_image",
@@ -661,7 +662,7 @@ Model: ${model}` }],
         };
       } catch (err) {
         const errMsg = err instanceof Error ? err.message : String(err);
-        if (errMsg.includes("balance") || errMsg.includes("payment") || errMsg.includes("402")) {
+        if (err instanceof PaymentError) {
           return {
             content: [{ type: "text", text: `Image generation requires payment. Run blockrun_wallet with action: "setup" for funding instructions.
 Error: ${errMsg}` }],
@@ -1122,19 +1123,61 @@ function registerMarketsTool(server) {
   server.registerTool(
     "blockrun_markets",
     {
-      description: `Prediction market data. Real-time from Polymarket, Kalshi.
-
-Example paths:
-- "polymarket/events" \u2014 list active events
-- "polymarket/markets" \u2014 list markets
-- "kalshi/markets" \u2014 Kalshi markets
-- "kalshi/markets/KXBTC-25MAR14" \u2014 specific market
-
-$0.001/call.`,
+      description: `Prediction market + derivatives data via Predexon aggregator. Tier 1 = $0.001/call, Tier 2 = $0.005/call.
+
+CANONICAL CROSS-VENUE (Tier 1) \u2014 Predexon v2 unified data layer:
+- markets \u2014 list canonical market/question containers with cross-venue Predexon IDs
+- markets/listings \u2014 venue-native executable listings flattened across canonical markets
+- outcomes/:predexon_id \u2014 resolve a canonical outcome ID to its market context + venue listings
+  Filter with ?venue=polymarket|kalshi|limitless|opinion|predictfun, ?status=, ?category=, ?league=, ?event_id=, ?pagination_key=
+
+POLYMARKET (Tier 1):
+- polymarket/events, polymarket/markets \u2014 list events/markets (filter, sort, paginate)
+- polymarket/markets/keyset, polymarket/events/keyset \u2014 same data, cursor-based keyset pagination (use ?pagination_key=)
+- polymarket/crypto-updown \u2014 crypto up/down markets
+- polymarket/market-price/:token_id \u2014 current/historical price
+- polymarket/candlesticks/:condition_id \u2014 OHLCV by market
+- polymarket/candlesticks/token/:token_id \u2014 OHLCV by single outcome token
+- polymarket/volume-chart/:condition_id \u2014 volume w/ YES/NO split
+- polymarket/orderbooks, polymarket/trades, polymarket/activity
+- polymarket/markets/:token_id/volume, polymarket/markets/:condition_id/open_interest
+- polymarket/positions \u2014 user positions
+- polymarket/leaderboard, polymarket/leaderboard/market/:condition_id
+- polymarket/cohorts/stats, polymarket/market/:condition_id/top-holders
+- polymarket/uma/markets, polymarket/uma/market/:condition_id \u2014 UMA oracle questions/timeline
+
+POLYMARKET (Tier 2 \u2014 wallet/smart-money analytics):
+- polymarket/wallet/:wallet \u2014 full smart-wallet profile
+- polymarket/wallet/:wallet/markets, .../similar
+- polymarket/wallet/pnl/:wallet, .../positions/:wallet, .../volume-chart/:wallet
+- polymarket/wallets/profiles, polymarket/wallets/filter \u2014 batch + AND/OR filter
+- polymarket/market/:condition_id/smart-money, polymarket/markets/smart-activity
+
+WALLET IDENTITY & CLUSTERING (Tier 2) \u2014 cross-context labels + on-chain relationship graph:
+- polymarket/wallet/identity/:wallet \u2014 fetch identity + profile metadata for one wallet
+- polymarket/wallet/identities \u2014 POST { addresses: [...] } for bulk lookup (up to 200 wallets)
+- polymarket/wallet/:address/cluster \u2014 discover wallets connected via on-chain transfers + identity proofs
+
+SPORTS (Tier 1):
+- sports/categories \u2014 list available sports categories
+- sports/markets \u2014 list sports markets grouped by game (filter ?league=, ?sport_type=, ?status=, ?venue=)
+- sports/markets/:game_id \u2014 single sports game with all venue outcomes
+- sports/outcomes/:predexon_id \u2014 equivalent sports outcomes across venues for a Predexon ID
+
+KALSHI (Tier 1): kalshi/markets, kalshi/trades, kalshi/orderbooks
+LIMITLESS / OPINION / PREDICT.FUN (Tier 1): {platform}/markets, {platform}/orderbooks
+DFLOW: dflow/trades (T1), dflow/wallet/positions/:wallet (T2), dflow/wallet/pnl/:wallet (T2)
+BINANCE FUTURES (Tier 2): binance/candles/:symbol, binance/ticks/:symbol
+
+CROSS-PLATFORM:
+- matching-markets, matching-markets/pairs \u2014 equivalent markets across Polymarket+Kalshi (T2)
+- markets/search \u2014 search across all platforms in one call (T2)
+
+Pass query params via 'params' (GET). Use 'body' only for POST endpoints (e.g. polymarket/wallet/identities).`,
       inputSchema: {
-        path: z9.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14'"),
-        params: z9.record(z9.string(), z9.string()).optional().describe("Query parameters for GET requests"),
-        body: z9.any().optional().describe("JSON body for POST queries (triggers pmQuery)")
+        path: z9.string().describe("Endpoint path, e.g. 'polymarket/events', 'kalshi/markets/KXBTC-25MAR14', 'polymarket/wallet/0xabc...', 'markets/search'"),
+        params: z9.record(z9.string(), z9.string()).optional().describe("Query parameters for GET requests (e.g. { limit: '20', active: 'true' })"),
+        body: z9.any().optional().describe("JSON body for POST queries (triggers pmQuery \u2014 most endpoints are GET)")
       }
     },
     async ({ path: path3, params, body }) => {

package/package.json

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