BlockVectra: multi-chain RPC & Data API

BlockVectra MCP サーバー

BlockVectra 用のリモートModel Context Protocolサーバーです。マルチチェーン EVM JSON-RPC、インデックス化された Data API、ドキュメント、CU 料金、ステータスを提供します。ドキュメント、検出、料金、ステータスの確認には API キーは不要です。キー不要の RPC は、各チェーンの公開メソッドポリシーに依存します。インデックス化された Data API とアカウントツールには、ご自身の BlockVectra API キーが必要です。

中文

Robinhood Chain のメインネットおよびテストネットのタスク

メインネットでの公開読み取り専用 RPC タスクには、チェーン RPC ガイドを使用してください。テストネットのタスクには、テストネット入門ガイドとファウセットガイドを使用してください。メインネットで公開データを読み取る際、事前にテストネットトークンを受け取る必要はありません。

ドキュメントと検出には、ヘッダーを付けずに https://docs.blockvectra.com/mcp に接続してください。Robinhood Chain の公開エンドポイントでは、サポート対象の RPC 読み取りをキーなしで実行できます。公開ポリシーの対象外のメソッドには API キーが必要です。ファウセットの請求には x-api-key が必要です。HTTP 202 はリクエストが受け付けられたことを意味します。オンチェーンへの取り込みを確認するにはトランザクションレシートを確認してください（status: "0x1"）。これはファイナリティを意味するものではありません。

ローカル stdio ブリッジ

MIT ライセンスの stdio ブリッジを実行するには、Node.js 22 以降を使用してください。

npx --yes @blockvectra/[email protected]

stdio クライアントを設定します。

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

ソースをチェックアウトしている場合は、npm ci を実行してから、src/cli.js の絶対パスを指定して node を使用してください。

CLI は常に https://docs.blockvectra.com/mcp にブリッジし、コマンドライン引数を受け付けません。必要に応じて、子プロセス環境またはクライアントのプライベート環境設定を通じて BLOCKVECTRA_API_KEY を指定してください。これは x-api-key としてのみ転送されます。キーを CLI 引数、ツール引数、チャットに含めないでください。秘密鍵も指定しないでください。

このブリッジは、公式の StreamableHTTPClientTransport と StdioServerTransport を直接接続し、機能やツールを再構築しません。初期化パラメーターと結果、機能、指示、protocolVersion、ツールの結果、JSON-RPC エラー、通知、双方向リクエストを、JSON メッセージレベルで保持します（バイト形式は保持しません）。初期化の応答に成功した後、その応答を転送する前に、HTTP トランスポートにネゴシエート済みのプロトコルバージョンを設定します。stdout には MCP メッセージのみが出力されます。stderr には SDK のエラーテキストを含まない固定診断メッセージが出力されます。EOF、SIGINT、SIGTERM を受け取ると両方のトランスポートを閉じます。トランスポート障害が発生すると、ブリッジを終了コード 1 で終了します。HTTP/SSE の動作、解析、再接続は SDK の動作に従います。

依存関係には公式の @modelcontextprotocol/client と @modelcontextprotocol/server の 2.3.1 を固定しており、これらの公開パッケージのエクスポートとソースが各トランスポートを提供し、Node >=20 を必要とします。公式 SDK リポジトリ／リリースと接続ドキュメントを参照してください。2026-10-13 時点で、Node の公式リリース一覧では Node 20 は EOL、Node 22 は LTS とされているため、このパッケージには Node >=22 が必要です。

ローカル検証では、npm test はシリアルのモック HTTP／実 stdio サブプロセステストのみを実行し、npm pack --dry-run はパッケージの内容を確認します。ビルドは不要です。

1 ステップでインストール

サーバー URL（Streamable HTTP、キー不要）：https://docs.blockvectra.com/mcp

クライアント	1 行でインストール	ソース
Claude Code	claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp	Claude Code の MCP
Claude Code プラグイン（MCP サーバー + blockvectra-rpc スキル）	/plugin marketplace add blockvectra/mcp、次に /plugin install blockvectra-docs@blockvectra	マーケットプレイスの作成、プラグインの依存関係
Cursor	Cursor に追加（ウェブリンク）、または cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra-docs&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9 を開きます	MCP インストールリンク、ウェブリンクの形式
VS Code	code --add-mcp '{"name":"blockvectra-docs","type":"http","url":"https://docs.blockvectra.com/mcp"}'	VS Code で MCP サーバーを使用する
VS Code（リンク）	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 開発者ガイド
Gemini CLI	gemini extensions install https://github.com/blockvectra/mcp --ref main	Gemini CLI 拡張機能
Antigravity	agy plugin install https://github.com/blockvectra/mcp	Antigravity プラグイン

Cursor の config 値は {"url":"https://docs.blockvectra.com/mcp"} の base64 です。VS Code のリンクは、サーバー設定 JSON を URL エンコードしたものです。

このプラグインは .claude-plugin/marketplace.json と .claude-plugin/plugin.json で定義されています。.mcp.json から blockvectra MCP サーバーをインストールし、依存関係として blockvectra/skills から blockvectra-rpc スキルをインストールします。

