blockrun-mcp

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

BlockRun MCP 是一款开源的 Model Context Protocol 服务，为 Claude 及任何兼容 MCP 的 Agent 提供 19 种工具，可用于实时数据和实际操作：88 个大模型、图像和视频生成、预测市场数据、实时网页和 X 搜索、跨 40 条链的链上查询，以及在 Polymarket 上下注并以 USDC 结算的能力。

你按调用付费，付款方式由你选择。钱包模式通过签名进行身份验证，并通过 x402 协议以 USDC 逐次结算调用——无需账户、信用卡或订阅，可在 Solana 或 Base 上使用。账户模式通过 BlockRun API 密钥（brk_live_…）进行身份验证，该密钥可从 user.blockrun.ai 获取；服务调用会经由 api.blockrun.ai 路由，并按实际用量扣除由银行卡或电汇充值的账户余额。两种模式都可使用相同的 19 种工具。采用 MIT 许可证。

🏆 首创——Claude Code 中的信号 → 交易闭环

通过一个自托管钱包，即可读取 Polymarket 实时赔率并下注，按调用付费。跳转至 Polymarket 交易 →

为什么要使用 BlockRun MCP

其他所有数据集成都面向人类开发者打造——创建账户、将 API 密钥复制到 .env、添加信用卡，并为每个供应商重复这一流程。

**BlockRun 提供两种支付方式，无需重新构建集成。**当 Agent 需要自托管资金时，使用钱包；团队需要通过银行卡充值并使用仪表板时，使用账户密钥。

• 一个钱包，访问所有数据源——19 种工具共用一个自托管钱包。无需逐个注册供应商。
• 一个账户密钥，访问所有数据源——在 user.blockrun.ai 创建密钥，通过银行卡或电汇充值，然后 MCP 会携带该密钥调用 api.blockrun.ai。
• 钱包模式无需 API 密钥——钱包签名就是身份验证。
• 钱包模式无需信用卡——通过 x402 以 USDC 按请求付费，每次只需不到一分钱。
• 免费起步——免费层（blockrun_chat mode:"free"、blockrun_dex、加密货币 blockrun_price、blockrun_models）费用为 $0。
• 既能读取，也能操作——大多数工具用于获取数据；blockrun_polymarket 可执行真实交易，并要求确认。
• 人工审核付款——启用 BLOCKRUN_CONFIRM_SPEND=on 后，Agent 会在任何超过你设定阈值的付费调用前暂停；只有你批准后才会签名。查看详情 ↓
• 生成式 UI——在 Claude Desktop、claude.ai、VS Code 和 Cursor 上，Polymarket 预览会显示为带有“下单”按钮的实时订单卡片；钱包则会显示余额、二维码和银行卡充值面板。MCP Apps ↓
• 自托管——你的密钥不会离开本机（保存在 ~/.blockrun/.session 中，权限为 0600；选择启用 BLOCKRUN_KEYCHAIN=strict 后则存入操作系统钥匙串）。BlockRun 无法转移你的资金。

对比

✓ 一个钱包或一个账户密钥 · ✓ 按次付费 · ✓ 可读取并且交易 · ✓ 多链 · ✓ 为 Agent 做好准备 · ✓ 开源

有何变化

使用 BlockRun 之前，Claude 无法回答：

• “目前 Polymarket 对比特币今年涨到 $100k 的概率怎么看？”
• “帮我找出过去 30 天发表的 RAG 领域排名前 5 的论文。”
• “现在人们在 X 上怎么评价 @sama？”
• “Uniswap 上 PEPE/ETH 交易对的 24 小时交易量是多少？”
• “Polymarket 显示美联储维持利率不变的概率为 73%——在上面下注 $2。” ← 现在它还能执行交易，而不只是读取赔率。

使用 BlockRun 之后，它就能做到。每次查询的费用不到一美分——从本地 USDC 钱包扣款，或通过 api.blockrun.ai 从 BlockRun 账户中由银行卡充值的余额扣款。无需订阅，也无需逐个供应商注册。

快速开始

0. 选择付款方式

两种模式都可以使用相同的 19 个工具。账户模式默认将服务调用发送到 https://api.blockrun.ai。你可以随时切换；设置 BLOCKRUN_API_KEY 后会优先使用该密钥，否则将使用钱包。

