MCP 服务器

BlockVectra: multi-chain RPC & Data API

com.blockvectra/docs

此 MCP 可以做什么

Provides read-only documentation, supported-chain information, API method details, pricing, status, error explanations, and usage estimates for a blockchain data service.

data_api_get
Query Data API
Query the BlockVectra Data API for a specified chain and path using your BlockVectra API key. For endpoint schemas and parameter specifications, see the OpenAPI contract at https://docs.blockvectra.com/openapi/data.yaml. Requires the 'x-api-key' or 'Authorization: Bearer <key>' HTTP header in your MCP client configuration (keys must not be passed in tool parameters or chat). Returns the HTTP status and JSON response body.
只读 可访问外部资源
输入模式
{'type': 'object', 'required': ['chain', 'path'], 'properties': {'path': {'type': 'string', 'description': "Path after '/v1/data/{chain}/' (e.g. 'status/freshness', 'address/0x.../balances'). Must not start with '/', and cannot contain '..', '//', '?', '#', or '%'."}, 'chain': {'type': 'string', 'description': "Target blockchain network slug (e.g. 'robinhood_mainnet')."}, 'query': {'type': 'object', 'description': 'Optional URL query parameters as key-value pairs.', 'additionalProperties': {'type': 'string'}}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'data': {}, 'bytes': {'type': 'integer'}, 'error': {'type': 'string'}, 'status': {'type': 'number'}, '_truncated': {'type': 'boolean'}, '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).'}}}
estimate_usage
Estimate Usage and Cost
Calculate projected daily and billing cycle Compute Units (CU) and USD costs for planned call volumes across one or more methods, factoring in method weights and free credit allowances from /v1/plans. Also evaluates whether traffic requires multiple API keys under key_defaults. Use this tool for volume budget calculations and capacity planning. For looking up raw system pricing tables, use get_pricing instead. For checking whether a single method is supported on a specific chain, use get_method_info instead. Accepts 'lines' array of {method, calls_per_day} or single 'method' and 'calls_per_day'.
只读
输入模式
{'type': 'object', 'properties': {'lines': {'type': 'array', 'items': {'type': 'object', 'required': ['method', 'calls_per_day'], '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).'}}}, 'description': 'List of methods and daily call volumes to estimate.'}, 'method': {'type': 'string', 'description': "Exact method name (e.g. 'eth_call', 'eth_getLogs', 'eth_blockNumber', 'data.address_balances'). Single-method mode."}, 'calls_per_day': {'type': 'integer', 'minimum': 0, 'description': 'Expected daily call volume (non-negative integer). Single-method mode.'}}}
输出模式
{'type': 'object', 'required': ['method', 'calls_per_day'], 'properties': {'method': {'type': 'string'}, 'cycle_cu': {'type': 'number'}, 'daily_cu': {'type': 'number'}, 'cu_weight': {'type': ['number', 'null']}, 'cycle_days': {'type': 'number'}, 'calls_per_day': {'type': 'number'}, 'free_quota_cu': {'type': ['number', 'null']}, 'quota_percent': {'type': ['number', 'null']}, 'cycle_cost_usd': {'type': ['number', 'null']}, 'daily_cost_usd': {'type': ['number', 'null']}, 'max_calls_per_sec': {'type': ['number', 'null']}, 'exceeds_free_quota': {'type': 'boolean'}, 'exceeds_rate_limit': {'type': 'boolean'}, 'average_calls_per_sec': {'type': 'number'}}}
explain_error
Explain Error Code or Reason
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': {'code': {'type': ['number', 'string'], 'description': "Error code (e.g. -32600, -32005, -32020, or console code string like 'siwe_invalid')."}, 'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Language for explanations: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}, 'reason': {'type': 'string', 'description': "Error reason slug (e.g. 'invalid_request', 'key_rate_limit', 'insufficient_balance', 'not_found')."}, 'http_status': {'type': 'number', 'description': 'HTTP status code (e.g. 200, 400, 402, 404, 429, 500, 503).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['matched', 'errors'], 'properties': {'count': {'type': 'number'}, 'errors': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'http', 'message', 'billed', 'retryable', 'action', 'docs_url'], 'properties': {'code': {'type': ['number', 'string']}, 'http': {'type': 'number'}, 'action': {'type': 'string'}, 'billed': {'type': ['boolean', 'string']}, 'reason': {'type': ['string', 'null']}, 'message': {'type': 'string'}, 'category': {'type': 'string'}, 'docs_url': {'type': 'string'}, 'retryable': {'type': 'boolean'}, 'retry_after': {'type': ['string', 'null']}}}}, 'matched': {'type': 'boolean'}}}
get_account
Get Account Balance and Limits
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': {'key': {'type': 'object', 'properties': {'cu_cap': {'type': ['integer', 'null']}, 'burst_cu': {'type': 'integer'}, 'cu_per_sec': {'type': 'integer'}, 'expires_at': {'type': ['string', 'null']}, 'cu_cap_remaining': {'type': ['integer', 'null']}}}, 'data': {}, 'plan': {'type': 'string'}, 'bytes': {'type': 'integer'}, 'error': {'type': 'string'}, 'key_id': {'type': 'string'}, 'status': {'type': 'number'}, '_truncated': {'type': 'boolean'}, 'balance_cu': {'type': 'integer'}, 'balance_units': {'type': 'integer'}, 'balance_as_of_age_ms': {'type': 'integer'}}}
get_deposit_address
Get Deposit Address and Open Networks
Requires an API key. Get your account's dedicated on-chain deposit address and open networks to top up balance; only transfer to the listed networks and tokens.
只读 可访问外部资源
输入模式
{'type': 'object', 'properties': {}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'data': {}, 'bytes': {'type': 'integer'}, 'error': {'type': 'string'}, 'status': {'type': 'number'}, 'address': {'type': 'string'}, 'networks': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'chain': {'type': 'string'}, 'tokens': {'type': 'array', 'items': {'type': 'object', 'properties': {'symbol': {'type': 'string'}, 'contract': {'type': 'string'}, 'decimals': {'type': 'integer'}, 'min_amount_raw': {'type': 'string'}}}}, 'chain_id': {'type': 'integer'}, 'explorer_tx_url': {'type': 'string'}, 'typical_credit_seconds': {'type': 'integer'}}}}, '_truncated': {'type': 'boolean'}, 'deposits_url': {'type': 'string'}, 'min_deposit_usd': {'type': 'string'}}}
get_method_info
Get Method Information
Inspect a single method's chain-by-chain availability, Compute Unit (CU) weight, price per million calls, and documentation link. Evaluates chain method policies (methods.allow and methods.deny from /v1/chains) and pricing rules from /v1/plans. Use this tool to check if a specific method can be invoked on a target chain. For the full system-wide pricing schedule and rate card, use get_pricing instead. For calculating projected bills for expected call volumes across methods, use estimate_usage instead.
只读
输入模式
{'type': 'object', 'required': ['method'], 'properties': {'chain': {'type': 'string', 'description': "Optional chain slug (e.g. 'robinhood_mainnet'). If specified, only availability for this chain is returned."}, 'method': {'type': 'string', 'description': "Method name (e.g. 'eth_call', 'eth_getBalance', 'debug_traceBlockByNumber', 'data.address_balances')."}}}
输出模式
{'type': 'object', 'required': ['method', 'supported', 'available_chains'], 'properties': {'chain': {'type': ['string', 'null']}, 'notes': {'type': ['string', 'null']}, 'method': {'type': 'string'}, 'docs_url': {'type': ['string', 'null']}, 'cu_weight': {'type': ['number', 'null']}, 'supported': {'type': 'boolean'}, 'available_chains': {'type': 'array', 'items': {'type': 'string'}}, 'cost_per_million_usd': {'type': ['number', 'null']}}}
get_pricing
Get Plans and 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. For a single method's chain support and documentation use get_method_info instead; for projecting cycle costs use estimate_usage instead.
只读
输入模式
{'type': 'object', 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['pricing', 'method_weights'], 'properties': {'free': {'type': 'object'}, 'pricing': {'type': 'object'}, 'key_defaults': {'type': 'object'}, 'method_weights': {'type': 'array'}}}
get_status
Get Service and Network 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', 'required': ['gateway', 'chains'], 'properties': {'chains': {'type': 'array'}, 'gateway': {'type': 'object'}, 'checked_at': {'type': 'string'}}}
how_to_get_api_key
How to Get API Key
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': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['preferred_path', 'paths', 'handoff_instructions', 'env_var', 'auth_methods'], 'properties': {'paths': {'type': 'object', 'required': ['programmatic', 'browser'], 'properties': {'browser': {'type': 'object', 'required': ['console_url', 'instructions'], 'properties': {'console_url': {'type': 'string'}, 'instructions': {'type': 'string'}}}, 'programmatic': {'type': 'object', 'required': ['base_url', 'guide_url', 'steps', 'rate_limit_policy', 'token_lifetime', 'notes', 'security'], 'properties': {'notes': {'type': 'array', 'items': {'type': 'string'}}, 'steps': {'type': 'array', 'items': {'type': 'object', 'required': ['step', 'name', 'description'], 'properties': {'name': {'type': 'string'}, 'step': {'type': 'number'}, 'endpoint': {'type': ['string', 'null']}, 'description': {'type': 'string'}}}}, 'base_url': {'type': 'string'}, 'security': {'type': 'string'}, 'guide_url': {'type': 'string'}, 'token_lifetime': {'type': 'object', 'required': ['absolute_ttl_days', 'idle_ttl_hours', 'refresh_token', 'description'], 'properties': {'description': {'type': 'string'}, 'refresh_token': {'type': 'boolean'}, 'idle_ttl_hours': {'type': 'number'}, 'absolute_ttl_days': {'type': 'number'}}}, 'rate_limit_policy': {'type': 'object', 'required': ['error_code', 'status', 'retry_after_header', 'instruction'], 'properties': {'status': {'type': 'number'}, 'error_code': {'type': 'string'}, 'instruction': {'type': 'string'}, 'retry_after_header': {'type': 'string'}}}}}}}, 'env_var': {'type': 'string'}, 'auth_methods': {'type': 'object', 'required': ['data_api', 'json_rpc'], 'properties': {'data_api': {'type': 'object', 'required': ['header'], 'properties': {'header': {'type': 'string'}, 'example': {'type': 'string'}}}, 'json_rpc': {'type': 'object', 'required': ['header'], 'properties': {'bearer': {'type': 'string'}, 'header': {'type': 'string'}, 'example': {'type': 'string'}}}}}, 'preferred_path': {'type': 'string'}, 'handoff_instructions': {'type': 'string'}}}
list_chains
List Supported 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', 'required': ['chains'], 'properties': {'chains': {'type': 'array', 'items': {'type': 'object', 'required': ['chain'], 'properties': {'ws': {'type': 'boolean'}, 'data': {'type': 'boolean'}, 'name': {'type': 'string'}, 'chain': {'type': 'string'}, 'public': {'type': 'object', 'required': ['url', 'methods', 'rate_limit'], 'properties': {'url': {'type': 'string'}, 'methods': {'type': 'array', 'items': {'type': 'string'}}, 'rate_limit': {'type': 'object', 'required': ['per_ip_rps', 'burst', 'batch_max'], 'properties': {'burst': {'type': 'number'}, 'batch_max': {'type': 'number'}, 'per_ip_rps': {'type': 'number'}}}, 'history_blocks': {'type': 'number'}, 'send_raw_rate_limit': {'type': 'object', 'required': ['per_ip_rps', 'burst'], 'properties': {'burst': {'type': 'number'}, 'per_ip_rps': {'type': 'number'}}}}}, 'jsonrpc': {'type': 'boolean'}, 'methods': {'type': ['object', 'null']}, 'chain_id': {'type': 'number'}, 'subscriptions': {'type': 'array', 'items': {'type': 'string'}}, 'state_window_blocks': {'type': ['number', 'null']}, 'max_logs_block_range': {'type': ['number', 'null']}}}}}}
list_docs
List Documentation Pages
List all available documentation pages, relative paths, and titles from the static documentation index. No API key required.
只读
输入模式
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'required': ['lang', 'count', 'docs'], 'properties': {'docs': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'path', 'summary'], 'properties': {'path': {'type': 'string'}, 'title': {'type': 'string'}, 'summary': {'type': 'string'}}}}, 'lang': {'type': 'string'}, 'count': {'type': 'number'}}}
read_doc
Read Documentation Page
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').
只读
输入模式
{'type': 'object', 'required': ['path'], 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}, '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 '..'."}}}
rpc_call
Call JSON-RPC Method
Execute a read-only JSON-RPC 2.0 method on a specified blockchain network using your BlockVectra API key, or via the keyless public endpoint if available on the chain. Write methods (such as 'eth_sendRawTransaction') are not supported in rpc_call; use 'send_raw_transaction' instead. Consult the Ethereum JSON-RPC specification (https://ethereum.org/en/developers/docs/apis/json-rpc/) and the BlockVectra method reference (https://docs.blockvectra.com/en/api/json-rpc/methods/). Requires the 'x-api-key' or 'Authorization: Bearer <key>' HTTP header in your MCP client configuration for full access (keys must not be passed in tool parameters or chat). Returns the raw JSON-RPC response from the server.
只读 可访问外部资源
输入模式
{'type': 'object', 'required': ['chain', 'method'], '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'). Write methods are not accepted."}, 'params': {'type': 'array', 'description': 'Optional JSON-RPC parameter array. Defaults to [].'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'id': {'type': ['number', 'string', 'null']}, 'help': {'type': 'object', 'properties': {'tool': {'type': 'string'}, 'guide_url': {'type': 'string'}}}, 'error': {'type': ['object', 'string'], 'properties': {'code': {'type': 'number'}, 'reason': {'type': ['string', 'null']}, 'message': {'type': 'string'}, 'docs_url': {'type': ['string', 'null']}}}, 'result': {}, 'jsonrpc': {'type': 'string'}, 'message': {'type': 'string'}, 'cu_charged': {'type': 'integer', 'description': 'Compute Units billed for this request (only present when charged and x-bv-meter: 1 was sent).'}, 'signup_url': {'type': 'string', 'description': 'Registration and sign-up URL (returned when rate-limited on the public endpoint).'}, 'balance_units': {'type': 'integer', 'description': 'Remaining balance units after this request (only present when balance is known and x-bv-meter: 1 was sent).'}}}
search_docs
Search Documentation
Search documentation pages using keywords against page title, relative path, and first-paragraph summary. Returns matching page titles, paths, and summaries.
只读
输入模式
{'type': 'object', 'required': ['query'], 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', '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).'}, 'query': {'type': 'string', 'description': 'Keywords to search for in documentation titles, paths, and summaries.'}}}
输出模式
{'type': 'object', 'required': ['results'], 'properties': {'message': {'type': 'string'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'path', 'summary'], 'properties': {'path': {'type': 'string'}, 'title': {'type': 'string'}, 'summary': {'type': 'string'}}}}}}
send_raw_transaction
Send Raw Transaction
Broadcast a signed raw transaction to a specified blockchain network via eth_sendRawTransaction. Requires the 'x-api-key' or 'Authorization: Bearer <key>' HTTP header in your MCP client configuration for full access, or uses the keyless public endpoint if permitted on the chain (keys must not be passed in tool parameters or chat). Returns the transaction hash or JSON-RPC error.
可能执行破坏性操作 可访问外部资源
输入模式
{'type': 'object', 'required': ['chain', 'raw_tx'], 'properties': {'chain': {'type': 'string', 'description': "Target blockchain network slug (e.g. 'robinhood_mainnet'). Must exist in GET /v1/chains."}, 'raw_tx': {'type': 'string', 'pattern': '^0x([0-9a-fA-F]{2})+$', 'description': 'Signed raw transaction data as a 0x-prefixed hex string (the RLP-encoded raw transaction).'}}, 'additionalProperties': False}
输出模式
{'type': 'object', 'properties': {'id': {'type': ['number', 'string', 'null']}, 'help': {'type': 'object', 'properties': {'tool': {'type': 'string'}, 'guide_url': {'type': 'string'}}}, 'error': {'type': ['object', 'string'], 'properties': {'code': {'type': 'number'}, 'reason': {'type': ['string', 'null']}, 'message': {'type': 'string'}, 'docs_url': {'type': ['string', 'null']}}}, 'result': {}, 'jsonrpc': {'type': 'string'}, 'message': {'type': 'string'}, 'cu_charged': {'type': 'integer', 'description': 'Compute Units billed for this request (only present when charged and x-bv-meter: 1 was sent).'}, 'signup_url': {'type': 'string', 'description': 'Registration and sign-up URL (returned when rate-limited on the public endpoint).'}, 'balance_units': {'type': 'integer', 'description': 'Remaining balance units after this request (only present when balance is known and x-bv-meter: 1 was sent).'}}}
已添加
send_raw_transaction
2026年10月5日 02:42
已添加
get_deposit_address
2026年10月5日 02:42
已更改
data_api_get
2026年10月5日 02:42
已更改
rpc_call
2026年10月5日 02:42
已更改
get_method_info
2026年10月5日 02:42
已更改
how_to_get_api_key
2026年10月5日 02:42
已更改
estimate_usage
2026年10月5日 02:42
已更改
get_pricing
2026年10月5日 02:42
已更改
list_chains
2026年10月5日 02:42
已更改
search_docs
2026年10月5日 02:42
已更改
read_doc
2026年10月5日 02:42
已添加
get_account
2026年10月3日 02:48
已添加
data_api_get
2026年10月3日 02:48
已添加
rpc_call
2026年10月3日 02:48
已更改
how_to_get_api_key
2026年10月3日 02:48
已更改
get_status
2026年10月3日 02:48
已更改
list_chains
2026年10月3日 02:48
已添加
list_docs
2026年10月1日 02:40
已添加
explain_error
2026年10月1日 02:40
已添加
get_method_info
2026年10月1日 02:40
已添加
how_to_get_api_key
2026年10月1日 02:40
已添加
estimate_usage
2026年10月1日 02:40
已添加
get_pricing
2026年10月1日 02:40
已添加
get_status
2026年10月1日 02:40
已添加
list_chains
2026年10月1日 02:40
已添加
search_docs
2026年10月1日 02:40
已添加
read_doc
2026年10月1日 02:40