BlockVectra MCP server

Remote Model Context Protocol server for BlockVectra: multi-chain EVM JSON-RPC, indexed Data API, docs, CU pricing and status. Documentation, discovery, pricing and status need no API key. Keyless RPC depends on each chain’s public method policy; indexed Data API and account tools require your own BlockVectra API key.

中文

Robinhood Chain mainnet and testnet tasks

Use the chain RPC guide for mainnet public read-only RPC tasks. Use the testnet starter and faucet guide for testnet tasks. Mainnet public reads do not require claiming testnet tokens first.

Connect to https://docs.blockvectra.com/mcp without headers for documentation and discovery. Robinhood Chain public endpoints allow supported RPC reads without a key; methods outside the public policy require an API key. Faucet claims require x-api-key. HTTP 202 means accepted; check the transaction receipt for on-chain inclusion (status: "0x1"), which is not finality.

For a first mainnet RPC check before configuring an MCP client, use the keyless TypeScript Quickstart. With Node.js >=24.12 and Git, it runs without installing dependencies: it reads the chain directory, verifies the chain ID, and reads the latest block number, with no wallet, account or API key.

Documentation Skill for coding agents

For source-linked setup answers, install the blockvectra-docs Skill from your project directory with Node.js 22.20 or newer, then select your agent:

npx --yes [email protected] add blockvectra/agent-quickstart --skill blockvectra-docs

Try: “How do I get started on Robinhood Chain? Separate mainnet from testnet and cite the docs.”

The Skill uses a configured BlockVectra MCP connection (search_docs, then read_doc) or your agent’s HTTP reader to find and read Markdown pages. Documentation lookup needs no BlockVectra account or API key. Follow the MCP setup below to configure a server connection for RPC, indexed data and account tools.

Install in one step

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

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

Local stdio bridge

Use Node.js 22 or newer to run the MIT-licensed stdio bridge:

npx --yes --package @blockvectra/[email protected] blockvectra-mcp

This uses the published npm release 0.1.0. For documentation only, use the versioned GitHub package below.

Configure a stdio client:

{
  "mcpServers": {
    "blockvectra-docs": {
      "command": "npx",
      "args": ["--yes", "--package", "@blockvectra/[email protected]", "blockvectra-mcp"]
    }
  }
}

For a source checkout, run npm ci, then use node with the absolute path to src/cli.js instead.

The CLI always bridges to https://docs.blockvectra.com/mcp; it accepts no command-line arguments. Optionally supply BLOCKVECTRA_API_KEY through the child process environment or your client’s private environment settings. It is forwarded only as x-api-key. Never put a key in CLI arguments, tool arguments, or chat; never supply private keys.

The default entry connects the official StreamableHTTPClientTransport and StdioServerTransport directly, without rebuilding capabilities or tools. It preserves initialize parameters/results, capabilities, instructions, protocolVersion, tool results, JSON-RPC errors, notifications and bidirectional requests at the JSON message level (not byte formatting). After a successful initialize response, it sets the HTTP transport’s negotiated protocol version before forwarding that response. stdout contains MCP messages only; stderr uses fixed diagnostics without SDK error text. EOF, SIGINT and SIGTERM close both transports; transport failures close the bridge with exit code 1. HTTP/SSE behavior, parsing and reconnection remain SDK behavior.

Dependencies are pinned to official @modelcontextprotocol/client and @modelcontextprotocol/server 2.3.1, whose published package exports and source provide these transports and require Node >=20. See the official SDK repository/releases and connection documentation. As of 2026-10-13, Node’s official release table lists Node 20 as EOL and Node 22 as LTS, so this package requires Node >=22.

Local verification: npm test runs only the serial mock HTTP/real stdio subprocess tests; npm pack --dry-run checks the package contents. No build is required.

Documentation-only stdio

For a setup helper that needs just search_docs and read_doc, use Node.js 22+:

npx --yes --package https://github.com/blockvectra/mcp/releases/download/v0.1.1/blockvectra-mcp-0.1.1.tgz blockvectra-docs-mcp

This installs the GitHub 0.1.1 package and its dependencies; no BlockVectra account or key is needed. This package includes the documentation-only command; npm 0.1.0 does not. The GitHub package is available without waiting for an npm 0.1.1 publication. Verify a downloaded package against the release’s SHA256SUMS before installing it locally.

For clients that use an mcpServers configuration, select the documentation-only command explicitly:

{
  "mcpServers": {
    "blockvectra-docs-only": {
      "command": "npx",
      "args": [
        "--yes",
        "--package",
        "https://github.com/blockvectra/mcp/releases/download/v0.1.1/blockvectra-mcp-0.1.1.tgz",
        "blockvectra-docs-mcp"
      ]
    }
  }
}

Restart the client and ask it to find the Robinhood Chain setup guide with search_docs, then read one returned document with read_doc.

For a source checkout, run npm ci, then use node /absolute/path/to/blockvectra-mcp/src/docs-cli.js instead. This entry lists only the two documentation tools and locally rejects other tool calls and non-documentation methods before forwarding. It does not forward BLOCKVECTRA_API_KEY, even if inherited. It also omits other server capabilities and does not expose reverse client requests such as sampling or roots.

The default src/cli.js entry remains the full bridge described above. @blockvectra/[email protected] does not include the documentation-only entry. This limits this MCP connection, not the host agent’s other tools, shell or network access. Model or hosting charges are separate.