1. 安装

Claude Code（推荐）

claude mcp add blockrun -s user -- npx -y @blockrun/mcp@latest

-s user 会进行全局安装（在每个项目中都可用）。分隔符 -- 可确保 -y 传递给 npx，而不是被 claude mcp add 解析。

💡 **Homebrew / nvm 用户：**如果服务无法连接，Claude Code 可能无法在其启动器 PATH 中找到 node/npx。传入 shell PATH 即可——适用于 CLI 和桌面版：

claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest

如果问题仍然存在，请参阅故障排除。 每款 MCP 客户端——一条命令或一个 JSON 配置块。已验证 = 我们在该客户端上运行了已发布的程序包，并看到列出的工具（客户端版本 · 日期）。有文档记录 = 安装方式来自客户端自己的文档；我们尚未亲自运行——如果你发现它能用，请告诉我们。消费对话框列表示客户端是否会显示人在回路中的付款提示；在 ❌ 客户端上，付费调用会直接继续，不会询问，而 BLOCKRUN_BUDGET_LIMIT 是保护措施。

任何能够启动 stdio 服务的其他 MCP 客户端也都可以用同样的方式：command: npx、args: ["-y", "@blockrun/mcp@latest"]。对于使用 nvm/Homebrew Node 的 JSON 配置客户端，请将 which npx 输出的绝对路径填入 command。“消费对话框”的资料来源，以及“不经询问直接继续”的含义：docs/spend-confirmation.md。

Grok——安装前先调高启动超时时间，否则首次运行看起来会像是出了问题。 Grok 等待 MCP 服务响应的时间由 startup_timeout_sec 决定，默认值为 30 （xAI 的 MCP 文档）。首次运行 npx -y 时，必须先下载此程序包及其依赖树，之后服务才能响应，因此下载速度会影响能否赶上超时：在 npm 缓存为空的情况下实测，快速连接耗时 17 秒，较慢的共享主机耗时 42-46 秒。如果超时，grok mcp doctor blockrun 会显示 server timed out (no response within 30s)，界面则会显示 blockrun [unavailable]——这实际上是安装成功了，但因超时而无法使用，看起来和安装失败无法区分。

请在 ~/.grok/config.toml（或单个项目的 .grok/config.toml）中为其留出充足时间：

[mcp_servers.blockrun]
command = "npx"
args = ["-y", "@blockrun/mcp@latest"]
enabled = true
startup_timeout_sec = 120

或者完全跳过首次下载；从第二次运行开始，这种方式会更快：

npm install -g @blockrun/mcp@latest
grok mcp add blockrun -- blockrun-mcp

只有首次运行会耗费这段时间：npx 会按精确的程序包规格缓存，因此之后启动时缓存已就绪（这里约 9 秒）。任何设有启动超时的客户端都可能遇到同样的问题——如果全新安装显示为不可用，但在终端中运行 npx -y @blockrun/mcp@latest 一切正常，请调高客户端的超时时间，或全局安装，然后再排查其他问题。感谢 @0xCheetah1 提供此报告。

OpenClaw： 已于 2026.8.2 对发布的 npx 程序包进行了端到端验证：20 个工具均已展示（Surf 下架后为 19 个），免费调用正常，付费 x402 调用也已结算。安装时请设置会话硬上限：

openclaw mcp set blockrun '{"command":"npx","args":["-y","@blockrun/mcp@latest"],"env":{"BLOCKRUN_BUDGET_LIMIT":"2"}}'
openclaw mcp doctor blockrun --probe

消费确认取决于 OpenClaw 运行时和聊天界面。其 Codex 测试框架支持 MCP 表单引导，但无法映射的提示会被视为明确拒绝；在此处测试的 WebChat → Codex 路径中，BLOCKRUN_CONFIRM_SPEND=on 会拒绝付费调用，却不会显示可操作的对话框。请在该路径上关闭确认，并依赖 BLOCKRUN_BUDGET_LIMIT 和 OpenClaw 自身的工具审批模式。

{
  "mcpServers": {
    "blockrun": { "command": "npx", "args": ["-y", "@blockrun/mcp@latest"] }
  }
}

2. 选择工具配置（可选）

公开精简的工具集，让客户端在上下文中加载更少的架构。传入 --profile <name>（或设置 BLOCKRUN_MCP_PROFILE）；省略则使用完整工具集。