• エンドポイント： https://docs.blockvectra.com/mcp（Streamable HTTP、ステートレス）
• 認証： オプションの x-api-key ヘッダー（BlockVectra API キー）を使用できます。Authorization: Bearer <key> も受け付けます。キーがなくても、ドキュメント、チェーン、価格、ステータスのツールと、チェーンの公開エンドポイントで許可されている JSON-RPC メソッドを利用できます。
• API キーや秘密鍵をツールの引数やチャットに絶対に記載しないでください。サーバーは HTTP ヘッダーからのみキーを読み取ります。

チェーン、価格、上限は変更されるため、この README には記載していません。最新情報を直接確認してください。

• 対応チェーン：GET https://api.blockvectra.com/v1/chains
• プラン、価格、上限：GET https://console-api.blockvectra.com/v1/plans
• サービスのステータス：GET https://api.blockvectra.com/v1/status

詳細：エージェント向け BlockVectra および AI エージェントガイド。

goose：キー不要のドキュメント検索

設定済みのモデルプロバイダーで goose を使用します。ドキュメントツールを使うのに、BlockVectra のアカウントや API キーは必要ありません。

ドキュメント用レシピをダウンロードして実行します。リポジトリをチェックアウトする必要はなく、この JSON ファイルだけで利用できます。

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

このレシピは、Robinhood Chain のメインネット設定について search_docs に問い合わせ、その後、返されたドキュメントのうち 1 件を read_doc で読み込みます。レシピに記載されているツールはこの 2 つだけで、RPC、アカウント、トランザクションのツールは含まれていません。正常に結果が得られた場合は、ドキュメントを引用し、どの接続手順でキーが必要かを説明します。モデルの利用には、goose プロバイダーの通常の利用枠または料金が適用されます。

代わりに対話型セッションを使う場合は、そのセッション用にリモート拡張機能を追加します。

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

このセッションではすべてのツールカタログを検出します。レシピは、より小規模なドキュメント専用の開始点です。goose 拡張機能ガイドとレシピリファレンスを参照してください。

ポータブルな RPC ドキュメントエージェント

小規模なホスト型エージェントのデモには、ポータブルな指示と評価ケースを使用します。これらは、上記の 2 ツールを使うドキュメントタスクを再利用します。これはプロンプトとデモ概要であり、Lagrange マニフェストや検証済みのデプロイではありません。ホスト側のツールフィルタリングとモデル／ホスティング料金は別途発生します。

n8n：オフラインでの提案チェック

通常の n8n MCP クライアントワークフローでは、MCP ノードが実行される前に、提案された rpc_call をオフラインでチェックする方法をこのレシピで紹介しています。Code ノードを貼り付け、フィクスチャと照合します。信頼済み予算をゼロに設定すると、すべてのレシートは参考用の比較となり、ディスパッチは常に DENY になります。これは資金提供の承認や実行ではなく、実際の n8n インスタンスで実行されたものでもありません。設定と制限についてはガイドをお読みください。

Gemini CLI 拡張機能

この拡張機能は、リモート Streamable HTTP 経由で https://docs.blockvectra.com/mcp に直接接続します。ローカルの stdio ブリッジや npm は必要ありません。

インストール後、Gemini CLI を再起動し、/mcp を実行して利用可能なツールを確認します。list_chains を試してから、path=quickstart と lang=en を指定して read_doc を呼び出してください。

認証（任意）

この拡張機能はデフォルトでキー不要です。ドキュメント、検出、料金、ステータスの確認にキーは不要です。RPC は各チェーンの公開メソッドポリシーに従い、インデックスデータとアカウントツールには、ご自身の BlockVectra API キーが必要です。キーを argv、ツール引数、チャット、バージョン管理に含めたり、実際のキーをシェル履歴に残る形でエクスポートしたりしないでください。既存のプライベートなシークレットマネージャーまたはプライベートな起動環境を使用して、起動前に BLOCKVECTRA_API_KEY を Gemini のプロセス環境で利用可能にしてください。.gemini/.env ファイルだけでは不十分です。

キーをヘッダーとして送信するには、他の設定を置き換えずに、以下をユーザーの ~/.gemini/settings.json にマージします。

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

このユーザースコープのエントリーは、同じ名前の拡張機能サーバー設定を上書きします。設定後、Gemini CLI を再起動してください。gemini mcp list または /mcp で確認できるのは接続性だけで、アカウントやデータへのアクセスが正常に許可されたことではありません。認証を検証するには、読み取り専用の get_account ツールを意図的に呼び出し、返されたアカウントデータを非公開にしてください。

合成キーを使ったローカルモックに対して、公式 Gemini CLI 0.65.0 でテスト済みです。これはクライアント設定とヘッダー送信を検証するものであり、キーが必要なツールの実環境での動作を検証するものではありません。Gemini CLI の MCP カスタムヘッダーを参照してください。

Antigravity プラグイン

