BlockVectra Docs
JSON-RPC & Data API docs, chains, status, CU pricing, error help, API key signup. No key needed.
我該用這個嗎
品質與安全性
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"docs": {
"url": "https://docs.blockvectra.com/mcp"
}
}
}遠端端點
https://docs.blockvectra.com/mcpstreamable-http它能做什麼
工具清單
工具（13）
🟢read_doc(path, lang)
Read the raw Markdown content of a documentation page from /md/{lang}/{path}.md. Path must be an internal relative path (e.g. 'quickstart', 'guides/ai-agents', 'api/json-rpc', 'chains'). Parent path traversal ('..'), encoded traversal, protocol prefixes, hostnames, query strings and fragments are rejected. Data is retrieved from static documentation build assets.
輸入結構描述
{
"type": "object",
"properties": {
"path": {
"type": "string",
"description": "Internal relative documentation path (e.g. 'quickstart', 'guides/ai-agents', 'api/json-rpc'). Do not include protocol, hostname, query string, fragment, or '..'."
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"required": [
"path"
]
}🟢search_docs(query, lang, limit)
Search documentation pages using keywords against page title, relative path, and first-paragraph summary in the lightweight static search index. Returns matching page titles, paths, and summaries.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords to search for in documentation titles, paths, and summaries."
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Language to search: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
},
"limit": {
"type": "number",
"description": "Maximum number of search results to return (1-20, default 5)."
}
},
"required": [
"query"
]
}輸出結構描述
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"path": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"title",
"path",
"summary"
]
}
},
"message": {
"type": "string"
}
},
"required": [
"results"
]
}🟢list_chains
Fetch supported blockchain networks and static parameters from `GET /v1/chains`. `methods.allow` and `methods.deny` support wildcard patterns where `deny` takes precedence over `allow`. `state_window_blocks` indicates the historical state window in blocks for state queries (null when full history is available); `max_logs_block_range` limits log queries.
輸入結構描述
{
"type": "object",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"chains": {
"type": "array",
"items": {
"type": "object",
"properties": {
"chain": {
"type": "string"
},
"name": {
"type": "string"
},
"chain_id": {
"type": "number"
},
"jsonrpc": {
"type": "boolean"
},
"data": {
"type": "boolean"
},
"ws": {
"type": "boolean"
},
"subscriptions": {
"type": "array",
"items": {
"type": "string"
}
},
"methods": {
"type": [
"object",
"null"
]
},
"max_logs_block_range": {
"type": [
"number",
"null"
]
},
"state_window_blocks": {
"type": [
"number",
"null"
]
}
},
"required": [
"chain"
]
}
}
},
"required": [
"chains"
]
}🟢get_status
Live operational status and network health from `GET /v1/status`. Confirm chain `status` is 'ok' before calling methods; see `list_chains` for static chain capabilities and method policies. For Data API, `data_status` can be 'ok', 'syncing' (queryable and billed normally, but indexing is lagging behind latest block time), or 'unavailable'.
輸入結構描述
{
"type": "object",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"checked_at": {
"type": "string"
},
"gateway": {
"type": "object"
},
"chains": {
"type": "array"
}
},
"required": [
"gateway",
"chains"
]
}🟢get_pricing
Live prices and plan limits from `GET /v1/plans`. Use before estimating cost or when asked about free credits, rate limits or per-method prices. Units: 1 billing unit = `pricing.cu_per_unit` CU; 1 USD buys `pricing.units_per_usd` units. `method_weights` is CU per call; resolve a method by exact match, then the longest prefix rule ending in `*`, then the `*` row (JSON-RPC only; Data API operations have no default). `free.*` values are in billing units; `key_defaults` are per-key CU/s and burst CU. `promo.ends_at` is a sign-up coverage cutoff, not the end of the offer.
輸入結構描述
{
"type": "object",
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"free": {
"type": "object"
},
"pricing": {
"type": "object"
},
"method_weights": {
"type": "array"
},
"key_defaults": {
"type": "object"
}
},
"required": [
"pricing",
"method_weights"
]
}🟢estimate_usage(lines, method, calls_per_day)
Estimate daily and cycle Compute Units (CU) and USD cost for one or more methods and daily call volumes based on /v1/plans method weights and pricing. Pass 'lines' array of {method, calls_per_day}, or legacy single 'method' and 'calls_per_day'.
輸入結構描述
{
"type": "object",
"properties": {
"lines": {
"type": "array",
"description": "List of methods and daily call volumes to estimate.",
"items": {
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "Method name (e.g. 'eth_call', 'eth_getLogs', 'eth_blockNumber', 'data.address_balances')."
},
"calls_per_day": {
"type": "integer",
"minimum": 0,
"description": "Expected daily call volume (non-negative integer)."
}
},
"required": [
"method",
"calls_per_day"
]
}
},
"method": {
"type": "string",
"description": "Exact method name (e.g. 'eth_call', 'eth_getLogs', 'eth_blockNumber', 'data.address_balances'). Legacy single-method mode."
},
"calls_per_day": {
"type": "integer",
"minimum": 0,
"description": "Expected daily call volume (non-negative integer). Legacy single-method mode."
}
}
}輸出結構描述
{
"type": "object",
"properties": {
"method": {
"type": "string"
},
"calls_per_day": {
"type": "number"
},
"cu_weight": {
"type": [
"number",
"null"
]
},
"daily_cu": {
"type": "number"
},
"daily_cost_usd": {
"type": [
"number",
"null"
]
},
"cycle_days": {
"type": "number"
},
"cycle_cu": {
"type": "number"
},
"cycle_cost_usd": {
"type": [
"number",
"null"
]
},
"free_quota_cu": {
"type": [
"number",
"null"
]
},
"quota_percent": {
"type": [
"number",
"null"
]
},
"exceeds_free_quota": {
"type": "boolean"
},
"average_calls_per_sec": {
"type": "number"
},
"max_calls_per_sec": {
"type": [
"number",
"null"
]
},
"exceeds_rate_limit": {
"type": "boolean"
}
},
"required": [
"method",
"calls_per_day"
]
}🟢how_to_get_api_key(lang)
Get instructions and endpoints for obtaining a BlockVectra API key via preferred programmatic SIWE sign-up or browser handoff, plus authentication header and URL formats for JSON-RPC and Data API.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"preferred_path": {
"type": "string"
},
"paths": {
"type": "object",
"properties": {
"programmatic": {
"type": "object",
"properties": {
"base_url": {
"type": "string"
},
"guide_url": {
"type": "string"
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step": {
"type": "number"
},
"name": {
"type": "string"
},
"endpoint": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
}
},
"required": [
"step",
"name",
"description"
]
}
},
"rate_limit_policy": {
"type": "object",
"properties": {
"error_code": {
"type": "string"
},
"status": {
"type": "number"
},
"retry_after_header": {
"type": "string"
},
"instruction": {
"type": "string"
}
},
"required": [
"error_code",
"status",
"retry_after_header",
"instruction"
]
},
"token_lifetime": {
"type": "object",
"properties": {
"absolute_ttl_days": {
"type": "number"
},
"idle_ttl_hours": {
"type": "number"
},
"refresh_token": {
"type": "boolean"
},
"description": {
"type": "string"
}
},
"required": [
"absolute_ttl_days",
"idle_ttl_hours",
"refresh_token",
"description"
]
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"security": {
"type": "string"
}
},
"required": [
"base_url",
"guide_url",
"steps",
"rate_limit_policy",
"token_lifetime",
"notes",
"security"
]
},
"browser": {
"type": "object",
"properties": {
"console_url": {
"type": "string"
},
"instructions": {
"type": "string"
}
},
"required": [
"console_url",
"instructions"
]
}
},
"required": [
"programmatic",
"browser"
]
},
"console_url": {
"type": "string"
},
"handoff_instructions": {
"type": "string"
},
"env_var": {
"type": "string"
},
"auth_methods": {
"type": "object",
"properties": {
"data_api": {
"type": "object",
"properties": {
"header": {
"type": "string"
},
"example": {
"type": "string"
}
},
"required": [
"header"
]
},
"json_rpc": {
"type": "object",
"properties": {
"header": {
"type": "string"
},
"bearer": {
"type": "string"
},
"example": {
"type": "string"
}
},
"required": [
"header"
]
}
},
"required": [
"data_api",
"json_rpc"
]
},
"security_notice": {
"type": "string"
}
},
"required": [
"preferred_path",
"paths",
"console_url",
"handoff_instructions",
"env_var",
"auth_methods",
"security_notice"
]
}🟢get_method_info(method, chain)
Inspect a method's availability across chains (per methods.allow and methods.deny), Compute Unit (CU) weight, price per million calls, and documentation link. Sourced from /v1/chains, /v1/plans, and the documentation catalog.
輸入結構描述
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "Method name (e.g. 'eth_call', 'eth_getBalance', 'debug_traceBlockByNumber', 'data.address_balances')."
},
"chain": {
"type": "string",
"description": "Optional chain slug (e.g. 'robinhood_mainnet'). If specified, only availability for this chain is returned."
}
},
"required": [
"method"
]
}輸出結構描述
{
"type": "object",
"properties": {
"method": {
"type": "string"
},
"chain": {
"type": [
"string",
"null"
]
},
"supported": {
"type": "boolean"
},
"available_chains": {
"type": "array",
"items": {
"type": "string"
}
},
"cu_weight": {
"type": [
"number",
"null"
]
},
"cost_per_million_usd": {
"type": [
"number",
"null"
]
},
"docs_url": {
"type": [
"string",
"null"
]
},
"notes": {
"type": [
"string",
"null"
]
}
},
"required": [
"method",
"supported",
"available_chains"
]
}🟢explain_error(reason, code, http_status, lang)
Lookup error code, reason, or HTTP status in the official error reference catalog. Returns meaning, billing implications (whether the call was billed), retryability, retry delay, recommended agent action, and documentation URL.
輸入結構描述
{
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Error reason slug (e.g. 'invalid_request', 'key_rate_limit', 'insufficient_balance', 'not_found')."
},
"code": {
"type": [
"number",
"string"
],
"description": "Error code (e.g. -32600, -32005, -32020, or console code string like 'siwe_invalid')."
},
"http_status": {
"type": "number",
"description": "HTTP status code (e.g. 200, 400, 402, 404, 429, 500, 503)."
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Language for explanations: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"matched": {
"type": "boolean"
},
"count": {
"type": "number"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": [
"number",
"string"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"http": {
"type": "number"
},
"message": {
"type": "string"
},
"billed": {
"type": [
"boolean",
"string"
]
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": [
"string",
"null"
]
},
"action": {
"type": "string"
},
"docs_url": {
"type": "string"
},
"category": {
"type": "string"
}
},
"required": [
"code",
"http",
"message",
"billed",
"retryable",
"action",
"docs_url"
]
}
}
},
"required": [
"matched",
"errors"
]
}🟢list_docs(lang)
List all available documentation pages, relative paths, and titles from the static documentation index. No API key required.
輸入結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"lang": {
"type": "string"
},
"count": {
"type": "number"
},
"docs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"path": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"title",
"path",
"summary"
]
}
}
},
"required": [
"lang",
"count",
"docs"
]
}🔴rpc_call(chain, method, params)
Execute a JSON-RPC 2.0 method on a specified blockchain network using your BlockVectra API key. Requires the 'x-api-key' or 'Authorization: Bearer <key>' HTTP header in your MCP client configuration (never pass keys in tool parameters or chat). Returns the raw JSON-RPC response from the server.
輸入結構描述
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Target blockchain network slug (e.g. 'robinhood_mainnet'). Must exist in GET /v1/chains."
},
"method": {
"type": "string",
"description": "JSON-RPC 2.0 method name (e.g. 'eth_blockNumber', 'eth_call', 'eth_getLogs')."
},
"params": {
"type": "array",
"description": "Optional JSON-RPC parameter array. Defaults to []."
}
},
"required": [
"chain",
"method"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"jsonrpc": {
"type": "string"
},
"id": {
"type": [
"number",
"string",
"null"
]
},
"result": {},
"error": {
"type": "object",
"properties": {
"code": {
"type": "number"
},
"message": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"docs_url": {
"type": [
"string",
"null"
]
}
}
},
"cu_charged": {
"type": "integer",
"description": "Compute Units billed for this request (only present when charged and x-bv-meter: 1 was sent)."
},
"balance_units": {
"type": "integer",
"description": "Remaining balance units after this request (only present when balance is known and x-bv-meter: 1 was sent)."
}
}
}🟢data_api_get(chain, path, query)
Query the BlockVectra Data API for a specified chain and path using your BlockVectra API key. Requires the 'x-api-key' or 'Authorization: Bearer <key>' HTTP header in your MCP client configuration (never pass keys in tool parameters or chat). Returns the HTTP status and JSON response body.
輸入結構描述
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Target blockchain network slug (e.g. 'robinhood_mainnet')."
},
"path": {
"type": "string",
"description": "Path after '/v1/data/{chain}/' (e.g. 'status/freshness', 'address/0x.../balances'). Must not start with '/', and cannot contain '..', '//', '?', '#', or '%'."
},
"query": {
"type": "object",
"description": "Optional URL query parameters as key-value pairs.",
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"chain",
"path"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "number"
},
"data": {},
"error": {
"type": "string"
},
"_truncated": {
"type": "boolean"
},
"bytes": {
"type": "integer"
},
"cu_charged": {
"type": "integer",
"description": "Compute Units billed for this request (only present when charged and x-bv-meter: 1 was sent)."
},
"balance_units": {
"type": "integer",
"description": "Remaining balance units after this request (only present when balance is known and x-bv-meter: 1 was sent)."
}
}
}🟢get_account
Get the API key's own balance, Compute Units (CU), rate limits, and key parameters from GET /v1/account using your BlockVectra API key. Free and unbilled. Requires the 'x-api-key' or 'Authorization: Bearer <key>' HTTP header in your MCP client configuration (never pass keys in tool parameters or chat). Returns the account's key_id, plan, balance_units, balance_cu, balance_as_of_age_ms, and key limits.
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"status": {
"type": "number"
},
"data": {},
"error": {
"type": "string"
},
"_truncated": {
"type": "boolean"
},
"bytes": {
"type": "integer"
},
"key_id": {
"type": "string"
},
"plan": {
"type": "string"
},
"balance_units": {
"type": "integer"
},
"balance_cu": {
"type": "integer"
},
"balance_as_of_age_ms": {
"type": "integer"
},
"key": {
"type": "object",
"properties": {
"cu_per_sec": {
"type": "integer"
},
"burst_cu": {
"type": "integer"
},
"cu_cap": {
"type": [
"integer",
"null"
]
},
"cu_cap_remaining": {
"type": [
"integer",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
}
}
}
}
}社群
證據