Serveur MCP

BlockVectra: multi-chain RPC & Data API

com.blockvectra/docs

Ce que fait ce 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.
Lecture seule Accès externe
Schéma d’entrée
{'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}
Schéma de sortie
{'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'.
Lecture seule
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule Accès externe
Schéma d’entrée
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'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')."}}}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'type': 'object', 'additionalProperties': False}
Schéma de sortie
{'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'.
Lecture seule
Schéma d’entrée
{'type': 'object', 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'type': 'object', 'additionalProperties': False}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
Schéma de sortie
{'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').
Lecture seule
Schéma d’entrée
{'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.
Lecture seule Accès externe
Schéma d’entrée
{'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}
Schéma de sortie
{'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.
Lecture seule
Schéma d’entrée
{'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.'}}}
Schéma de sortie
{'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.
Destructif Accès externe
Schéma d’entrée
{'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}
Schéma de sortie
{'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).'}}}
Ajouté
send_raw_transaction
5 October 2026 02:42
Ajouté
get_deposit_address
5 October 2026 02:42
Modifié
data_api_get
5 October 2026 02:42
Modifié
rpc_call
5 October 2026 02:42
Modifié
get_method_info
5 October 2026 02:42
Modifié
how_to_get_api_key
5 October 2026 02:42
Modifié
estimate_usage
5 October 2026 02:42
Modifié
get_pricing
5 October 2026 02:42
Modifié
list_chains
5 October 2026 02:42
Modifié
search_docs
5 October 2026 02:42
Modifié
read_doc
5 October 2026 02:42
Ajouté
get_account
3 October 2026 02:48
Ajouté
data_api_get
3 October 2026 02:48
Ajouté
rpc_call
3 October 2026 02:48
Modifié
how_to_get_api_key
3 October 2026 02:48
Modifié
get_status
3 October 2026 02:48
Modifié
list_chains
3 October 2026 02:48
Ajouté
list_docs
1 October 2026 02:40
Ajouté
explain_error
1 October 2026 02:40
Ajouté
get_method_info
1 October 2026 02:40
Ajouté
how_to_get_api_key
1 October 2026 02:40
Ajouté
estimate_usage
1 October 2026 02:40
Ajouté
get_pricing
1 October 2026 02:40
Ajouté
get_status
1 October 2026 02:40
Ajouté
list_chains
1 October 2026 02:40
Ajouté
search_docs
1 October 2026 02:40
Ajouté
read_doc
1 October 2026 02:40