BlockVectra: multi-chain RPC & Data API

Official12 tools

by blockvectra · JavaScript

Keyless multi-chain EVM JSON-RPC, indexed Data API, docs, CU pricing and status. API key optional.

com.blockvectra/docs — Model Context Protocol (MCP) Server

The com.blockvectra/docs MCP server provides documentation for a JSON-RPC and Data API. Its materials cover chains and status, CU (compute unit) pricing, error help, and guidance for API key signup. The data indicates “No key needed.”

🛠️ Key Features

JSON-RPC documentation
Data API documentation
Chains and status information
CU pricing details
Error help
API key signup guidance
“No key needed” for usage

🚀 Use Cases

Referencing JSON-RPC and Data API details
Checking supported chains and status
Understanding CU pricing
Troubleshooting API errors via error help
Locating API key signup information when required

⚡ Developer Benefits

Consolidated references for JSON-RPC and Data API docs
Access to chains/status and pricing context
Error help content for debugging

⚠️ Limitations

The provided source data does not describe available MCP tools, schemas, or tool counts.

Topics

ai-agentsblockchain-apiethereumevmjson-rpcmcpmcp-server

Captured live from the server via tools/list.

read_doc

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.

Parameters2

path	string	required	Internal relative documentation path (e.g. 'quickstart', 'guides/ai-agents', 'api/json-rpc'). Do not include protocol, hostname, query string, fragment, or '..'.
lang	string	optional	Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'.

Raw 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

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.

Parameters3

query	string	required	Keywords to search for in documentation titles, paths, and summaries.
lang	string	optional	Language to search: 'en' for English or 'zh' for Chinese. Defaults to 'en'.
limit	number	optional	Maximum number of search results to return (1-20, default 5).

Raw 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"
  ]
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

estimate_usage

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'.

Parameters3

lines	array	optional	List of methods and daily call volumes to estimate.
method	string	optional	Exact method name (e.g. 'eth_call', 'eth_getLogs', 'eth_blockNumber', 'data.address_balances'). Legacy single-method mode.
calls_per_day	integer	optional	Expected daily call volume (non-negative integer). Legacy single-method mode.

Raw 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."
    }
  }
}

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.

Parameters1

lang

string

optional

Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'.

Raw 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
}

get_method_info

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.

Parameters2

method	string	required	Method name (e.g. 'eth_call', 'eth_getBalance', 'debug_traceBlockByNumber', 'data.address_balances').
chain	string	optional	Optional chain slug (e.g. 'robinhood_mainnet'). If specified, only availability for this chain is returned.

Raw 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"
  ]
}

explain_error

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.

Parameters4

reason	string	optional	Error reason slug (e.g. 'invalid_request', 'key_rate_limit', 'insufficient_balance', 'not_found').
code	number \| string	optional	Error code (e.g. -32600, -32005, -32020, or console code string like 'siwe_invalid').
http_status	number	optional	HTTP status code (e.g. 200, 400, 402, 404, 429, 500, 503).
lang	string	optional	Language for explanations: 'en' for English or 'zh' for Chinese. Defaults to 'en'.

Raw 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
}

list_docs

List all available documentation pages, relative paths, and titles from the static documentation index. No API key required.

Parameters1

lang

string

optional

Documentation language: 'en' for English or 'zh' for Chinese. Defaults to 'en'.

Raw 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
}

rpc_call

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 gateway JSON-RPC response.

Parameters3

chain	string	required	Target blockchain network slug (e.g. 'robinhood_mainnet'). Must exist in GET /v1/chains.
method	string	required	JSON-RPC 2.0 method name (e.g. 'eth_blockNumber', 'eth_call', 'eth_getLogs').
params	array	optional	Optional JSON-RPC parameter array. Defaults to [].

Raw 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
}

data_api_get

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.

Parameters3

chain	string	required	Target blockchain network slug (e.g. 'robinhood_mainnet').
path	string	required	Path after '/v1/data/{chain}/' (e.g. 'status/freshness', 'address/0x.../balances'). Must not start with '/', and cannot contain '..', '//', '?', '#', or '%'.
query	object	optional	Optional URL query parameters as key-value pairs.

Raw 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
}

README.md7 KBView on GitHub

BlockVectra MCP server

Remote Model Context Protocol server for BlockVectra: keyless multi-chain EVM JSON-RPC, indexed Data API, docs, CU pricing and status. API key optional.

中文

Install in one step

Server URL (Streamable HTTP, no key needed): https://docs.blockvectra.com/mcp

Client	One-line install	Source
Claude Code	`claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp`	MCP in Claude Code
Claude Code plugin (MCP server + `blockvectra-rpc` skill)	`/plugin marketplace add blockvectra/mcp`, then `/plugin install blockvectra-docs@blockvectra`	Create a marketplace, Plugin dependencies
Cursor	Add to Cursor (web link), or open `cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra-docs&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9`	MCP install links, web link form
VS Code	`code --add-mcp '{"name":"blockvectra-docs","type":"http","url":"https://docs.blockvectra.com/mcp"}'`	Use MCP servers in VS Code
VS Code (link)	`vscode:mcp/install?%7B%22name%22%3A%22blockvectra-docs%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fdocs.blockvectra.com%2Fmcp%22%7D`	MCP developer guide

