SuperAPI AI 工具集

blockrun-mcp

BlockRun MCP 是一个开源的 Model Context Protocol(MCP)服务器,为 Claude 以及任何兼容 MCP 的 AI 代理提供 19 项实时数据与真实交易工具,覆盖 88 个大模型、图像与视频生成、预测市场数据、实时网页与 X 搜索、跨 40 条链的链上查询,以及可在 Polymarket 上下达真实 USDC 结算投注的能力。付费方式有两种:钱包模式使用自托管钱包(Solana 或 Base 上的 USDC),通过 x402 协议按调用次数结算,无需账号、信用卡或订阅;账户模式使用在 user.blockrun.ai 生成的 BlockRun API Key(brk_live_…),由信用卡或电汇充值的账户额度扣费。两种模式提供相同的 19 项工具。该项目以 MIT 许可发布,支持支付确认、额度上限以及自托管密钥保护等机制。

访问官网

工具介绍

BlockRun MCP 是一个开源的 Model Context Protocol 服务器,目标是让 Claude 及任何兼容 MCP 的 AI 代理能够获取实时数据并执行真实操作。它为代理提供 19 项工具,涵盖市场行情、研究、网页搜索、图像、视频、链上数据以及 Polymarket 实时交易,按调用次数付费(pay-per-call)。

主要能力方面,据官方描述,它提供 88 个大模型接入、图像与视频生成、预测市场数据、实时网页与 X/Twitter 搜索、跨 40 条链的链上查询,并支持在 Polymarket 上以 USDC 结算的真实投注。其中 blockrun_polymarket 用于下单,属于需确认的真实交易;多数其他工具用于读取数据。付费调用通过 x402 微支付完成。

使用方式上有两种付费模式,且都通往同一套 19 项工具。钱包模式使用自托管钱包,支持 Solana 或 Base 上的 USDC,无需账号或信用卡,以钱包签名作为身份验证。账户模式使用 BlockRun API Key,先从 user.blockrun.ai 用 Google 登录获取密钥,再通过信用卡或电汇充值额度,服务调用默认经 https://api.blockrun.ai 路由。设置 BLOCKRUN_API_KEY 时优先使用账户模式,取消设置则回到钱包模式。

安装方面,官方推荐在 Claude Code 中执行:claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest。任何可启动 stdio 服务器的 MCP 客户端都可用 command: npx、args: ["-y", "@blockrun/mcp@latest"] 的方式接入。若使用 nvm 或 Homebrew 的 Node,可在 JSON 配置中用 which npx 得到的绝对路径。Grok 客户端默认启动超时 30 秒,首次安装需下载依赖树,官方建议调高 startup_timeout_sec 或先全局安装。

工具配置上可选 --profile <name> 或设置 BLOCKRUN_MCP_PROFILE 来暴露裁剪后的工具集,减少上下文占用。官方称使用 --profile trading 替代默认配置可降低 61% 上下文成本。blockrun_surf 已在 0.49.0 移除,原因是网关对所有 Surf 路径返回 410,相关问题可改用 blockrun_price、blockrun_defi、blockrun_markets 和 blockrun_dex。

费用与安全方面,钱包模式在基础数据价格之上由网关加收固定网络费,Base 上目前为每次调用 $0.001,Solana 网关只报基础价,账户通道不加收该费用。免费层包括 blockrun_chat 的 free 模式、blockrun_dex、blockrun_price 和 blockrun_models。官方举例 $5 大约可覆盖 525 次市场查询、约 500 次 Exa 搜索、约 250 次图像生成或约 14 段 Seedance 1.5-pro 视频片段。开启 BLOCKRUN_CONFIRM_SPEND=on 后,代理在超过阈值的付费调用前会暂停等待批准;BLOCKRUN_BUDGET_LIMIT 可作为预算上限。密钥保存在本机 ~/.blockrun/.session(权限 0600),可选启用 BLOCKRUN_KEYCHAIN=strict 使用系统钥匙串,BlockRun 无法移动用户资金。

适用场景包括:查询预测市场共识、基于信号执行交易(读取再加上下单)、对 Polymarket 大户做资金与盈亏分析、带引用的研究检索、生成带文字的海报图像、语音合成与语音外呼、多代理研究并设置费用上限,以及在 40 条链上执行原始链上读取。限制方面:Polymarket 交易即使在 API Key 模式下仍需要本地密钥对签名;付费调用默认不弹确认对话框的客户端需依赖预算上限保护;官方也说明工具 schema 每轮都会占用上下文,虽有提示词缓存降低美元成本,但上下文窗口成本仍按每轮计算。