blockrun_surf 已在 0.49.0 中移除：自 2026-09-06 起，网关对所有 Surf（asksurf.ai）路径都返回 410，因此该工具只会返回错误，而且它的架构会在每轮对话中占用每个 Agent 的上下文。这些问题现由 blockrun_price、blockrun_defi、blockrun_markets 和 blockrun_dex 处理；surf 技能会将原有端点映射到替代端点。

claude mcp add blockrun-trading -s user -- npx -y @blockrun/mcp@latest --profile trading

# Codex CLI
codex mcp add blockrun-trading -- npx -y @blockrun/mcp@latest --profile trading

未知的配置名称会回退到 full。modal 和 phone 仅适用于 full 配置。

各配置占用的上下文

安装 MCP 服务会在每轮对话中占用上下文，无论你是否调用工具——客户端都会将每个工具的架构加载到模型的提示词中，并在整个会话中重复发送。 几十年来，包管理器一直会显示安装大小。几乎没有 MCP 服务会显示这一信息。我们会：

对于相同的交易工作流，使用 --profile trading 而非默认配置，可让上下文开销减少 62%。如果你只询问市场相关内容，这是能做出的最简单、最省开销的调整。

亲自测量——无论是测量我们，还是其他任何 stdio MCP 服务：

npm i gpt-tokenizer
node scripts/measure-tool-schema.mjs                     # this server, every profile
node scripts/measure-tool-schema.mjs -- npx -y @some/other-mcp-server

选项 A — API 密钥 + 账户余额（无需钱包）。 使用 Google 登录 user.blockrun.ai。这是管理密钥、余额和活动记录的控制面板；MCP 使用密钥调用 api.blockrun.ai 来访问实际服务。

1. 控制面板 → 密钥 — 创建密钥。密钥格式类似 brk_live_…，只会显示一次。
2. 控制面板 → 余额 — 使用信用卡或电汇充值。
3. 将服务指向该密钥。默认情况下，账户模式的调用会发送到 https://api.blockrun.ai：

claude mcp add blockrun -s user -e BLOCKRUN_API_KEY=brk_live_… -- npx -y @blockrun/mcp@latest

也可以在客户端启动时使用的环境中运行 export BLOCKRUN_API_KEY=brk_live_…。

如果客户端不便设置环境变量，可以将密钥写入 ~/.blockrun/.api-key（使用 chmod 600）——与钱包使用的文件位于同一目录。 如果两者都存在，则优先使用环境变量。 4. 控制面板 → 活动记录 — 每次调用均按实际用量精确计费。

使用 blockrun_wallet action:"status" 验证 — 它会报告账户、实际 余额，以及本次会话的支出：

Paying with: BlockRun account API key (no wallet, no chain)

  Account:  acme (gated)
  Credit remaining: $12.5000 of $50.00 granted
  Top up:   https://user.blockrun.ai/dashboard/credits

开票账户则会显示 Spent to date: $4.5239 (invoiced account — no prepaid ceiling)。如果账户被停用，状态会在你花费调用费用之前说明情况及原因。

选项 B — 钱包（无需账户）。 运行 blockrun_wallet 查看你的地址。新安装默认使用 Solana；从 Coinbase（选择“Solana”）、Phantom、Solflare 或 Backpack 发送 Solana 上的 USDC (SPL)。若要改用 Base 付款：运行 blockrun_wallet action:"chain" chain:"base"，然后发送 Base 上的 USDC。完整说明：为钱包充值。

$5 可支付约 525 次市场查询 · 约 500 次 Exa 搜索 · 约 250 次图像生成 · 约 14 个 Seedance 1.5-pro 视频片段。

4. 向 Claude 提问

“Polymarket 对美联储的下一个决定有什么看法？如果‘维持利率不变’的概率超过 70%，就押 $2。”

Claude 使用 blockrun_markets 读取赔率。在钱包模式下，且仅在你确认后，它还可以使用 blockrun_polymarket 下单交易。在 API 密钥模式下，数据/媒体/研究调用通过 api.blockrun.ai 执行；Polymarket 交易仍需要本地密钥对进行签名。

5. 安装 Agent 技能（可选）

