MCP Server
BlockVectra Docs
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.
Capabilities
Tools
10
tools
estimate_usage
Estimate Usage and Cost
Estimate daily and cycle Compute Units (CU) and USD cost for one or more methods and daily call volumes based on /v1/plans method weights and pricing. Pass 'lines' array of {method, calls_per_day}, or legacy 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'). Legacy single-method mode."}, 'calls_per_day': {'type': 'integer', 'minimum': 0, 'description': 'Expected daily call volume (non-negative integer). Legacy 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_method_info
Get Method Information
Inspect a method's availability across chains (per methods.allow and methods.deny), Compute Unit (CU) weight, price per million calls, and documentation link. Sourced from /v1/chains, /v1/plans, and the documentation catalog.
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.
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.
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 handoff instructions and steps for obtaining a BlockVectra API key, 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': ['console_url', 'handoff_instructions', 'env_var', 'auth_methods'], 'properties': {'env_var': {'type': 'string'}, 'console_url': {'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'}}}}}, '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': {'data': {'type': 'boolean'}, 'name': {'type': 'string'}, 'chain': {'type': 'string'}, 'jsonrpc': {'type': 'boolean'}, 'methods': {'type': ['object', 'null']}, 'chain_id': {'type': 'number'}, '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'). Parent path traversal ('..'), encoded traversal, protocol prefixes, hostnames, query strings and fragments are rejected. Data is retrieved from static documentation build assets.
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 '..'."}}}
search_docs
Search Documentation
Search documentation pages using keywords against page title, relative path, and first-paragraph summary in the lightweight static search index. 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'}}}}}}
History
Recent tool changes
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.
Discover
Similar MCP servers
Avalanche AVAX MCP
io.github.Airpote/avalanche-docs
Searches and retrieves Avalanche documentation, community proposals, CLI guidance, Builder Console workflows, blockchain identifi…
blobpedia
io.github.UnityNodes/blobpedia
Provides searchable Celestia documentation, governance proposals, forum and GitHub discussions, ecosystem information, release ch…
DERO MCP Server
io.github.DHEBP/dero-mcp-server
Provides read-only DERO blockchain inspection, smart-contract and transaction analysis, TELA app discovery, proof decoding, chain…
mcp-klever-vm
io.github.klever-io/mcp-klever-vm
Supports Klever blockchain smart-contract development with Rust project scaffolding, contract analysis, documentation search, kno…
MetaMask Embedded Wallets (Web3Auth) MCP
io.github.Web3Auth/mcp-server
Searches MetaMask Embedded Wallets documentation, integration examples, community posts, and SDK source references for developers.
cypher-mcp
io.github.lonniev/cypher-mcp
Provides named Cypher graph queries and code-orientation tools for tracing capabilities, symbols, invariants, provenance, changes…
XGR MCP Gateway
io.github.xgr-network/xdala-workflow-builder
Provides an MCP gateway for XGRChain and XDaLa workflows, including blockchain explorer queries, session inspection, transaction …
canton-ccpedia
io.github.UnityNodes/canton-ccpedia
Searches and explains Canton Network and Daml documentation, governance proposals, forums, code examples, APIs, releases, and eco…