BlockVectra Docs
JSON-RPC & Data API docs, chains, status, CU pricing, error help, API key signup. No key needed.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"docs": {
"url": "https://docs.blockvectra.com/mcp"
}
}
}Remote-Endpunkte
https://docs.blockvectra.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (13)
🟢read_doc(path, lang)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"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 '..'."
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"required": [
"path"
]
}🟢search_docs(query, lang, limit)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Keywords to search for in documentation titles, paths, and summaries."
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"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)."
}
},
"required": [
"query"
]
}Ausgabe-Schema
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"path": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"title",
"path",
"summary"
]
}
},
"message": {
"type": "string"
}
},
"required": [
"results"
]
}🟢list_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.
Eingabe-Schema
{
"type": "object",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"chains": {
"type": "array",
"items": {
"type": "object",
"properties": {
"chain": {
"type": "string"
},
"name": {
"type": "string"
},
"chain_id": {
"type": "number"
},
"jsonrpc": {
"type": "boolean"
},
"data": {
"type": "boolean"
},
"ws": {
"type": "boolean"
},
"subscriptions": {
"type": "array",
"items": {
"type": "string"
}
},
"methods": {
"type": [
"object",
"null"
]
},
"max_logs_block_range": {
"type": [
"number",
"null"
]
},
"state_window_blocks": {
"type": [
"number",
"null"
]
}
},
"required": [
"chain"
]
}
}
},
"required": [
"chains"
]
}🟢get_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'.
Eingabe-Schema
{
"type": "object",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"checked_at": {
"type": "string"
},
"gateway": {
"type": "object"
},
"chains": {
"type": "array"
}
},
"required": [
"gateway",
"chains"
]
}🟢get_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.
Eingabe-Schema
{
"type": "object",
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"free": {
"type": "object"
},
"pricing": {
"type": "object"
},
"method_weights": {
"type": "array"
},
"key_defaults": {
"type": "object"
}
},
"required": [
"pricing",
"method_weights"
]
}🟢estimate_usage(lines, method, calls_per_day)
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'.
Eingabe-Schema
{
"type": "object",
"properties": {
"lines": {
"type": "array",
"description": "List of methods and daily call volumes to estimate.",
"items": {
"type": "object",
"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)."
}
},
"required": [
"method",
"calls_per_day"
]
}
},
"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."
}
}
}Ausgabe-Schema
{
"type": "object",
"properties": {
"method": {
"type": "string"
},
"calls_per_day": {
"type": "number"
},
"cu_weight": {
"type": [
"number",
"null"
]
},
"daily_cu": {
"type": "number"
},
"daily_cost_usd": {
"type": [
"number",
"null"
]
},
"cycle_days": {
"type": "number"
},
"cycle_cu": {
"type": "number"
},
"cycle_cost_usd": {
"type": [
"number",
"null"
]
},
"free_quota_cu": {
"type": [
"number",
"null"
]
},
"quota_percent": {
"type": [
"number",
"null"
]
},
"exceeds_free_quota": {
"type": "boolean"
},
"average_calls_per_sec": {
"type": "number"
},
"max_calls_per_sec": {
"type": [
"number",
"null"
]
},
"exceeds_rate_limit": {
"type": "boolean"
}
},
"required": [
"method",
"calls_per_day"
]
}🟢how_to_get_api_key(lang)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"preferred_path": {
"type": "string"
},
"paths": {
"type": "object",
"properties": {
"programmatic": {
"type": "object",
"properties": {
"base_url": {
"type": "string"
},
"guide_url": {
"type": "string"
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"step": {
"type": "number"
},
"name": {
"type": "string"
},
"endpoint": {
"type": [
"string",
"null"
]
},
"description": {
"type": "string"
}
},
"required": [
"step",
"name",
"description"
]
}
},
"rate_limit_policy": {
"type": "object",
"properties": {
"error_code": {
"type": "string"
},
"status": {
"type": "number"
},
"retry_after_header": {
"type": "string"
},
"instruction": {
"type": "string"
}
},
"required": [
"error_code",
"status",
"retry_after_header",
"instruction"
]
},
"token_lifetime": {
"type": "object",
"properties": {
"absolute_ttl_days": {
"type": "number"
},
"idle_ttl_hours": {
"type": "number"
},
"refresh_token": {
"type": "boolean"
},
"description": {
"type": "string"
}
},
"required": [
"absolute_ttl_days",
"idle_ttl_hours",
"refresh_token",
"description"
]
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"security": {
"type": "string"
}
},
"required": [
"base_url",
"guide_url",
"steps",
"rate_limit_policy",
"token_lifetime",
"notes",
"security"
]
},
"browser": {
"type": "object",
"properties": {
"console_url": {
"type": "string"
},
"instructions": {
"type": "string"
}
},
"required": [
"console_url",
"instructions"
]
}
},
"required": [
"programmatic",
"browser"
]
},
"console_url": {
"type": "string"
},
"handoff_instructions": {
"type": "string"
},
"env_var": {
"type": "string"
},
"auth_methods": {
"type": "object",
"properties": {
"data_api": {
"type": "object",
"properties": {
"header": {
"type": "string"
},
"example": {
"type": "string"
}
},
"required": [
"header"
]
},
"json_rpc": {
"type": "object",
"properties": {
"header": {
"type": "string"
},
"bearer": {
"type": "string"
},
"example": {
"type": "string"
}
},
"required": [
"header"
]
}
},
"required": [
"data_api",
"json_rpc"
]
},
"security_notice": {
"type": "string"
}
},
"required": [
"preferred_path",
"paths",
"console_url",
"handoff_instructions",
"env_var",
"auth_methods",
"security_notice"
]
}🟢get_method_info(method, chain)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"method": {
"type": "string",
"description": "Method name (e.g. 'eth_call', 'eth_getBalance', 'debug_traceBlockByNumber', 'data.address_balances')."
},
"chain": {
"type": "string",
"description": "Optional chain slug (e.g. 'robinhood_mainnet'). If specified, only availability for this chain is returned."
}
},
"required": [
"method"
]
}Ausgabe-Schema
{
"type": "object",
"properties": {
"method": {
"type": "string"
},
"chain": {
"type": [
"string",
"null"
]
},
"supported": {
"type": "boolean"
},
"available_chains": {
"type": "array",
"items": {
"type": "string"
}
},
"cu_weight": {
"type": [
"number",
"null"
]
},
"cost_per_million_usd": {
"type": [
"number",
"null"
]
},
"docs_url": {
"type": [
"string",
"null"
]
},
"notes": {
"type": [
"string",
"null"
]
}
},
"required": [
"method",
"supported",
"available_chains"
]
}🟢explain_error(reason, code, http_status, lang)
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.
Eingabe-Schema
{
"type": "object",
"properties": {
"reason": {
"type": "string",
"description": "Error reason slug (e.g. 'invalid_request', 'key_rate_limit', 'insufficient_balance', 'not_found')."
},
"code": {
"type": [
"number",
"string"
],
"description": "Error code (e.g. -32600, -32005, -32020, or console code string like 'siwe_invalid')."
},
"http_status": {
"type": "number",
"description": "HTTP status code (e.g. 200, 400, 402, 404, 429, 500, 503)."
},
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Language for explanations: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"matched": {
"type": "boolean"
},
"count": {
"type": "number"
},
"errors": {
"type": "array",
"items": {
"type": "object",
"properties": {
"code": {
"type": [
"number",
"string"
]
},
"reason": {
"type": [
"string",
"null"
]
},
"http": {
"type": "number"
},
"message": {
"type": "string"
},
"billed": {
"type": [
"boolean",
"string"
]
},
"retryable": {
"type": "boolean"
},
"retry_after": {
"type": [
"string",
"null"
]
},
"action": {
"type": "string"
},
"docs_url": {
"type": "string"
},
"category": {
"type": "string"
}
},
"required": [
"code",
"http",
"message",
"billed",
"retryable",
"action",
"docs_url"
]
}
}
},
"required": [
"matched",
"errors"
]
}🟢list_docs(lang)
List all available documentation pages, relative paths, and titles from the static documentation index. No API key required.
Eingabe-Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string",
"enum": [
"en",
"zh"
],
"description": "Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'."
}
},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"lang": {
"type": "string"
},
"count": {
"type": "number"
},
"docs": {
"type": "array",
"items": {
"type": "object",
"properties": {
"title": {
"type": "string"
},
"path": {
"type": "string"
},
"summary": {
"type": "string"
}
},
"required": [
"title",
"path",
"summary"
]
}
}
},
"required": [
"lang",
"count",
"docs"
]
}🔴rpc_call(chain, method, params)
Execute a JSON-RPC 2.0 method on a specified blockchain network using your BlockVectra API key. 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 raw JSON-RPC response from the server.
Eingabe-Schema
{
"type": "object",
"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')."
},
"params": {
"type": "array",
"description": "Optional JSON-RPC parameter array. Defaults to []."
}
},
"required": [
"chain",
"method"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"jsonrpc": {
"type": "string"
},
"id": {
"type": [
"number",
"string",
"null"
]
},
"result": {},
"error": {
"type": "object",
"properties": {
"code": {
"type": "number"
},
"message": {
"type": "string"
},
"reason": {
"type": [
"string",
"null"
]
},
"docs_url": {
"type": [
"string",
"null"
]
}
}
},
"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)."
}
}
}🟢data_api_get(chain, path, query)
Query the BlockVectra Data API for a specified chain and path using your BlockVectra API key. 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 HTTP status and JSON response body.
Eingabe-Schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"description": "Target blockchain network slug (e.g. 'robinhood_mainnet')."
},
"path": {
"type": "string",
"description": "Path after '/v1/data/{chain}/' (e.g. 'status/freshness', 'address/0x.../balances'). Must not start with '/', and cannot contain '..', '//', '?', '#', or '%'."
},
"query": {
"type": "object",
"description": "Optional URL query parameters as key-value pairs.",
"additionalProperties": {
"type": "string"
}
}
},
"required": [
"chain",
"path"
],
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"status": {
"type": "number"
},
"data": {},
"error": {
"type": "string"
},
"_truncated": {
"type": "boolean"
},
"bytes": {
"type": "integer"
},
"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)."
}
}
}🟢get_account
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.
Eingabe-Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Ausgabe-Schema
{
"type": "object",
"properties": {
"status": {
"type": "number"
},
"data": {},
"error": {
"type": "string"
},
"_truncated": {
"type": "boolean"
},
"bytes": {
"type": "integer"
},
"key_id": {
"type": "string"
},
"plan": {
"type": "string"
},
"balance_units": {
"type": "integer"
},
"balance_cu": {
"type": "integer"
},
"balance_as_of_age_ms": {
"type": "integer"
},
"key": {
"type": "object",
"properties": {
"cu_per_sec": {
"type": "integer"
},
"burst_cu": {
"type": "integer"
},
"cu_cap": {
"type": [
"integer",
"null"
]
},
"cu_cap_remaining": {
"type": [
"integer",
"null"
]
},
"expires_at": {
"type": [
"string",
"null"
]
}
}
}
}
}Community
Nachweis