此软件包附带 17 项技能 — 介绍每种工具能回答什么、提供可运行的示例，以及一组三项设置/调试/升级技能，方便 Agent 自行安装、排查问题并更新服务。

/plugin marketplace add BlockRunAI/blockrun-mcp            # Claude Code
npx -y @blockrun/mcp@latest skills install                 # any project → ./.claude/skills
npx -y @blockrun/mcp@latest skills install --global        # ~/.claude/skills
npx -y @blockrun/mcp@latest skills install --to ~/.codex/skills

skills list 显示随附的技能；--only a,b 用于选择；--force 可在升级后刷新副本。

演示

用户： Polymarket 对下个月的美联储利率决定有什么看法？

Claude： 根据 Polymarket，市场认为美联储维持利率不变的概率为 73%，降息 25 个基点的概率为 24%，加息的概率为 3%。24 小时交易量：$2.1M。“维持利率不变”合约的最后成交价为 $0.73。

（通过 blockrun_markets · 在 Base 上的费用：$0.0085 — $0.0075 + $0.001 网络费）

用户： Polymarket 认为 Hawley 宣布参加 2026 年总统竞选的概率约为 13% — 押 $1 买 Yes。

Claude： 完成 — 以 $0.131 的价格买入 7.63 股 Yes（$1.00，市场单 FOK）。这是链上真实订单，通过你免 Gas 的 Polymarket 存款钱包结算；我现在会跟踪这笔持仓。

（信号通过 blockrun_markets，交易通过 blockrun_polymarket — 一个自托管钱包，免 Gas · 链上交易 0x7ca8…）

工具

数据标价是基础价格。在钱包模式下，网关会额外收取固定网络费 — 目前 Base 上每次调用 $0.001，Solana 网关只报基础价格；账户通道不收取费用。具体金额可在任何未付请求的 payment-required 标头中查看，查询无需付费。服务端会为预算上限预留 $0.002 作为费用，因此 blockrun_wallet action:"report" 和支出确认对话框每次调用按设计会高出 $0.001。

主要用例

1. 预测市场共识 → “Polymarket 对美联储下一次决策的赔率是多少？” — blockrun_markets
2. 信号 → 交易 （完整流程，自托管） → “如果‘维持利率’的概率低于 30%，就在‘是’上押 $2。” — blockrun_markets 负责读取，blockrun_polymarket action:"buy" 负责下单。免 Gas，需确认。
3. 聪明钱调查 → “这个 Polymarket 巨鲸是谁？哪些钱包属于他们？他们的盈亏情况如何？” — blockrun_markets polymarket/wallet/identity/:wallet + .../cluster
4. 附引用的研究 → “过去 90 天内，关于推测解码被引用最多的 5 篇论文。” — blockrun_exa
5. 生成带图中文字的图像 → “制作一张宣布 GPT-5.5 发布的海报，复古未来主义风格，标题为‘现已上线’。” — blockrun_image
6. 为 Agent 配上语音 → “用 sarah 音色说这段话。” — blockrun_speech
7. 语音拨出电话 → “拨打 +1-415-…，确认周五下午 3 点。” — blockrun_phone
8. 有预算上限的多 Agent 研究 → “启动 3 个 Agent，研究相互竞争的 L1 叙事。每个 Agent 的预算上限为 $0.50。” — blockrun_wallet delegate × 3
9. 读取原始链数据，支持 40 条链 → “获取最新的 Base 区块，以及此合约的 USDC 余额。” — blockrun_rpc

📈 Polymarket 交易

blockrun_polymarket 可让 Agent 在 Polymarket（CLOB V2，Polygon）上进行真实投注。它采用非托管模式：每笔订单和授权都由你的 BlockRun 钱包密钥在本地通过 EIP-712 签名——这把自托管密钥既用于在 Base 上支付 x402 API 费用，也用于授权在 Polygon 上投注。BlockRun 和 Polymarket 的中继器都无法转移资金；它们只会转发你已签名的载荷。

架构 — 采用官方“存款钱包”路径（签名类型 POLY_1271）：在 Polygon 上建立一个智能合约金库，根据你的密钥通过 CREATE2 派生（只有你的密钥能授权该金库），并以 pUSD（Polymarket 按 1:1 比例提供的抵押品封装代币）持有投注资金。部署、授权和赎回都通过 Polymarket 的中继器免 Gas执行——你无需持有 POL。

