MCP Server

BlockVectra: multi-chain RPC & Data API

com.blockvectra/docs

What this MCP does

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.
Read only Open world
Input schema
{'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}
Output schema
{'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'.
Read only
Input schema
{'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.'}}}
Output schema
{'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.
Read only
Input schema
{'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}
Output schema
{'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.
Read only Open world
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'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.
Read only Open world
Input schema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema
{'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.
Read only
Input schema
{'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')."}}}
Output schema
{'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.
Read only
Input schema
{'type': 'object', 'additionalProperties': False}
Output schema
{'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'.
Read only
Input schema
{'type': 'object', 'additionalProperties': False}
Output schema
{'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.
Read only
Input schema
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
Output schema
{'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.
Read only
Input schema
{'type': 'object', 'additionalProperties': False}
Output schema
{'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.
Read only
Input schema
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
Output schema
{'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').
Read only
Input schema
{'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.
Read only Open world
Input schema
{'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}
Output schema
{'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.
Read only
Input schema
{'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.'}}}
Output schema
{'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.
Destructive Open world
Input schema
{'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}
Output schema
{'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).'}}}
Added
send_raw_transaction
Oct. 5, 2026, 2:42 a.m.
Added
get_deposit_address
Oct. 5, 2026, 2:42 a.m.
Changed
data_api_get
Oct. 5, 2026, 2:42 a.m.
Changed
rpc_call
Oct. 5, 2026, 2:42 a.m.
Changed
get_method_info
Oct. 5, 2026, 2:42 a.m.
Changed
how_to_get_api_key
Oct. 5, 2026, 2:42 a.m.
Changed
estimate_usage
Oct. 5, 2026, 2:42 a.m.
Changed
get_pricing
Oct. 5, 2026, 2:42 a.m.
Changed
list_chains
Oct. 5, 2026, 2:42 a.m.
Changed
search_docs
Oct. 5, 2026, 2:42 a.m.
Changed
read_doc
Oct. 5, 2026, 2:42 a.m.
Added
get_account
Oct. 3, 2026, 2:48 a.m.
Added
data_api_get
Oct. 3, 2026, 2:48 a.m.
Added
rpc_call
Oct. 3, 2026, 2:48 a.m.
Changed
how_to_get_api_key
Oct. 3, 2026, 2:48 a.m.
Changed
get_status
Oct. 3, 2026, 2:48 a.m.
Changed
list_chains
Oct. 3, 2026, 2:48 a.m.
Added
list_docs
Oct. 1, 2026, 2:40 a.m.
Added
explain_error
Oct. 1, 2026, 2:40 a.m.
Added
get_method_info
Oct. 1, 2026, 2:40 a.m.
Added
how_to_get_api_key
Oct. 1, 2026, 2:40 a.m.
Added
estimate_usage
Oct. 1, 2026, 2:40 a.m.
Added
get_pricing
Oct. 1, 2026, 2:40 a.m.
Added
get_status
Oct. 1, 2026, 2:40 a.m.
Added
list_chains
Oct. 1, 2026, 2:40 a.m.
Added
search_docs
Oct. 1, 2026, 2:40 a.m.
Added
read_doc
Oct. 1, 2026, 2:40 a.m.