# 面向開發者與 AI Agent 的區塊鏈 RPC 和文件 MCP

> https://blockvectra.com/zh-hant/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-hant/guides/programmatic-signup/))
- 一條指令接入文件 MCP，無需 key：claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp ([出處：AI Agent 指南](https://docs.blockvectra.com/zh-hant/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-hant/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-hant/guides/ai-agents/)。 |
| 呼叫公開清單之外的方法、Data API，或需要 key 自己的限額 | HTTP 開戶並建立 API key | POST /auth/siwe/challenge、簽名、登入，再 POST /keys。步驟見[程式化開戶指南](https://docs.blockvectra.com/zh-hant/guides/programmatic-signup/)。 |
| 位址有動靜時被通知，而不是輪詢 | Webhook 位址推送 | 按 [Webhook 推送指南](https://docs.blockvectra.com/zh-hant/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/en/guides/mcp-server/#docs-only-remote-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-hant/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-hant/guides/programmatic-signup/)，再按 [Data API 指南](https://docs.blockvectra.com/zh-hant/api/data/)接入。需要增加餘額時，可[鏈上儲值](https://docs.blockvectra.com/zh-hant/guides/agent-topup/)。

## 接入指南

- [MCP 服務](https://docs.blockvectra.com/zh-hant/guides/mcp-server/) 工具清單、key 要求與用戶端接入。
- [LangChain](https://docs.blockvectra.com/zh-hant/guides/langchain/) 給 LangChain Agent 配 RPC 工具或接入 MCP 服務。
- [ElizaOS](https://docs.blockvectra.com/zh-hant/guides/elizaos/) 把 EVM 外掛指向 BlockVectra 端點。
- [Coinbase AgentKit](https://docs.blockvectra.com/zh-hant/guides/coinbase-agentkit/) 在 AgentKit 中使用 BlockVectra RPC 位址。
- [股票代幣活動](https://docs.blockvectra.com/zh-hant/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-hant/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-hant/pricing/#free)

## 機器可讀入口

無需帳戶即可發現的機器可讀檔案與目錄：

- [官網 llms.txt](https://blockvectra.com/llms.txt)
- [文件站 llms.txt](https://docs.blockvectra.com/llms.txt)
- [每一頁文件的 Markdown 版本](https://docs.blockvectra.com/md/zh-hant/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-hant/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-hant/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-hant/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-hant/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-hant/guides/programmatic-signup/)

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

可以。Agent 和人使用同一套公開的 JSON-RPC 與 Data API、同一份文件和同一套價格；文件 MCP 服務與機器可讀檔案無需 key。

[檢視串接方式 →](https://docs.blockvectra.com/zh-hant/guides/ai-agents/)