📖 完整分步指南： docs/polymarket-trading-setup.md

# 1. Provision your deposit wallet (idempotent, gasless)
blockrun_polymarket action:"setup"

# 2. Fund it from your Base USDC in one call (gasless; $0.01 fee, non-custodial)
blockrun_polymarket action:"fund" amount_usd:5 confirm:true

# 3. Sign the one-time gasless approval batch
blockrun_polymarket action:"setup" confirm:true

# 4. Find a market, preview safely, then place only after exact user approval
blockrun_polymarket_read action:"preview" side:"buy" token_id:"<id>" amount_usd:5 order_type:"FOK"
blockrun_polymarket action:"buy" token_id:"<id>" amount_usd:5 order_type:"FOK" confirm:true

# 5. Manage → positions · orders · cancel · sell · redeem · withdraw

安全限制（服务端执行；Agent 无法绕过）：每笔订单、授权和赎回都必须设置 confirm:true；每笔订单受 POLYMARKET_MAX_BET_USD 限制（默认 $25）；可选的 POLYMARKET_MAX_SESSION_USD 会话限额；投注不会使用 x402 API 预算。

地区限制： Polymarket 会根据 IP 地址限制下单地区（美国/英国及许多其他地区）。默认已处理——MCP 会通过 BlockRun 托管在芬兰的出口节点（根据 Polymarket 政策，这是完全不受限制的地区）路由 CLOB 流量，因此开箱即可交易；setup 会显示你的状态。可通过设置 POLYMARKET_CLOB_HOST 覆盖此配置，改为直连或使用自己的出口节点；也可选择通过 HTTPS_PROXY / POLYMARKET_CLOB_PROXY 访问（单独使用代理不会改变面向 Polymarket 的出口节点）。你有责任遵守 Polymarket 适用于所在司法辖区的条款。

⚠️ 请备份你的签名密钥（默认位于 ~/.blockrun/.session；如果设置了 BLOCKRUN_WALLET_KEY 环境变量或已有 Agent 的 wallet.json，则优先使用它们——setup 会打印实际签名者地址）。这是支付钱包和 Polymarket 存款钱包的唯一密钥。

🛡️ 人工参与的支付确认

启用 BLOCKRUN_CONFIRM_SPEND=on 后，每个付费工具都会在签署前暂停。服务端会发送 MCP elicitation；客户端会将其显示为对话框，并列出预计费用：

💸 BlockRun charge — video · bytedance/seedance-2.5 · 10s
Estimated: $2.6500
Approve this spend? (USDC is debited per call.)
To stop the charge, choose Decline — Cancel/ESC lets it proceed.

