MCP-Server

BlockVectra: multi-chain RPC & Data API

com.blockvectra/docs
Krypto & Web3 Entwicklertools Wissen & Dokumentation Öffentlich und erreichbar MCP 2025-11-25

Was dieses MCP kann

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.
Nur Lesen Externer Zugriff
Eingabeschema
{'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}
Ausgabeschema
{'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'.
Nur Lesen
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'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}
Ausgabeschema
{'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.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'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.
Nur Lesen Externer Zugriff
Eingabeschema
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'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')."}}}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'type': 'object', 'additionalProperties': False}
Ausgabeschema
{'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'.
Nur Lesen
Eingabeschema
{'type': 'object', 'additionalProperties': False}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'type': 'object', 'additionalProperties': False}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'type': 'object', 'properties': {'lang': {'enum': ['en', 'zh'], 'type': 'string', 'description': "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."}}, 'additionalProperties': False}
Ausgabeschema
{'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').
Nur Lesen
Eingabeschema
{'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.
Nur Lesen Externer Zugriff
Eingabeschema
{'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}
Ausgabeschema
{'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.
Nur Lesen
Eingabeschema
{'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.'}}}
Ausgabeschema
{'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.
Destruktiv Externer Zugriff
Eingabeschema
{'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}
Ausgabeschema
{'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).'}}}
Hinzugefügt
send_raw_transaction
5. October 2026 02:42
Hinzugefügt
get_deposit_address
5. October 2026 02:42
Geändert
data_api_get
5. October 2026 02:42
Geändert
rpc_call
5. October 2026 02:42
Geändert
get_method_info
5. October 2026 02:42
Geändert
how_to_get_api_key
5. October 2026 02:42
Geändert
estimate_usage
5. October 2026 02:42
Geändert
get_pricing
5. October 2026 02:42
Geändert
list_chains
5. October 2026 02:42
Geändert
search_docs
5. October 2026 02:42
Geändert
read_doc
5. October 2026 02:42
Hinzugefügt
get_account
3. October 2026 02:48
Hinzugefügt
data_api_get
3. October 2026 02:48
Hinzugefügt
rpc_call
3. October 2026 02:48
Geändert
how_to_get_api_key
3. October 2026 02:48
Geändert
get_status
3. October 2026 02:48
Geändert
list_chains
3. October 2026 02:48
Hinzugefügt
list_docs
1. October 2026 02:40
Hinzugefügt
explain_error
1. October 2026 02:40
Hinzugefügt
get_method_info
1. October 2026 02:40
Hinzugefügt
how_to_get_api_key
1. October 2026 02:40
Hinzugefügt
estimate_usage
1. October 2026 02:40
Hinzugefügt
get_pricing
1. October 2026 02:40
Hinzugefügt
get_status
1. October 2026 02:40
Hinzugefügt
list_chains
1. October 2026 02:40
Hinzugefügt
search_docs
1. October 2026 02:40
Hinzugefügt
read_doc
1. October 2026 02:40