The Cursor config value is the base64 of {"url":"https://docs.blockvectra.com/mcp"}. The VS Code link is the URL-encoded JSON server configuration.

The plugin is described by .claude-plugin/marketplace.json and .claude-plugin/plugin.json. It installs the blockvectra MCP server from .mcp.json and, as a dependency, the blockvectra-rpc skill from blockvectra/skills.

Endpoint: https://docs.blockvectra.com/mcp (Streamable HTTP, stateless)
Auth: optional x-api-key header (a BlockVectra API key). Authorization: Bearer <key> is also accepted. Without a key you can use the documentation, chain, pricing and status tools, and the JSON-RPC methods that a chain's public endpoint allows.
Never put API keys or private keys in tool arguments or chat; the server reads the key only from HTTP headers.

Chains, prices and limits change, so this README does not list them. Read them live:

Supported chains: GET https://api.blockvectra.com/v1/chains
Plans, prices and limits: GET https://console-api.blockvectra.com/v1/plans
Service status: GET https://api.blockvectra.com/v1/status

More: BlockVectra for agents and AI agents guide.

Tools

This table reflects the server currently live at https://docs.blockvectra.com/mcp. Call tools/list for the authoritative list.

Tool	What it does	API key	Read / write
`read_doc`	Read the raw Markdown of a documentation page	not needed	read-only
`search_docs`	Keyword search over documentation titles, paths and summaries	not needed	read-only
`list_docs`	List all documentation pages	not needed	read-only
`list_chains`	Supported chains, static parameters and method policy (`GET /v1/chains`)	not needed	read-only
`get_status`	Live service and network status (`GET /v1/status`)	not needed	read-only
`get_pricing`	Plans, CU weights and limits (`GET /v1/plans`)	not needed	read-only
`estimate_usage`	Estimate CU and USD cost for methods and daily call volumes	not needed	read-only
`get_method_info`	Per-chain availability, CU weight and price of a JSON-RPC method	not needed	read-only
`explain_error`	Look up an error code or reason: billing, retryability, recommended action	not needed	read-only
`how_to_get_api_key`	Steps to get an API key (programmatic SIWE sign-up or browser handoff) and the auth header formats	not needed	read-only
`rpc_call`	Execute a read-only JSON-RPC 2.0 method on a chain	optional: without a key only the chain's keyless public endpoint is used, where available	read-only
`data_api_get`	Query the Data API for a chain and path	required	read-only
`get_account`	Balance, CU and rate limits of your API key (`GET /v1/account`)	required	read-only
`get_deposit_address`	Your account's on-chain deposit address and open networks	required	read-only
`send_raw_transaction`	Broadcast an already signed raw transaction on a chain	optional: keyless access depends on the chain's public method policy	write (`destructiveHint: true`)

Note: get_deposit_address and the other keyed tools return an error that points to how_to_get_api_key when called without a key.

Use in Cursor / Cline

The keyless Cursor configuration is in .mcp.json, referenced by the Cursor plugin manifest. For Cline's Streamable HTTP setup and optional x-api-key headers, follow llms-install.md. Start without headers: call list_chains, then read_doc with {"path":"quickstart","lang":"en"}.

Connect a client

Each snippet below follows the client's own documentation. Add the optional key header as that documentation describes for custom headers.

Client	Official documentation
Claude Code	MCP in Claude Code
Cursor	Model Context Protocol in Cursor
VS Code	Use MCP servers in VS Code
Codex	Codex MCP

Claude Code

bash

claude mcp add --transport http blockvectra https://docs.blockvectra.com/mcp
# with an API key
claude mcp add --transport http blockvectra https://docs.blockvectra.com/mcp --header "x-api-key: $BLOCKVECTRA_API_KEY"

Cursor (`mcp.json`)

json

{
  "mcpServers": {
    "blockvectra-docs": {
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

VS Code (`.vscode/mcp.json`)

json

{
  "servers": {
    "blockvectra-docs": {
      "type": "http",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}

Codex (`~/.codex/config.toml`)

toml

[mcp_servers.blockvectra]
url = "https://docs.blockvectra.com/mcp"
# optional: read the key from an environment variable
env_http_headers = { "x-api-key" = "BLOCKVECTRA_API_KEY" }

Registry

server.json describes this server for the official MCP Registry under the name com.blockvectra/docs. Publishing is a manual workflow (.github/workflows/publish.yml).

License

MIT

Install

Tools (12)

read_docsearch_docslist_chainsget_statusget_pricingestimate_usagehow_to_get_api_keyget_method_info

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://docs.blockvectra.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs.blockvectra.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

com.blockvectra/docs — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

read_doc

search_docs

list_chains

get_status

get_pricing

estimate_usage

how_to_get_api_key

get_method_info

explain_error

list_docs

rpc_call

data_api_get

BlockVectra MCP server

Install in one step

Tools

Use in Cursor / Cline

Connect a client

Claude Code

Cursor (mcp.json)

VS Code (.vscode/mcp.json)

Codex (~/.codex/config.toml)

Registry

License

Install

Remote endpoint

Related servers

Cursor (`mcp.json`)

VS Code (`.vscode/mcp.json`)

Codex (`~/.codex/config.toml`)