[ ] Approve all BlockRun charges for the rest of this session (don't ask again)

                                          [ Decline ]  [ Approve ]

拒绝 → 不会发送任何内容，也不会产生费用，工具会报告 “Charge declined”。批准 → 调用继续执行。勾选复选框后，本次会话中不会再询问。免费调用不会弹出提示。设置 BLOCKRUN_CONFIRM_THRESHOLD=0.05，即可仅在费用超过 $0.05 时询问。

claude mcp add blockrun -s user -e BLOCKRUN_CONFIRM_SPEND=on -e BLOCKRUN_CONFIRM_THRESHOLD=0.05 -- npx -y @blockrun/mcp@latest

对于无法询问的客户端，该关卡默认放行——调用会继续执行，费用页脚会报告费用。所有客户端的硬性限制是预算：进程级预算使用 BLOCKRUN_BUDGET_LIMIT，每个子 Agent 使用 blockrun_wallet action:"delegate"。blockrun_polymarket 保留更严格的独立订单确认机制 confirm:true。

📖 适用场景、矩阵来源、限制： docs/spend-confirmation.md

🧩 MCP Apps — 订单卡片和钱包面板

在支持 MCP Apps 扩展 的宿主上——Claude Desktop、claude.ai、VS Code、Cursor、ChatGPT——有两个工具会以交互式卡片而非文本形式呈现。其他环境（Claude Code、Codex、终端）则不会有任何变化。

• 订单卡片：适用于 blockrun_polymarket_read action:"preview" — 问题、结果、方向、最佳报价、预估份额、名义金额、上限仪表、会话账本。编辑金额 → 重新报价。下单采用先授权、再确认的流程，并请求宿主调用 blockrun_polymarket … confirm:true，因此宿主的授权提示以及每项服务端上限（POLYMARKET_MAX_BET_USD、会话上限）仍然适用。
• 钱包面板：适用于 blockrun_wallet — 显示两条链的余额，可切换链、复制地址、查看 EIP-681 / Solana Pay 二维码、区块浏览器，并可使用银行卡购买 USDC。

📖 宿主、资金流转、本地测试： docs/mcp-apps.md

为钱包充值

如果改用 API 密钥付款，则无需为钱包充值——可在 user.blockrun.ai/dashboard/credits 使用银行卡或电汇充值。MCP 会通过该密钥调用 api.blockrun.ai，完全跳过钱包支付渠道。

服务端会保留两个钱包——一个在 Solana 上，一个在 Base 上；每次只从其中一个钱包付款。运行 blockrun_wallet 可查看两个钱包的地址、余额以及当前启用的钱包。

$5 可用于约 525 次市场查询、约 500 次 Exa 搜索、约 250 次图像生成，或约 14 个 Seedance 1.5-pro 视频片段（5 秒，720p+音频，每个约 $0.35）。

在 Solana 上付款 （新安装默认使用）

blockrun_wallet action:"setup"    # shows the Solana address + funding QR

通过 Solana 网络发送 USDC (SPL)——可使用 Coinbase（选择“Solana”）、Phantom、Solflare 或 Backpack。

在 Base 上付款

一次工具调用——无需环境变量、无需编辑文件、无需重启：

blockrun_wallet action:"chain" chain:"base"   # provisions + activates the Base wallet
blockrun_wallet action:"setup"                # shows the Base address + funding QR

使用 blockrun_wallet action:"chain" chain:"solana" 切换回来。切换只会改变由哪个钱包付款；两个钱包的余额都会保留。

从较旧版本升级？ 不会有任何资产转移。仅当安装时没有钱包且没有保存的链偏好时，才会默认优先使用 Solana——如果你已经有 Base 钱包，在切换前仍会继续使用 Base。

各模式可访问的功能

现在几乎所有功能都可以在任一链上结算。例外情况如下：

遇到受限功能时，会返回说明如何解决的消息，而不是原始错误。

调用费用及其确定性

任何估算值都会标注 ~，并明确说明是估算值。账户支付通道上的估算值会偏高，因为它们计入了实际不会收取的交易费，所以预算上限会提前触发，而不会延迟触发。唯一可信的数据来源始终是 Dashboard → Activity。

面向 Agent 和大模型

如果你是调用 BlockRun MCP 工具的大模型，请先阅读以下内容：

• 重要：遇到任何付款／余额／402 错误时，请先调用 blockrun_wallet 检查状态，然后调用 action:"setup" 进行充值。不要盲目重试失败的工具——钱包里没有余额。
• 重要：blockrun_polymarket 会动用用户的真实资金（Polygon 上的 pUSD），与 x402 API 预算分开。除非用户明确批准了具体交易，否则绝不要使用 confirm:true 执行 buy／sell／redeem；不带 confirm 时会安全地进行试运行。请先使用 blockrun_markets 查找市场／代币 ID。
• 重要：blockrun_music 和 blockrun_video 会在任务完成时收费，且为异步调用。 失败／客户端超时不会收费。不要循环重试——这些调用可能需要 60–180 秒。
• 重要：启动子 Agent 前，请分配各 Agent 的预算： 使用 blockrun_wallet action:"delegate" agent_id:"X" agent_limit:1.00，然后在每次下游调用中传入 agent_id:"X"。预算耗尽时会自动阻止子 Agent。
• 起草内容时优先使用免费层： blockrun_chat mode:"free"（NVIDIA）、blockrun_dex、blockrun_price（加密货币／外汇／大宗商品）和 blockrun_models 均为 $0。
• 用户拒绝确认支出，就是用户的决定。 请告知用户并停止——绝不要改用更便宜的模型、缩小参数或拆分请求，以低于其阈值的方式重新发起调用。

展示

通过 blockrun_image 和 openai/gpt-image-2 生成的海报——每张海报均通过 BlockRun 路由，仅需一次 API 调用，费用由账户余额或 USDC 钱包支付。

2026 年康奈尔区块链大会	2026 年康奈尔区块链大会	100 万亿个 Token 里程碑

提示词和完整示例见 skills/image-prompting/SKILL.md。

为什么不直接使用 API？

一个钱包，或一个由控制面板管理的 API 密钥。接入所有来源。

配置

故障排查

🤖 将此内容交给 Agent：blockrun-debug 技能将下方每一项整理为症状 → 原因 → 修复方法，并包含它可以自行运行的诊断。另两部分内容见 blockrun-setup 和 blockrun-upgrade。安装：npx -y @blockrun/mcp@latest skills install。

• Insufficient balance / 重试后出现 HTTP 402 → 运行 blockrun_wallet action:"setup"，在 Base（或 Solana）上转入 USDC。
• blockrun 无法连接 / “MCP server failed” / spawn npx ENOENT → 几乎总是 PATH 问题：Claude Code 无法在其启动器 PATH 中找到 node/npx（常见于 Homebrew / nvm，在命令行和桌面端都可能出现）。安装时传入 shell PATH 即可修复：

  claude mcp remove blockrun -s user
  claude mcp add blockrun -s user -e PATH="$PATH" -- npx -y @blockrun/mcp@latest
  

  然后重启 Claude Code。或者指定绝对路径（which npx）。
• claude mcp list 中没有显示 blockrun → 检查 node -v（≥20.19）。清除 npx 缓存：rm -rf ~/.npm/_npx。重新运行安装命令。
• fetch failed / 余额检查超时 → Base RPC 暂时中断。该工具会依次尝试 3 个公共 RPC；30 秒后重试。若问题持续，说明本地代理 / 防火墙阻止了出站 RPC。
• Video/Music generation timed out → 上游队列拥堵。是否产生费用取决于支付渠道，错误信息会说明是哪种情况：使用 Base 钱包时，付款在任务完成后结算，因此不会扣费，可以安全重试；使用 Solana 音乐和所有账户支付渠道的媒体任务时，网关会在提交时扣费，因此任务已扣费，错误信息会指出这一点，重新运行会再次扣费——请改为检查 blockrun_wallet action:"report"。
• blockrun_price 显示 Equity quotes are not served (gateway 501 …) → 股票价格 / 历史数据已于 2026-09-05 下架；这不是服务中断，且未产生任何费用（钱包从未被要求签名）。股票代码目录（action:"list" category:"stocks"）仍可免费使用。股票数据覆盖问题请联系：[email protected]。
• blockrun_markets 的 sports/* 调用失败——0.49.0 之前显示 API error after payment: 502，且余额没有变化 → Predexon 的 sports/* 路由自 2026-08-04 起在上游一直不可用；上游返回 500 时，网关会释放付款，因此该调用不会扣费（如果响应中包含网关的“payment NOT charged”确认信息，错误会明确说明；否则会提示你检查 blockrun_wallet action:"report"）。如需查询体育赔率，请使用 path:"markets/search" 和 params:{ q: "NBA" }，或使用 polymarket/events 和 params:{ search: "NBA" }——裸 markets 路由及其 league 筛选器已于 2026-08-04 在上游移除，并会在付款前返回 404。升级到 ≥ 0.49.0，错误信息便会自行说明上述情况。
• 已设置 BLOCKRUN_CONFIRM_SPEND=on，但没有支出确认对话框 → 你的客户端不支持 MCP 询问（Windsurf、Codex、Gemini CLI）；服务器按设计会继续执行而不询问。请使用 BLOCKRUN_BUDGET_LIMIT 进行限制，或使用支持列表中的客户端。
• Polymarket：负风险（“winner”）市场买入失败，或 redeem 回滚，尽管设置显示已就绪 → 重新运行一次 action:"setup" confirm:true（授予升级前的存款钱包可能缺少的链上授权，包括 redeem 所需的抵押品适配器授权）。请参阅设置指南。

常见问题

BlockRun MCP 是什么？ 一个开源 MCP 服务，为 Claude 和其他 Agent 提供 19 个工具，用于获取实时数据和执行实际操作（交易、媒体、链上操作），按调用付费——使用自托管钱包或 BlockRun 账户密钥。

我需要 API 密钥或账户吗？ 不需要。首次运行时会在本地自动创建钱包；你只需用 USDC 为其充值，无需注册、使用仪表板或轮换密钥。

但你也可以使用账户。如果团队无法将钱包交给 Agent，请在 user.blockrun.ai 登录，在 Dashboard → Keys 创建密钥，通过银行卡或电汇在 Dashboard → Credits 充值账户余额，然后设置 BLOCKRUN_API_KEY。随后，MCP 会向 api.blockrun.ai 发送付费服务调用，并从账户余额中按实际用量扣费——没有每次调用 $0.001 的网络费，也没有单次调用的最低消费——账单记录可在 Dashboard → Activity 查看。除确实需要密钥对的功能外，其他功能都可使用：Polymarket 交易、钱包余额与充值，以及按钱包索引的 blockrun_realface action:"list"。

哪种方式更便宜？ 账户计费稍便宜——按实际计量用量收费，没有单次调用最低消费，也没有每笔交易 $0.001 的费用。钱包模式则支持自托管和 Polymarket 交易。

费用是多少？ 按次付费——费用从不到一美分到几美分不等。免费层（blockrun_chat mode:"free"、blockrun_dex、加密货币 blockrun_price、blockrun_models）费用为 $0。充值 $5 的 USDC 或账户余额即可支付数千次查询。

它安全吗／是否非托管？ 是。你的私钥不会离开本机（默认位于 ~/.blockrun/.session，权限为 0600）。x402 付款和 Polymarket 订单均在本地签名——BlockRun 只转发已签名的载荷，无法动用你的资金。

支持哪些客户端？ 任何能够启动 stdio 服务的 MCP 客户端都支持。已在 Claude Code 和 Codex CLI 上验证，并在 OpenClaw 上日常使用；Claude Desktop、Cursor、VS Code、Gemini CLI 和 Windsurf 的安装方式也有说明——请参阅客户端表格。此外，支出确认对话框还需要 MCP elicitation（Claude Code、Cursor、VS Code）。

它有 UI 吗？ 在支持 MCP-Apps 的宿主（Claude Desktop、claude.ai、VS Code、Cursor）上，Polymarket 预览会显示为实时订单卡片，钱包则显示为面板——请参阅 MCP Apps ↑。终端客户端会以文本形式提供相同的信息。

我可以让 Agent 在支出前征求同意吗？ 可以——设置 BLOCKRUN_CONFIRM_SPEND=on。每个付费工具都会暂停并显示预估费用，只有你批准后才会签名。人工介入式付款 ↑

它真的能下真实赌注吗？ 可以。blockrun_polymarket 会在 Polymarket 的 CLOB 上下真实的 USDC 结算订单——需要确认，并受限额保护。使用 blockrun_markets 查看赔率，再用 blockrun_polymarket 下单。

Base 还是 Solana？ 两者都支持。使用 blockrun_wallet action:"chain" 即可即时切换。有三项功能仅支持 Base，在 Solana 上调用时都会说明原因：blockrun_defi（DefiLlama）和 blockrun_modal（Solana 网关不提供这两项服务），以及带 thinking 的 claude-* 聊天（原生 /v1/messages 路径通过 Base 付款；普通的 claude-* 调用在 Solana 上会走兼容路径）。媒体生成、市场、搜索和 Polymarket 均可在任一链上结算。

来自 BlockRun 生态系统

BlockRun 是面向 Agent 的 AI 基础设施——通过一个钱包使用 x402 USDC 微支付，或通过一个账户 API 密钥使用银行卡充值的额度，覆盖所有场景：

• ⚡ ClawRouter — 面向 OpenClaw 的 Agent 原生 LLM 路由器。支持 88 个模型、本地路由延迟低于 1 ms，以及 Base 和 Solana 上的 USDC。
• 🤖 BRCC — 面向 Claude Code 的 BlockRun：智能路由 + x402 支付，专为 Claude Code 打造。
• 🐍 ClawRouter-Hermes — 将 NousResearch Hermes 接入 ClawRouter 代理的 Python 插件。
• 📚 文档 · 模型与定价 — 完整的 SDK、API 和模型目录。

支持与社区

贡献

欢迎提交 PR。有关设置、工具与技能的设计规则，以及如何添加新的合作伙伴 API，请参阅 CONTRIBUTING.md。