# 開発者と AI エージェント向けのブロックチェーン RPC とドキュメント MCP

> https://blockvectra.com/ja/agents/

開発者と AI Agent はキーなしでドキュメントを探索し、HTTP 経由で認証情報を作成して、認証付きで対応する RPC や Data API エンドポイントを呼び出すことができます。

キー不要の公開エンドポイント：API キーなしで https://api.blockvectra.com/v1/<chain>/public にアクセスして対応チェーンを呼び出せます。<chain> は eth_mainnet などのチェーン名に置き換えてください。IP ごとの制限と対応チェーン一覧は GET /v1/chains から取得できます。

## クイック回答

- キー不要：POST https://api.blockvectra.com/v1/<chain>/public は、アカウントも API キーもなしで 29 チェーンで利用でき、IP ごとに毎秒 3 リクエスト（バースト 20、バッチは最大 10 件）です。 ([出典：GET /v1/chains](https://api.blockvectra.com/v1/chains))
- ウォレットでの登録は四つの HTTP 呼び出しで完了します。チャレンジを要求し、Ethereum ウォレットで署名（EIP-191）し、ログイン（初回ログインでアカウントが作成されます）してから、POST /keys で API キーを作成します。 ([出典：プログラムによる登録ガイド](https://docs.blockvectra.com/ja/guides/programmatic-signup/))
- コマンド一つでドキュメント MCP サーバーを追加できます（キー不要）：claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp ([出典：AI エージェントガイド](https://docs.blockvectra.com/ja/guides/ai-agents/))
- 登録すると 30,000,000 CU を無料で受け取れます（カード不要）。無料プランは 30 日サイクルで、すべてのキーで共有する毎秒 25 コールです。eth_call は 15 CU（1,000,000 リクエストあたり $1.50）です。 ([出典：GET /v1/plans](https://console-api.blockvectra.com/v1/plans))
- 人間と同じルール：キーの作成と失効、残高の確認、オンチェーンでのチャージはすべて HTTP 呼び出しで行え、コンソール専用ではありません。MCP サーバーはキーの作成も失効も行いません。 ([出典：プログラムによる登録ガイド](https://docs.blockvectra.com/ja/guides/programmatic-signup/))

## どれを使えばよいですか？

| やりたいこと | 使うもの | 最初のステップ |
| --- | --- | --- |
| アカウントなしで今すぐチェーンデータを読む | キー不要の公開エンドポイント | eth_chainId の JSON-RPC ボディで https://api.blockvectra.com/v1/<chain>/public に POST します。利用できるメソッドは [GET /v1/chains](https://api.blockvectra.com/v1/chains) にあります。 |
| AI アシスタントにドキュメント、チェーン、稼働状況、料金を読ませ、読み取り専用の RPC を呼び出させる | ドキュメント MCP サーバー | 下の MCP セクションにあるワンライナーのコマンドを実行します。[AI エージェントガイド](https://docs.blockvectra.com/ja/guides/ai-agents/)を参照してください。 |
| 公開リスト外のメソッド、Data API、またはキー固有の上限を使う | HTTP での登録と API キー | POST /auth/siwe/challenge、署名、ログインの後、POST /keys。手順は[プログラムによる登録ガイド](https://docs.blockvectra.com/ja/guides/programmatic-signup/)にあります。 |
| ポーリングせず、アドレスにアクティビティがあったときに通知を受け取る | Webhook によるアドレスプッシュ | [Webhook プッシュガイド](https://docs.blockvectra.com/ja/guides/webhook-push/)で、最大 1,000,000 アドレスの購読を作成します。 |

## キー不要のドキュメント MCP

ドキュメント MCP サーバーは API キー不要で、ドキュメント、チェーン、リアルタイムの稼働状況、料金、利用量見積もりに関する質問に回答します。

### ドキュメント専用 MCP

search_docs · read_doc

```bash
claude mcp add --transport http blockvectra-docs-only https://docs.blockvectra.com/mcp/docs
```

[ドキュメント専用 MCP →](https://docs.blockvectra.com/en/guides/mcp-server/#docs-only-remote-http)

コマンド一つ、API キー不要：

```bash
claude mcp add --transport http blockvectra-docs https://docs.blockvectra.com/mcp
```

その他のクライアント：

- [Cursor にインストール](cursor://anysphere.cursor-deeplink/mcp/install?name=blockvectra&config=eyJ1cmwiOiJodHRwczovL2RvY3MuYmxvY2t2ZWN0cmEuY29tL21jcCJ9)
- [Cline を設定](https://docs.cline.bot/mcp/mcp-overview#manual-config)

Cline で MCP Servers → Configure → Configure MCP Servers を開き、API キー不要の次の設定を追加してください：

```json
{
  "mcpServers": {
    "blockvectra": {
      "type": "streamableHttp",
      "url": "https://docs.blockvectra.com/mcp"
    }
  }
}
```

[ドキュメントの AI エージェントガイドを見る →](https://docs.blockvectra.com/ja/guides/ai-agents/)

キーなしで公開 RPC 呼び出しを試す

```
対応するチェーンを一覧表示し、公開メソッドで eth_chainId を許可するチェーンを選んでください。そのチェーンとメソッドに get_method_info を使い、API キーなしで rpc_call により eth_chainId を呼び出してください。返されたチェーン ID を、選択したチェーンの公開 chain_id と数値で比較し、結果と適用される公開アクセスの制限を報告してください。ID がない、無効、または一致しない場合は、成功を主張せずに停止して報告してください。
```

キーが必要なメソッドや Data API を使う場合は、[HTTP で登録してキーを作成](https://docs.blockvectra.com/ja/guides/programmatic-signup/)し、[Data API ガイド](https://docs.blockvectra.com/ja/api/data/)に従ってください。残高を追加するには[オンチェーンでチャージ](https://docs.blockvectra.com/ja/guides/agent-topup/)できます。

## 連携ガイド

- [MCP サーバー](https://docs.blockvectra.com/ja/guides/mcp-server/) ツール一覧、キーの要件、クライアントの設定。
- [LangChain](https://docs.blockvectra.com/ja/guides/langchain/) LangChain エージェントに RPC ツールまたは MCP サーバーを渡します。
- [ElizaOS](https://docs.blockvectra.com/ja/guides/elizaos/) EVM プラグインを BlockVectra のエンドポイントに向けます。
- [Coinbase AgentKit](https://docs.blockvectra.com/ja/guides/coinbase-agentkit/) AgentKit で BlockVectra の RPC URL を使います。
- [株式トークンのアクティビティ](https://docs.blockvectra.com/ja/guides/stocks/) Data API から株式トークンの日次転送アクティビティを読み取ります。

## 人間と同じ権利

HTTP 経由で、エージェントはキーの作成（POST /keys）、失効（POST /keys/{key_id}/revoke）、残高の確認（GET /v1/account）、オンチェーンでのチャージができ、コンソールを使う人と同じ上限と料金が適用されます。

MCP サーバーは、ドキュメント、チェーン、稼働状況、料金の読み取り、読み取り専用 RPC の呼び出し（rpc_call）、署名済みトランザクションのブロードキャスト（send_raw_transaction）を行え、クライアントにキーを設定すればアカウント残高と入金アドレスも読み取れます。キーを作成・失効するツールはないため、その操作は HTTP を使ってください。

## エージェントが読み取れる料金体系

GET /v1/plans は各メソッドの CU 重み付けを JSON で返すため、初回コールの前にコストを見積もることができます。

- [GET /v1/plans を開く →](https://console-api.blockvectra.com/v1/plans)
- [USDC / USDT / USDG での支払い →](https://blockvectra.com/ja/pricing/#pay-with-usdt)

### 無料プラン

30,000,000 CU の無料クレジットが含まれます。30 日間のサイクルは最初の課金対象コールから始まり、各サイクルの終了時に 30,000,000 CU まで自動補充されます（累積なし）。すべてのキーで平均毎秒 25 コールを共有し、短時間のバーストが許可されます。各キーのデフォルト制限 100 CU/s（バースト 400 CU）は引き続き適用されます。

約 2,000,000 回の eth_call

クレジットカード不要 — GitHub、Google、またはウォレットですぐに登録できます。

[無料プランと料金体系を見る →](https://blockvectra.com/ja/pricing/#free)

## 機械可読なエントリポイント

アカウントなしで利用可能な機械可読ファイルとカタログ：

- [公式サイト llms.txt](https://blockvectra.com/llms.txt)
- [ドキュメントサイト llms.txt](https://docs.blockvectra.com/llms.txt)
- [全ドキュメントページの Markdown 版](https://docs.blockvectra.com/md/ja/quickstart.md)
- [OpenAPI 3.1 — JSON-RPC](https://docs.blockvectra.com/openapi/json-rpc.yaml)
- [OpenAPI 3.1 — Data API](https://docs.blockvectra.com/openapi/data.yaml)
- [RFC 9727 API カタログ](https://blockvectra.com/.well-known/api-catalog)
- [エラーリファレンス](https://docs.blockvectra.com/ja/errors/)

## コピーして使えるサンプルコード

```bash
export BLOCKVECTRA_API_KEY=rgw_your_api_key

curl -X POST https://api.blockvectra.com/v1/robinhood_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'
```

## まだ API キーをお持ちではありませんか？

Ethereum ウォレットをお持ちの場合：ブラウザを使わずにプログラムによる登録ガイドに従って登録し、キーを作成してください。ウォレットをお持ちでない場合：ユーザーに https://console.blockvectra.com でログインしてキーを作成し、環境変数 BLOCKVECTRA_API_KEY として設定するよう依頼してください。チャットにキーを貼り付けるようユーザーに求めないでください。

- [プログラムによる登録ガイドを見る →](https://docs.blockvectra.com/ja/guides/programmatic-signup/)
- [コンソールにログイン](https://console.blockvectra.com/login/?next=%2Fkeys%2F)

## よくある質問

### 登録なしでブロックチェーン RPC を呼び出せますか？

はい。POST https://api.blockvectra.com/v1/<chain>/public は、アカウントも API キーもなしで 29 チェーンで利用できます。各チェーンで許可されるメソッドと IP ごとの上限は [GET /v1/chains](https://api.blockvectra.com/v1/chains) にあります。このリスト外のメソッドと Data API には API キーが必要です。

### MCP サーバーはトランザクションを送信できますか？

ブロードキャストはできますが、署名はできません。MCP サーバーは秘密鍵を保持しません。send_raw_transaction は、別の場所で署名したトランザクションを、公開メソッドに eth_sendRawTransaction を含むチェーンではキー不要のエンドポイント経由で、またはお持ちの API キーで送信します。キーを作成・失効するツールはありません。

[AI エージェントガイドで MCP ツールを見る →](https://docs.blockvectra.com/ja/guides/ai-agents/)

### 始める前に支払いが必要ですか？

いいえ。初回のウォレットログインで、カードも入金も不要の無料クレジット 30,000,000 CU が付与され、キー不要のエンドポイントはアカウントすら必要ありません。eth_call は 15 CU（1,000,000 リクエストあたり $1.50）で、すべての料金は [GET /v1/plans](https://console-api.blockvectra.com/v1/plans) にあります。もっと必要なときは[オンチェーンでチャージ](https://docs.blockvectra.com/ja/guides/agent-topup/)できます。

### AI エージェントはブラウザなしで API キーをどう取得しますか？

四つの HTTP 呼び出しで取得できます。POST /auth/siwe/challenge、返されたメッセージへの Ethereum ウォレットでの署名（EIP-191）、POST /auth/siwe/login（初回ログインでアカウントが作成されます）、そして POST /keys です。キーは一度しか返されないので、BLOCKVECTRA_API_KEY に保存してください。

[プログラムによる登録ガイドに従う →](https://docs.blockvectra.com/ja/guides/programmatic-signup/)

### AI エージェントは BlockVectra を直接利用できますか？

はい、利用できます。エージェントは人間と同じ公開 JSON-RPC および Data API を、同じドキュメントと同じ料金体系で利用します。ドキュメント MCP サーバーと機械可読ファイルにはキーが不要です。

[接続方法を見る →](https://docs.blockvectra.com/ja/guides/ai-agents/)
