在 AI 助手中使用 BlockReq

BlockReq 以 AI 助手和编码智能体可以直接读取的形式发布文档，并提供公开的 MCP 服务器。下面所有内容都由与本站页面相同的目录和模板生成，与页面保持同步。

机器可读文档

资源	内容
llms.txt	按主题分组的全部文档页索引，遵循 llmstxt.org 格式
llms-full.txt	合并为一个 Markdown 文件的核心文档，附网络能力表，每个 JSON-RPC 方法出现一次
Markdown 页面	每个页面都有 Markdown 版本：在 URL 后加 `index.md`，例如 `https://blockreq.com/docs/zh-cn/build/api-reference/ethereum/eth_getBalance/index.md`
networks.json	每个已发布网络的主机名、公开 URL、私有 URL 形式、WSS，以及 Archive 与 proof/debug/trace 标记
OpenRPC	每个 EVM 网络一份 OpenRPC 文档，只列出为该网络提供文档的方法

通用智能体可以直接读取 https://blockreq.com/docs/llms.txt，再按需跟进其中的链接。

blockreq-rpc Agent Skill

blockreq-rpc Skill 教编码智能体如何调用 BlockReq：端点 URL、如何选择网络主机名、哪些方法需要 Archive 数据或只在 proof/debug/trace 网络上提供、通过 WSS 使用 eth_subscribe、Request Counting 与套餐限制、简短的 viem、ethers、curl 与 web3.py 示例，以及常见问题。

在线查看：SKILL.md，以及网络与方法参考。
下载：blockreq-rpc.zip。
从 GitHub 安装：blockreq/skills 是一个 Claude Code 插件市场，每天从上面的 ZIP 同步这个 Skill。

Claude Code

从 blockreq/skills 插件市场安装：


/plugin marketplace add blockreq/skills
/plugin install blockreq-rpc@blockreq

也可以手动复制 Skill。为当前用户安装，所有项目都能使用：


mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://blockreq.com/docs/agent-skills/blockreq-rpc.zip
unzip -o blockreq-rpc.zip && rm blockreq-rpc.zip

只为一个项目安装时，解压到该项目的 .claude/skills/ 目录，随代码一起提交。两种方式下 Skill 都位于 blockreq-rpc/ 目录，任务涉及 BlockReq RPC 时 Claude Code 会加载它。

Claude.ai

下载 blockreq-rpc.zip，在 Claude.ai 中作为自定义 Skill 上传。自定义 Skill 需要 Pro、Max、Team 或 Enterprise 套餐并开启代码执行；上传入口见 Anthropic 的 Using Skills in Claude。

其他智能体

不读取 Agent Skill 的智能体可以使用 https://blockreq.com/docs/llms.txt，或把 SKILL.md 及其参考文件作为指令加载。

BlockReq MCP 服务器

https://mcp.blockreq.com/mcp 是基于 Streamable HTTP 的远程 MCP 服务器。它公开、免费、只读，不带 API key、不登录也能使用。共有十四个工具：六个用于文档、网络目录与 JSON-RPC，八个用于链上 DEX 与钱包数据。用你的 BlockReq API key 作为 bearer token 连接（Authorization: Bearer <API key>）后，call_rpc 会改走你自己的私有端点，而不是共享的公开试用端点；在 X-Data-Api-Key 请求头里带上你自己的 Crypto API key，数据工具就按你套餐的限额运行，而不是匿名限额。

工具	作用
`list_chains`	列出每个已发布网络的主机名、公开 URL、私有 URL 形式、WSS，以及 Archive 与 proof/debug/trace 标记
`get_chain`	返回一个网络的 URL、标记、API 参考页面，以及为它提供文档的 JSON-RPC 方法
`search_docs`	用英文或中文检索本文档，返回标题、URL 与摘录
`get_doc_page`	以 Markdown 返回一个文档页面
`get_method_reference`	从 OpenRPC 文档返回某个方法在一个 EVM 网络上的参数、返回值、示例与端点
`call_rpc`	在 EVM 网络的公开试用端点上调用只读方法，带 API key 或登录账户连接时改走你自己的端点：`eth_blockNumber`、`eth_chainId`、`eth_getBalance`、`eth_call`、`eth_getLogs`、`eth_getTransactionByHash`、`eth_getTransactionReceipt`、`eth_getCode`、`eth_getStorageAt` 与 `eth_getBlockByNumber`
`search_tokens`	在一条链上按符号、名称或地址查找代币，附最深的池、USD 价格、流动性与 24 小时成交额
`get_token`	一个代币的 USD 价格及读取价格的区块与时间、24 小时涨跌与成交额、取价的池，低流动性标记、价格的年龄、`stale`（stale 为 true 的价格不能当作当前价展示）以及该链索引处理到哪里
`get_token_prices`	一次取最多 50 个代币的当前 USD 价格，可跨链，每条带 `price_time`、`age_seconds` 与 `stale`
`get_token_candles`	代币的 USD K 线（开、高、低、收、成交额、笔数），旧的在前
`list_token_pools`	持有该代币的池，最深的在前
`list_pool_trades`	一个池最近的成交，新的在前，含区块号、时间、交易哈希、交易者、USD 金额，以及交易者买入的是 token0 还是 token1
`get_token_holders`	一个代币的最大持有人，含余额与占已知供应量的比例，截至某个区块；只有 BlockReq 跟踪的代币才有排行
`get_account_portfolio`	一个地址在一条链上的代币持仓及 USD 价值，含原生币

