RPC blockchain và MCP tài liệu dành cho nhà phát triển và AI Agent
Nhà phát triển và AI Agent có thể khám phá tài liệu mà không cần khóa, tạo thông tin xác thực qua HTTP và gọi các endpoint RPC hoặc Data API được hỗ trợ kèm xác thực.
Endpoint công khai không khóa: gọi một chuỗi được hỗ trợ mà không cần khóa API tại https://api.blockvectra.com/v1/<chain>/public, thay <chain> bằng một chuỗi như eth_mainnet. Giới hạn theo IP và danh sách chuỗi được hỗ trợ có từ GET /v1/chains.
Trả lời nhanh
Không cần khóa: POST https://api.blockvectra.com/v1/<chain>/public hoạt động trên 29 chuỗi mà không cần tài khoản hay khóa API, 3 yêu cầu mỗi giây trên mỗi IP (burst 20, batch tối đa 10).
Nguồn: GET /v1/chainsĐăng ký bằng ví chỉ cần bốn lệnh gọi HTTP: yêu cầu challenge, ký bằng ví Ethereum (EIP-191), đăng nhập (lần đăng nhập đầu tiên tạo tài khoản), rồi POST /keys để tạo khóa API.
Nguồn: hướng dẫn đăng ký tự độngMột lệnh thêm máy chủ MCP tài liệu, không cần khóa: claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
Nguồn: hướng dẫn agent AIĐăng ký được tặng 30,000,000 CU miễn phí, không cần thẻ. Gói miễn phí chạy theo chu kỳ 30 ngày với 25 lệnh gọi mỗi giây dùng chung cho mọi khóa; eth_call tốn 15 CU ($1.50 cho 1,000,000 yêu cầu).
Nguồn: GET /v1/plansCùng quy tắc như con người: tạo và thu hồi khóa, xem số dư và nạp tiền trên chuỗi đều là lệnh gọi HTTP, không chỉ có trong bảng điều khiển. Máy chủ MCP không tạo hay thu hồi khóa.
Nguồn: hướng dẫn đăng ký tự động
Tôi nên dùng cái nào?
| Bạn muốn | Dùng | Bước đầu tiên |
|---|---|---|
| Đọc dữ liệu chuỗi ngay, không cần tài khoản | Endpoint công khai không khóa | POST https://api.blockvectra.com/v1/<chain>/public với nội dung JSON-RPC eth_chainId. Các phương thức được phép nằm trong GET /v1/chains. |
| Để trợ lý AI đọc tài liệu, chuỗi, trạng thái và giá, đồng thời gọi RPC chỉ đọc | Máy chủ MCP tài liệu | Chạy lệnh một dòng trong phần MCP bên dưới. Xem hướng dẫn agent AI. |
| Dùng các phương thức ngoài danh sách công khai, Data API hoặc giới hạn riêng của một khóa | Đăng ký qua HTTP và khóa API | POST /auth/siwe/challenge, ký, đăng nhập, rồi POST /keys. Các bước có trong hướng dẫn đăng ký tự động. |
| Được báo khi một địa chỉ có hoạt động thay vì phải thăm dò liên tục | Đẩy thông báo địa chỉ qua webhook | Tạo một đăng ký tối đa 1,000,000 địa chỉ trong hướng dẫn đẩy webhook. |
MCP tài liệu không cần khóa
Máy chủ MCP tài liệu không cần khóa API và trả lời các câu hỏi về tài liệu, các chuỗi, trạng thái thời gian thực, giá cả và ước tính mức sử dụng.
MCP chỉ tài liệu
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docsclaude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcpCác client khác:
Trong Cline, mở MCP Servers → Configure → Configure MCP Servers và thêm cấu hình không cần khóa API sau:
{
"mcpServers": {
"blockvectra": {
"type": "streamableHttp",
"url": "https://docs.blockvectra.com/mcp"
}
}
}Liệt kê các chuỗi được hỗ trợ và chọn một chuỗi có phương thức công khai cho phép eth_chainId. Dùng get_method_info cho chuỗi và phương thức đó, rồi gọi eth_chainId bằng rpc_call mà không cần khóa API. So sánh ID chuỗi trả về theo giá trị số với chain_id đã công bố của chuỗi được chọn, rồi báo cáo kết quả và các giới hạn truy cập công khai áp dụng. Nếu ID bị thiếu, không hợp lệ hoặc khác, hãy dừng lại và báo cáo thay vì tuyên bố thành công.Để dùng các phương thức cần khóa và Data API, đăng ký qua HTTP và tạo khóa, rồi làm theo hướng dẫn Data API. Để tăng số dư, nạp tiền trên chuỗi.
Hướng dẫn tích hợp
- Máy chủ MCP Danh sách công cụ, yêu cầu về khóa và cách thiết lập client.
- LangChain Cung cấp cho agent LangChain một công cụ RPC hoặc máy chủ MCP.
- ElizaOS Trỏ plugin EVM tới các endpoint của BlockVectra.
- Coinbase AgentKit Dùng URL RPC của BlockVectra trong AgentKit.
- Hoạt động token cổ phiếu Đọc hoạt động chuyển token cổ phiếu hằng ngày từ Data API.
Quyền như con người
Qua HTTP, agent có thể tạo khóa (POST /keys), thu hồi khóa (POST /keys/{key_id}/revoke), xem số dư (GET /v1/account) và nạp tiền trên chuỗi, với cùng giới hạn và mức giá như một người dùng bảng điều khiển.
Máy chủ MCP đọc tài liệu, chuỗi, trạng thái và giá, gọi RPC chỉ đọc (rpc_call), phát một giao dịch đã ký (send_raw_transaction) và, nếu client đã cấu hình khóa, đọc số dư tài khoản và địa chỉ nạp tiền. Nó không có công cụ tạo hay thu hồi khóa; hãy dùng HTTP cho việc đó.
Mức giá mà agent có thể đọc được
GET /v1/plans trả về trọng số CU của mọi phương thức dưới dạng JSON, giúp có thể ước tính chi phí trước lệnh gọi đầu tiên.
Thanh toán bằng USDC / USDT / USDG →
Gói miễn phí
Bao gồm 30,000,000 CU tín dụng khi đăng ký. Mỗi chu kỳ 30 ngày bắt đầu từ lần sử dụng tính phí đầu tiên và tự động nạp đầy lại lên đến 30,000,000 CU vào cuối kỳ (không tích lũy). Tất cả các khóa chia sẻ mức trung bình 25 lệnh gọi mỗi giây, và cho phép burst trong thời gian ngắn; mỗi khóa giữ giới hạn mặc định 100 CU/giây (burst 400 CU).
khoảng 2,000,000 lệnh gọi eth_call
Không cần thẻ tín dụng — đăng ký ngay lập tức với GitHub, Google hoặc ví của bạn.
Các điểm truy cập dành cho máy
Các tệp và danh mục mà máy đọc được, có thể khám phá mà không cần tài khoản:
Ví dụ sao chép-dán
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":[]}'Chưa có khóa API?
Nếu bạn có ví Ethereum: hãy làm theo hướng dẫn đăng ký tự động (programmatic) để đăng ký và tạo khóa mà không cần trình duyệt. Nếu bạn không có ví: hãy yêu cầu người dùng đăng nhập tại https://console.blockvectra.com, tạo một khóa và đặt khóa đó làm biến môi trường BLOCKVECTRA_API_KEY. Đừng bao giờ yêu cầu người dùng dán khóa vào cuộc trò chuyện.
FAQ
Tôi có thể gọi RPC blockchain mà không cần đăng ký không?
Có. POST https://api.blockvectra.com/v1/<chain>/public hoạt động trên 29 chuỗi mà không cần tài khoản hay khóa API; các phương thức mỗi chuỗi cho phép và giới hạn theo IP nằm trong GET /v1/chains. Các phương thức ngoài danh sách đó và Data API cần khóa API.
Máy chủ MCP có gửi được giao dịch không?
Nó có thể phát một giao dịch, không thể ký. Máy chủ MCP không bao giờ giữ khóa riêng: send_raw_transaction gửi giao dịch bạn đã ký ở nơi khác, qua endpoint không khóa trên các chuỗi có phương thức công khai gồm eth_sendRawTransaction, hoặc bằng khóa API của bạn. Nó không có công cụ tạo hay thu hồi khóa. Xem các công cụ MCP trong hướng dẫn agent AI →
Tôi có phải trả tiền trước khi bắt đầu không?
Không. Lần đăng nhập ví đầu tiên cộng 30,000,000 CU tín dụng miễn phí, không cần thẻ và không cần nạp tiền, còn các endpoint không khóa không cần tài khoản. eth_call tốn 15 CU ($1.50 cho 1,000,000 yêu cầu); mọi mức giá có trong GET /v1/plans, và bạn có thể nạp tiền trên chuỗi khi cần thêm.
Agent AI lấy khóa API thế nào khi không có trình duyệt?
Bằng bốn lệnh gọi HTTP: POST /auth/siwe/challenge, ký thông điệp trả về bằng ví Ethereum (EIP-191), POST /auth/siwe/login (lần đăng nhập đầu tiên tạo tài khoản), rồi POST /keys. Khóa chỉ được trả về một lần; hãy lưu vào BLOCKVECTRA_API_KEY. Làm theo hướng dẫn đăng ký tự động →
Agent AI có thể sử dụng trực tiếp BlockVectra không?
Có. Các agent sử dụng cùng JSON-RPC và Data API công khai như con người, với cùng tài liệu và mức giá; máy chủ MCP tài liệu và các tệp mà máy đọc được không cần khóa. Xem cách kết nối →