跳到正文

面向开发者与 AI Agent 的区块链 RPC 和文档 MCP

开发者与 AI Agent 可免 key 发现文档,通过 HTTP 创建凭据,再认证调用受支持的 RPC 或 Data API。

免 key 公开端点:无需 API key 即可调用支持的链,地址为 https://api.blockvectra.com/v1/<chain>/public,把 <chain> 换成具体链名即可,例如 eth_mainnet。每 IP 限额与支持的链列表以 GET /v1/chains 为准。

快速回答

  • 免 key:POST https://api.blockvectra.com/v1/<chain>/public 在 29 条链上无需账号和 API key 即可调用,每 IP 每秒 3 次请求(突发 20,批量最多 10 条)。

    出处:GET /v1/chains
  • 钱包开户只要四次 HTTP 调用:请求挑战、用以太坊钱包签名(EIP-191)、登录(首次登录自动开户),再 POST /keys 创建 API key。

    出处:程序化开户指南
  • 一条命令接入文档 MCP,无需 key:claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

    出处:AI Agent 指南
  • 注册即送 30,000,000 CU,无需绑卡。免费计划按 30 天一个周期,所有 key 共享每秒 25 次调用;eth_call 每次 15 CU(每 1,000,000 次 $1.50)。

    出处:GET /v1/plans
  • 与人同权:创建与吊销 key、查余额、链上充值都是 HTTP 调用,不是控制台独有。MCP 服务不能创建或吊销 key。

    出处:程序化开户指南

我该用哪个?

想要用第一步
马上读链上数据,不想注册免 key 公开端点向 https://api.blockvectra.com/v1/<chain>/public POST 一个 eth_chainId 的 JSON-RPC 请求。允许的方法见 GET /v1/chains。
让 AI 助手查文档、链、状态与价格,并发起只读 RPC 调用文档 MCP 服务运行下方 MCP 区块里的一行命令。详见 AI Agent 指南。
调用公开列表之外的方法、Data API,或需要 key 自己的限额HTTP 开户并创建 API keyPOST /auth/siwe/challenge、签名、登录,再 POST /keys。步骤见程序化开户指南。
地址有动静时被通知,而不是轮询Webhook 地址推送按 Webhook 推送指南创建订阅,每个订阅最多 1,000,000 个地址。

免 key 的文档 MCP

文档 MCP 服务不需要 API key,可查文档、链、实时状态、价格与用量估算。

仅文档 MCP

search_docs · read_doc
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
仅文档 MCP →
一条命令,无需 API key:
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp

其他客户端:

在 Cline 中打开 MCP Servers → Configure → Configure MCP Servers,添加以下免 API key 配置:

{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
查看文档站的 Agent 指南 →
免 key 尝试公开 RPC 调用
列出支持的链,选择其中公开方法允许 eth_chainId 的链。对该链和该方法使用 get_method_info,然后在不带 API key 的情况下通过 rpc_call 调用 eth_chainId。把返回的链 ID 与该链公布的 chain_id 按数值比较,报告结果及适用的公开限额。如果 ID 缺失、无效或不同,停止并报告,不要声称成功。

如需调用要求 key 的方法或 Data API,先通过 HTTP 开户并创建 key,再按 Data API 指南接入。需要增加余额时,可链上充值。

接入指南

  • MCP 服务 工具清单、key 要求与客户端接入。
  • LangChain 给 LangChain Agent 配 RPC 工具或接入 MCP 服务。
  • ElizaOS 把 EVM 插件指向 BlockVectra 端点。
  • Coinbase AgentKit 在 AgentKit 中使用 BlockVectra RPC 地址。
  • 股票代币活动 用 Data API 读取股票代币的每日转账活动。

与人同权

通过 HTTP,Agent 可以创建 key(POST /keys)、吊销 key(POST /keys/{key_id}/revoke)、查余额(GET /v1/account)并链上充值,限额与价格和在控制台操作的人相同。

MCP 服务可读文档、链、状态与价格,发起只读 RPC 调用(rpc_call),广播已签名交易(send_raw_transaction);在客户端配置 key 后还能查账户余额与充值地址。它没有创建或吊销 key 的工具,这些走 HTTP。

Agent 读得懂的价格

GET /v1/plans 以 JSON 返回每个方法的 CU 权重,调用前就能估算成本。

打开 GET /v1/plans →

用 USDC / USDT / USDG 付费 →

免费套餐

注册即享 30,000,000 CU 初始额度。首次计费调用后开启 30 天用量周期,到期自动补足至 30,000,000 CU(不累积)。当前账户下全部 key 共享平均每秒 25 次调用,允许短时突发;每个 key 仍有默认 100 CU/s 限额(突发 400 CU)。

约 2,000,000 次 eth_call

无需信用卡,GitHub/Google/钱包任选登录即开户。

机器可读入口

无需账户即可发现的机器可读文件与目录:

复制即跑示例

export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST https://api.blockvectra.com/v1/robinhood_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

还没有 API key?

如果有以太坊钱包:参考程序化开户指南通过钱包签名自主开户建 key,无需浏览器。如果没有钱包:请用户登录 https://console.blockvectra.com 建一个 key,并设置为环境变量 BLOCKVECTRA_API_KEY。不要让用户把 key 贴进对话。

常见问题

不注册能直接调用区块链 RPC 吗?

可以。POST https://api.blockvectra.com/v1/<chain>/public 在 29 条链上无需账号和 API key;各链允许的方法与每 IP 限额见 GET /v1/chains。列表之外的方法和 Data API 需要 API key。

MCP 能发交易吗?

能广播,不能签名。MCP 服务不持有私钥:send_raw_transaction 提交的是你在别处签好的交易,走免 key 端点(该链公开方法含 eth_sendRawTransaction)或使用你的 API key。它没有创建或吊销 key 的工具。 在 AI Agent 指南查看 MCP 工具 →

要不要先付款?

不用。钱包首次登录即送 30,000,000 CU 免费额度,无需绑卡也无需充值;免 key 端点连账号都不用。eth_call 每次 15 CU(每 1,000,000 次 $1.50),全部价格见 GET /v1/plans,不够时可链上充值。

AI Agent 不开浏览器怎么拿到 API key?

四次 HTTP 调用:POST /auth/siwe/challenge,用以太坊钱包对返回的消息签名(EIP-191),POST /auth/siwe/login(首次登录自动开户),再 POST /keys。key 只返回一次,存进 BLOCKVECTRA_API_KEY。 按程序化开户指南操作 →

AI Agent 能直接用 BlockVectra 吗?

可以。Agent 和人使用同一套公开的 JSON-RPC 与 Data API、同一份文档和同一套价格;文档 MCP 服务与机器可读文件无需 key。 查看接入方式 →