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日2:42
追加
get_deposit_address
2026年10月5日2:42
変更
data_api_get
2026年10月5日2:42
変更
rpc_call
2026年10月5日2:42
変更
get_method_info
2026年10月5日2:42
変更
how_to_get_api_key
2026年10月5日2:42
変更
estimate_usage
2026年10月5日2:42
変更
get_pricing
2026年10月5日2:42
変更
list_chains
2026年10月5日2:42
変更
search_docs
2026年10月5日2:42
変更
read_doc
2026年10月5日2:42
追加
get_account
2026年10月3日2:48
追加
data_api_get
2026年10月3日2:48
追加
rpc_call
2026年10月3日2:48
変更
how_to_get_api_key
2026年10月3日2:48
変更
get_status
2026年10月3日2:48
変更
list_chains
2026年10月3日2:48
追加
list_docs
2026年10月1日2:40
追加
explain_error
2026年10月1日2:40
追加
get_method_info
2026年10月1日2:40
追加
how_to_get_api_key
2026年10月1日2:40
追加
estimate_usage
2026年10月1日2:40
追加
get_pricing
2026年10月1日2:40
追加
get_status
2026年10月1日2:40
追加
list_chains
2026年10月1日2:40
追加
search_docs
2026年10月1日2:40
追加
read_doc
2026年10月1日2:40