goose: keyless documentation lookup

Use goose with your configured model provider. The documentation tools need no BlockVectra account or API key.

Download and run the documentation recipe. You only need this JSON file, not a checkout of the repository:

curl --fail --location --output blockvectra-goose-docs.json \
  https://raw.githubusercontent.com/blockvectra/mcp/8c99c0e499166d8ba2163536f8d150571783c0a3/recipes/goose-docs.json
goose recipe validate blockvectra-goose-docs.json
goose run --recipe blockvectra-goose-docs.json

It asks search_docs for Robinhood Chain mainnet setup, then reads one returned document with read_doc. The recipe lists only those two tools; it does not include RPC, account or transaction tools. A successful result should cite the document and explain which connection steps need a key. The model uses your goose provider’s normal quota or billing.

For an interactive session instead, add the remote extension for that session:

goose session --with-streamable-http-extension "https://docs.blockvectra.com/mcp"

That session discovers the full tool catalog; the recipe is the smaller documentation-only starting point. See the goose extension guide and recipe reference.

Portable RPC documentation agent

For a small hosted-agent demonstration, use the portable instructions and evaluation cases. They reuse the two-tool documentation task above. This is a prompt and demo brief, not a Lagrange manifest or a verified deployment; host tool filtering and model/hosting charges are separate.

n8n: offline proposal check

For a regular n8n MCP Client workflow, this recipe shows how to check a proposed rpc_call offline before any MCP node runs. Paste the Code node and compare it against the fixtures. With the trusted budgets set to zero, every receipt is an advisory comparison and dispatch is always DENY. It is not funding authorization or execution, and it has not been run in a real n8n instance. Read the guide for setup and limits.

Gemini CLI extension

The extension connects to https://docs.blockvectra.com/mcp directly over remote Streamable HTTP. You do not need the local stdio bridge or npm.

After installing, restart Gemini CLI and run /mcp to inspect the available tools. Try list_chains, then call read_doc with path=quickstart and lang=en.

Optional authentication

The extension is keyless by default: documentation, discovery, pricing and status stay keyless; RPC follows each chain’s public method policy; indexed data and account tools need your own BlockVectra API key. Never put a key in argv, tool arguments, chat or version control, and do not export a literal key into shell history. Make BLOCKVECTRA_API_KEY available in Gemini’s process environment before launch, using your existing private secret manager or private launch environment; a .gemini/.env file alone is not sufficient.

To send the key as a header, merge this into your user ~/.gemini/settings.json without replacing other settings:

{
  "mcpServers": {
    "blockvectra-docs": {
      "httpUrl": "https://docs.blockvectra.com/mcp",
      "headers": { "x-api-key": "${BLOCKVECTRA_API_KEY}" }
    }
  }
}

This user-scope entry overrides the extension’s server of the same name. Restart Gemini CLI after configuring it. gemini mcp list or /mcp only checks connectivity, not successful account or data authorization; to verify authentication, intentionally call the read-only get_account tool and keep the returned account data private.

Tested with official Gemini CLI 0.65.0 against a local mock with a synthetic key; this verifies client configuration and header transmission, not live keyed tool behavior. See Gemini CLI MCP custom headers.

Antigravity plugin

The plugin connects to https://docs.blockvectra.com/mcp directly over remote Streamable HTTP. You do not need the local stdio bridge or npm.

Install in the current project

Run these commands from your project root:

mkdir -p .agents/plugins/blockvectra-docs
curl --fail --location https://raw.githubusercontent.com/blockvectra/mcp/antigravity-v0.1.0/plugin.json --output .agents/plugins/blockvectra-docs/plugin.json
curl --fail --location https://raw.githubusercontent.com/blockvectra/mcp/antigravity-v0.1.0/mcp_config.json --output .agents/plugins/blockvectra-docs/mcp_config.json

Start agy in that directory. For a first check, ask it to call search_docs with {"query":"Antigravity","lang":"en","limit":1}. Project-local loading and this single keyless documentation search were verified with Antigravity CLI 1.4.7.

The official plugin guide describes project-local and global installation. The commands above place the plugin in this project’s .agents/plugins/ directory.

After installation

After installing, restart Antigravity and run /mcp to inspect the available tools. Try list_chains, then call read_doc with path=quickstart and lang=en.

The plugin is keyless by default: documentation, discovery, pricing and status stay keyless; RPC follows each chain’s public method policy; indexed data and account tools need your own BlockVectra API key. Never put a key in tool arguments, chat or version control. To send a key, configure it as a private header in your client, following MCP in Antigravity and your client’s private header settings.

Tools

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

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.

Claude Code

claude mcp add --transport http blockvectra https://docs.blockvectra.com/mcp
# For an optional key, use private environment-backed header settings;
# see the Codex env_http_headers example below. Never pass a key as a CLI argument.

Cursor (.cursor/mcp.json)

Merge this server into your project’s .cursor/mcp.json, preserving any existing servers:

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

For Cursor CLI, run these commands from that project directory to approve the connection and list its tools:

agent mcp enable blockvectra-docs
agent mcp list-tools blockvectra-docs

See Cursor CLI MCP commands.

VS Code (.vscode/mcp.json)

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

Codex (~/.codex/config.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