数据工具覆盖 Ethereum、Base 与 Arbitrum，数据与 On-chain DEX API 和 Wallet API 相同，只读。每个结果都带有它所截至的区块与时间，以及它来自的那条公开 API 请求，你可以用 curl 重放。不带 key 时是匿名调用：每次调用都计入 BlockReq Crypto API 的匿名每 IP 限额，与同一 IP 上的其他客户端共用，被限流时 429 的应答会说明需等待几秒。调用 search_tokens 时请传 chain，跨所有链的搜索可能超时。带上 X-Data-Api-Key: <Crypto API key>，调用就走你自己的 Crypto API 套餐；API 拒绝的 key 会让连接以 401 失败，而不是退回匿名限额。这个请求头与 Authorization: Bearer 相互独立，后者仍是 call_rpc 用的 RPC 端点 key；两者可以只带一个、都带或都不带。两个端点都列出全部十四个工具；在下面的账户端点上，数据工具使用你账户里自己的 key，不需要请求头。

不带 key 时，call_rpc 与 https://<host>/v1/rpc/public 走同一个限流的公开试用端点，只提供近期状态，不提供深度历史、debug 或 trace，共用同一 IP 的客户端共享这一限流。带 key 时，它调用 https://<host>/v1/rpc，并把 key 放在 X-API-Key 头中：调用计入你账户的 Requests（免费套餐每 30 天含 3,000,000 次），享有你套餐的限额与历史数据，且该 key 所属的端点必须覆盖这个网络。服务器从不返回或记录你的 key。eth_getLogs 需要相距不超过 1,000 个区块的数字 fromBlock 与 toBlock，或一个 blockHash；超过 256 KB 的响应会被拒绝。服务器不能签名或发送交易。生产代码应改用带 API key 的私有端点。

Claude Code


claude mcp add --transport http blockreq https://mcp.blockreq.com/mcp \
  --header "Authorization: Bearer $BLOCKREQ_API_KEY"

去掉 --header 即使用公开试用。要让数据工具用你自己的 Crypto API key，再加 --header "X-Data-Api-Key: $BLOCKREQ_DATA_API_KEY"。加上 --scope user 即可在所有项目中使用。参见 Connect Claude Code to tools via MCP。

Cursor

把服务器加到 ~/.cursor/mcp.json，或某个项目的 .cursor/mcp.json：


{
  "mcpServers": {
    "blockreq": {
      "url": "https://mcp.blockreq.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:BLOCKREQ_API_KEY}",
        "X-Data-Api-Key": "${env:BLOCKREQ_DATA_API_KEY}"
      }
    }
  }
}

去掉 headers 即使用公开试用，或只保留你需要的那个请求头。Cursor 可能需要重启才会列出新添加的服务器。

参见 Cursor 的 Model Context Protocol 文档。

Claude Desktop

Claude Desktop 把远程服务器作为自定义连接器添加，不从 claude_desktop_config.json 读取（该文件用于本地服务器）。打开 Customize > Connectors，选择 Add，再选 Add custom connector，名称填 BlockReq，URL 填 https://mcp.blockreq.com/mcp，最后点 Add。要使用你自己的 key，在 Request headers 里添加 X-Data-Api-Key（call_rpc 还要 Authorization: Bearer <API key>），并把 Authentication 设为 No sign in。之后在对话里通过 + 按钮启用该连接器。Claude Desktop 从 Anthropic 的服务器访问本服务，所以它的用户共用一个 IP 和一份匿名限额；加上你自己的 Crypto API key 即可使用你套餐的限额。参见 Anthropic 的 Get started with custom connectors using remote MCP。

Claude.ai 与其他托管客户端：连接你的账户

托管客户端运行在服务商的服务器上，用户共用少数几个 IP，也就共用同一份公开试用限额。改为添加 https://mcp.blockreq.com/mcp/account：

客户端会把你带到 blockreq.com 登录并授权。
之后 call_rpc 使用你在每个网络上的有效端点，每次调用都计入你的 Requests。
八个数据工具使用你的 Crypto API 端点的 key，每次调用都计入你的 Crypto API 套餐，与用该 key 调用相同。请在授权页允许“读取 DEX 与钱包数据”；在这个选项出现之前建立的连接，需要先断开再重新连接。
你要调用的每个网络都需要一个有效端点，数据工具还需要一个 Crypto API 端点，可在 blockreq.com/dashboard 创建；授权页会说明是否替你创建免费的 Crypto API 端点。
数据工具请一次调用一个：Free 套餐每秒 1 次、突发 1，被限流不超过 2 秒的调用会自动重试一次。
客户端始终拿不到你的 API key。
要断开某个助手，在控制台打开设置 → 已连接的助手并点「断开」；它会在几秒内失去访问，也不能再刷新登录。
Claude.ai：把 https://mcp.blockreq.com/mcp/account 添加为自定义连接器，并在提示时连接，参见 Anthropic 的 Get started with custom connectors using remote MCP。不登录账户、只想试用时，改为添加 https://mcp.blockreq.com/mcp。
支持 MCP 授权（OAuth 2.1 与动态客户端注册）的其他客户端，以同样方式连接 https://mcp.blockreq.com/mcp/account。

其他客户端

支持 Streamable HTTP 远程 MCP 服务器的客户端：使用 URL https://mcp.blockreq.com/mcp；如果客户端允许自定义请求头，再加上 Authorization: Bearer <API key> 与 X-Data-Api-Key: <Crypto API key>。
只能启动本地（stdio）服务器的客户端，可以用 npx mcp-remote https://mcp.blockreq.com/mcp 桥接。
支持 WebMCP 的浏览器内智能体，在 blockreq.com 页面上就能找到同一组工具；这些页面也在同源地址 https://blockreq.com/mcp 提供同一个公开端点。