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

> https://blockvectra.com/zh/agents/

开发者与 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](https://api.blockvectra.com/v1/chains))
- 钱包开户只要四次 HTTP 调用：请求挑战、用以太坊钱包签名（EIP-191）、登录（首次登录自动开户），再 POST /keys 创建 API key。 ([出处：程序化开户指南](https://docs.blockvectra.com/zh/guides/programmatic-signup/))
- 一条命令接入文档 MCP，无需 key：claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp ([出处：AI Agent 指南](https://docs.blockvectra.com/zh/guides/ai-agents/))
- 注册即送 30,000,000 CU，无需绑卡。免费计划按 30 天一个周期，所有 key 共享每秒 25 次调用；eth_call 每次 15 CU（每 1,000,000 次 $1.50）。 ([出处：GET /v1/plans](https://console-api.blockvectra.com/v1/plans))
- 与人同权：创建与吊销 key、查余额、链上充值都是 HTTP 调用，不是控制台独有。MCP 服务不能创建或吊销 key。 ([出处：程序化开户指南](https://docs.blockvectra.com/zh/guides/programmatic-signup/))

## 我该用哪个？

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

## 免 key 的文档 MCP

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

### 仅文档 MCP

search_docs · read_doc

```bash
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
```

[仅文档 MCP →](https://docs.blockvectra.com/zh/guides/mcp-server/#仅查文档的远程-http-入口)

一条命令，无需 API key：

```bash
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
```

其他客户端：

- [安装到 Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9)
- [配置 Cline](https://docs.cline.bot/mcp/mcp-overview#manual-config)

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

```json
{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
```

[查看文档站的 Agent 指南 →](https://docs.blockvectra.com/zh/guides/ai-agents/)

免 key 尝试公开 RPC 调用

```
列出支持的链，选择其中公开方法允许 eth_chainId 的链。对该链和该方法使用 get_method_info，然后在不带 API key 的情况下通过 rpc_call 调用 eth_chainId。把返回的链 ID 与该链公布的 chain_id 按数值比较，报告结果及适用的公开限额。如果 ID 缺失、无效或不同，停止并报告，不要声称成功。
```

如需调用要求 key 的方法或 Data API，先[通过 HTTP 开户并创建 key](https://docs.blockvectra.com/zh/guides/programmatic-signup/)，再按 [Data API 指南](https://docs.blockvectra.com/zh/api/data/)接入。需要增加余额时，可[链上充值](https://docs.blockvectra.com/zh/guides/agent-topup/)。

## 接入指南

- [MCP 服务](https://docs.blockvectra.com/zh/guides/mcp-server/) 工具清单、key 要求与客户端接入。
- [LangChain](https://docs.blockvectra.com/zh/guides/langchain/) 给 LangChain Agent 配 RPC 工具或接入 MCP 服务。
- [ElizaOS](https://docs.blockvectra.com/zh/guides/elizaos/) 把 EVM 插件指向 BlockVectra 端点。
- [Coinbase AgentKit](https://docs.blockvectra.com/zh/guides/coinbase-agentkit/) 在 AgentKit 中使用 BlockVectra RPC 地址。
- [股票代币活动](https://docs.blockvectra.com/zh/guides/stocks/) 用 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 →](https://console-api.blockvectra.com/v1/plans)
- [用 USDC / USDT / USDG 付费 →](https://blockvectra.com/zh/pricing/#pay-with-usdt)

### 免费套餐

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

约 2,000,000 次 eth_call

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

[查看免费额度与定价 →](https://blockvectra.com/zh/pricing/#free)

## 机器可读入口

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

- [官网 llms.txt](https://blockvectra.com/llms.txt)
- [文档站 llms.txt](https://docs.blockvectra.com/llms.txt)
- [每一页文档的 Markdown 版本](https://docs.blockvectra.com/md/zh/quickstart.md)
- [OpenAPI 3.1 — JSON-RPC](https://docs.blockvectra.com/openapi/json-rpc.yaml)
- [OpenAPI 3.1 — Data API](https://docs.blockvectra.com/openapi/data.yaml)
- [RFC 9727 API 目录](https://blockvectra.com/.well-known/api-catalog)
- [错误参考](https://docs.blockvectra.com/zh/errors/)

## 复制即跑示例

```bash
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 贴进对话。

- [查看程序化开户指南 →](https://docs.blockvectra.com/zh/guides/programmatic-signup/)
- [控制台登录](https://console.blockvectra.com/login/?next=%2Fkeys%2F)

## 常见问题

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

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

### MCP 能发交易吗？

能广播，不能签名。MCP 服务不持有私钥：send_raw_transaction 提交的是你在别处签好的交易，走免 key 端点（该链公开方法含 eth_sendRawTransaction）或使用你的 API key。它没有创建或吊销 key 的工具。

[在 AI Agent 指南查看 MCP 工具 →](https://docs.blockvectra.com/zh/guides/ai-agents/)

### 要不要先付款？

不用。钱包首次登录即送 30,000,000 CU 免费额度，无需绑卡也无需充值；免 key 端点连账号都不用。eth_call 每次 15 CU（每 1,000,000 次 $1.50），全部价格见 [GET /v1/plans](https://console-api.blockvectra.com/v1/plans)，不够时可[链上充值](https://docs.blockvectra.com/zh/guides/agent-topup/)。

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

四次 HTTP 调用：POST /auth/siwe/challenge，用以太坊钱包对返回的消息签名（EIP-191），POST /auth/siwe/login（首次登录自动开户），再 POST /keys。key 只返回一次，存进 BLOCKVECTRA_API_KEY。

[按程序化开户指南操作 →](https://docs.blockvectra.com/zh/guides/programmatic-signup/)

### AI Agent 能直接用 BlockVectra 吗？

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

[查看接入方式 →](https://docs.blockvectra.com/zh/guides/ai-agents/)