面向开发者与 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 key | POST /auth/siwe/challenge、签名、登录,再 POST /keys。步骤见程序化开户指南。 |
| 地址有动静时被通知,而不是轮询 | Webhook 地址推送 | 按 Webhook 推送指南创建订阅,每个订阅最多 1,000,000 个地址。 |
免 key 的文档 MCP
文档 MCP 服务不需要 API key,可查文档、链、实时状态、价格与用量估算。
仅文档 MCP
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docsclaude 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"
}
}
}列出支持的链,选择其中公开方法允许 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 权重,调用前就能估算成本。
免费套餐
注册即享 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。 查看接入方式 →