このプラグインは、リモート Streamable HTTP 経由で https://docs.blockvectra.com/mcp に直接接続します。ローカルの stdio ブリッジや npm は必要ありません。

現在のプロジェクトにインストールする

プロジェクトのルートから、次のコマンドを実行します。

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

そのディレクトリで agy を起動します。まず確認として、{"query":"Antigravity","lang":"en","limit":1} を指定して search_docs を呼び出すよう依頼します。プロジェクトローカルでの読み込みと、このキー不要のドキュメント検索は、Antigravity CLI 1.4.7 で検証済みです。

公式プラグインガイドでは、プロジェクトローカルおよびグローバルへのインストールについて説明しています。上記のコマンドにより、このプロジェクトの .agents/plugins/ ディレクトリにプラグインが配置されます。

インストール後

インストール後、Antigravity を再起動し、/mcp を実行して利用可能なツールを確認します。list_chains を試してから、path=quickstart と lang=en を指定して read_doc を呼び出します。

このプラグインはデフォルトでキー不要です。ドキュメント、検出、料金、ステータスはキー不要のままです。RPC は各チェーンの公開メソッドポリシーに従います。インデックスデータとアカウントツールには、ご自身の BlockVectra API キーが必要です。キーをツール引数、チャット、バージョン管理に含めないでください。キーを送信するには、Antigravity での MCPとクライアントのプライベートヘッダー設定に従い、クライアントでプライベートヘッダーとして設定します。

ツール

この表は、現在 https://docs.blockvectra.com/mcp で稼働しているサーバーを反映しています。正確な一覧を確認するには、tools/list を呼び出してください。

ツール	機能	API キー	読み取り／書き込み
read_doc	ドキュメントページの生の Markdown を読み取ります	不要	読み取り専用
search_docs	ドキュメントのタイトル、パス、概要をキーワード検索します	不要	読み取り専用
list_docs	すべてのドキュメントページを一覧表示します	不要	読み取り専用
list_chains	対応チェーン、静的パラメーター、メソッドポリシー（GET /v1/chains）	不要	読み取り専用
get_status	サービスとネットワークのライブステータス（GET /v1/status）	不要	読み取り専用
get_pricing	プラン、CU の重み、上限（GET /v1/plans）	不要	読み取り専用
estimate_usage	メソッドと1日あたりの呼び出し回数に基づいて CU と USD のコストを見積もります	不要	読み取り専用
get_method_info	JSON-RPC メソッドのチェーンごとの利用可否、CU の重み、価格	不要	読み取り専用
explain_error	エラーコードまたは理由を検索します。課金、再試行可能性、推奨される対応を確認できます	不要	読み取り専用
how_to_get_api_key	API キーの取得手順（プログラムによる SIWE サインアップまたはブラウザーへの引き継ぎ）と認証ヘッダー形式	不要	読み取り専用
rpc_call	チェーン上で読み取り専用の JSON-RPC 2.0 メソッドを実行します	任意：キーがない場合、利用可能であればチェーンのキー不要な公開エンドポイントのみを使用します	読み取り専用
data_api_get	チェーンとパスを指定して Data API にクエリを実行します	必須	読み取り専用
get_account	API キーの残高、CU、レート制限（GET /v1/account）	必須	読み取り専用
get_deposit_address	アカウントのオンチェーン入金アドレスと利用可能なネットワーク	必須	読み取り専用
send_raw_transaction	署名済みの生トランザクションをチェーン上にブロードキャストします	任意：キー不要でのアクセス可否は、チェーンの公開メソッドポリシーによります	書き込み（destructiveHint: true）

注：get_deposit_address とその他のキーが必要なツールをキーなしで呼び出すと、how_to_get_api_key を案内するエラーが返されます。

Cursor／Cline での使用

キー不要の Cursor 設定は .mcp.json にあり、Cursor プラグインマニフェストから参照されています。Cline の Streamable HTTP 設定とオプションの x-api-key ヘッダーについては、llms-install.md を参照してください。まずはヘッダーを設定せずに開始し、list_chains を呼び出してから、{"path":"quickstart","lang":"en"} を指定して read_doc を呼び出します。

クライアントを接続する

以下の各スニペットは、各クライアントのドキュメントに沿っています。カスタムヘッダーについて、そのドキュメントの説明に従って任意のキーを追加してください。

クライアント	公式ドキュメント
Claude Code	Claude Code での MCP
Cursor	Cursor の Model Context Protocol
VS Code	VS Code で MCP サーバーを使用する
Codex	Codex MCP

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）

既存のサーバーを保持したまま、このサーバーをプロジェクトの .cursor/mcp.json にマージしてください。

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

Cursor CLI の場合は、そのプロジェクトのディレクトリから以下のコマンドを実行して、接続を承認し、ツールの一覧を表示してください。

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

Cursor CLI の MCP コマンドを参照してください。

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

レジストリ

server.json は、公式 MCP レジストリに com.blockvectra/docs という名前で登録するために、このサーバーについて記述したファイルです。公開は手動のワークフロー（.github/workflows/publish.yml）です。

ライセンス

MIT