莫信解説｜UniSat MCP正式版がnpmで公開：設定をひとつ追加するだけで、AI Agentがビットコインのオンチェーンデータを検索可能に
本日11:49、UniSat（@unisat_wallet）がMCPサーバー @unisat/openapi-mcp をnpmに公開し、最初の正式版はそのまま1.0.0となりました。その1分前には、コマンドラインツール @unisat/openapi-cli も8月の0.1.0から1.0.0にバージョンアップしました。12:30時点で、UniSatの公式Xアカウントから告知はまだありません。
ここでは、Agentで何を検索できるのか、どう接続するのか、どの操作にあなたの承認が必要なのかを解説します。
🐋 MCPを1分で解説
- MCPは、AIアシスタントが外部ツールを呼び出すためのインターフェース規格です。Claude、Cursor、Codexはいずれも対応しています。MCPサーバーをひとつ導入すると、アシスタントが直接呼び出せるツールが増えます
- UniSatのサーバーはあなたのパソコン上で動作し、Agentに代わってUniSat Open APIを呼び出します。ビットコインのメインネットとFractalのメインネットの両方を検索できます
- あるアドレスのインスクリプションや、あるBRC-20の保有者を調べるには、これまでは自分でコードを書いてAPIを呼び出す必要がありました。接続すれば、Agentに中国語で直接質問するだけです
🐋 接続方法
ClaudeやCursorなどのクライアントのMCP設定に、次の内容を追加します：
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "あなたのkey" }
}
}
}
- keyはdeveloper.unisat.ioで申請します。Fractalを検索するには別途申請し、UNISAT_FRACTAL_API_KEYに設定してください
- パソコンにNode.jsが必要です。バージョンは22.23.4以上（または24、26の新しいバージョン）
- 公式が案内する最初のテストは、Agentにビットコインの最新ブロック高を調べさせること。アドレスもウォレットも不要です
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 Agentで検索できる情報
サーバーがAgentに提供するツールは4つだけです：
1. list_operations：キーワードでAPIを検索。ここではkeyは不要
2. get_operation：APIに必要なパラメーターや、読み取り専用かどうかを確認
3. call_api：実際にAPIを呼び出す
4. get_status：サービスや設定が正常かどうかを確認
Agentは自分で検索し、内容を確認してから、最後に呼び出します。別途skillをインストールする必要はありません。検索対象となるAPIは、UniSatが公開しているAPIドキュメント（v2.1.0、10/23更新）に基づいており、全308件、18カテゴリーに分かれています：
- ブロック、トランザクション、アドレス残高、UTXO
- インスクリプション、BRC-20（保有者、ミントの進捗、履歴）、ルーン、Alkanes
- BRC-20 swap、インスクリプションのコレクション、BRC-20、ルーン、Alkanes、ドメインの各マーケットにおける出品と取引
- BTC、FB、CAT20の価格、Fractalの流通量と保有者ランキング
たとえば「このアドレスにはどんなBRC-20がある？」「あるルーンの上位20人の保有者は誰？」と尋ねれば、対応するAPIを利用できます。
🐋 どの操作にあなたの承認が必要？
- 308件のAPIのうち195件は読み取り専用で、113件は状態を変更します：トランザクションのブロードキャスト、インスクリプションの作成、マーケットへの出品や購入、swapなど
- この113件は、Agentが確認パラメーターを付けずに呼び出すと「ユーザーの承認が必要」として拒否されます。ツールの説明には、ユーザーがその操作を明確に承認した場合に限り、Agentが確認パラメーターを付けられると明記されています
- パッケージは秘密鍵を扱いません。出品や購入などのAPIが返すのは署名前のトランザクションで、ウォレットで署名してから送信する必要があります
- 読み取り専用の検索にもkeyが必要で、利用枠はkeyごとに計算されます。call_apiで現在のkeyの残り利用枠も確認できます
🐋 今回の公開まで
- 8/18：CLI 0.1.0がnpmに公開
- 10/23：開発ドキュメントに「OpenAPI CLI & MCP」のページが追加され、npxの設定方法が記載されました。この時点ではnpmでパッケージを検索しても見つかりませんでした。同日、コードリポジトリに「v0.1.5リリース準備」というコミットがプッシュされました
- 10/30 11:47にテスト版を公開。11:48にCLI 1.0.0、11:49にMCP 1.0.0を公開し、0.1.5を飛ばしました
——
本記事はXの@musinootで初公開
本日11:49、UniSat（@unisat_wallet）がMCPサーバー @unisat/openapi-mcp をnpmに公開し、最初の正式版はそのまま1.0.0となりました。その1分前には、コマンドラインツール @unisat/openapi-cli も8月の0.1.0から1.0.0にバージョンアップしました。12:30時点で、UniSatの公式Xアカウントから告知はまだありません。
ここでは、Agentで何を検索できるのか、どう接続するのか、どの操作にあなたの承認が必要なのかを解説します。
🐋 MCPを1分で解説
- MCPは、AIアシスタントが外部ツールを呼び出すためのインターフェース規格です。Claude、Cursor、Codexはいずれも対応しています。MCPサーバーをひとつ導入すると、アシスタントが直接呼び出せるツールが増えます
- UniSatのサーバーはあなたのパソコン上で動作し、Agentに代わってUniSat Open APIを呼び出します。ビットコインのメインネットとFractalのメインネットの両方を検索できます
- あるアドレスのインスクリプションや、あるBRC-20の保有者を調べるには、これまでは自分でコードを書いてAPIを呼び出す必要がありました。接続すれば、Agentに中国語で直接質問するだけです
🐋 接続方法
ClaudeやCursorなどのクライアントのMCP設定に、次の内容を追加します：
{
"mcpServers": {
"unisat-ai-kit": {
"command": "npx",
"args": ["-y", "@unisat/openapi-mcp"],
"env": { "UNISAT_BITCOIN_API_KEY": "あなたのkey" }
}
}
}
- keyはdeveloper.unisat.ioで申請します。Fractalを検索するには別途申請し、UNISAT_FRACTAL_API_KEYに設定してください
- パソコンにNode.jsが必要です。バージョンは22.23.4以上（または24、26の新しいバージョン）
- 公式が案内する最初のテストは、Agentにビットコインの最新ブロック高を調べさせること。アドレスもウォレットも不要です
https://www.npmjs.com/package/@unisat/openapi-mcp
🐋 Agentで検索できる情報
サーバーがAgentに提供するツールは4つだけです：
1. list_operations：キーワードでAPIを検索。ここではkeyは不要
2. get_operation：APIに必要なパラメーターや、読み取り専用かどうかを確認
3. call_api：実際にAPIを呼び出す
4. get_status：サービスや設定が正常かどうかを確認
Agentは自分で検索し、内容を確認してから、最後に呼び出します。別途skillをインストールする必要はありません。検索対象となるAPIは、UniSatが公開しているAPIドキュメント（v2.1.0、10/23更新）に基づいており、全308件、18カテゴリーに分かれています：
- ブロック、トランザクション、アドレス残高、UTXO
- インスクリプション、BRC-20（保有者、ミントの進捗、履歴）、ルーン、Alkanes
- BRC-20 swap、インスクリプションのコレクション、BRC-20、ルーン、Alkanes、ドメインの各マーケットにおける出品と取引
- BTC、FB、CAT20の価格、Fractalの流通量と保有者ランキング
たとえば「このアドレスにはどんなBRC-20がある？」「あるルーンの上位20人の保有者は誰？」と尋ねれば、対応するAPIを利用できます。
🐋 どの操作にあなたの承認が必要？
- 308件のAPIのうち195件は読み取り専用で、113件は状態を変更します：トランザクションのブロードキャスト、インスクリプションの作成、マーケットへの出品や購入、swapなど
- この113件は、Agentが確認パラメーターを付けずに呼び出すと「ユーザーの承認が必要」として拒否されます。ツールの説明には、ユーザーがその操作を明確に承認した場合に限り、Agentが確認パラメーターを付けられると明記されています
- パッケージは秘密鍵を扱いません。出品や購入などのAPIが返すのは署名前のトランザクションで、ウォレットで署名してから送信する必要があります
- 読み取り専用の検索にもkeyが必要で、利用枠はkeyごとに計算されます。call_apiで現在のkeyの残り利用枠も確認できます
🐋 今回の公開まで
- 8/18：CLI 0.1.0がnpmに公開
- 10/23：開発ドキュメントに「OpenAPI CLI & MCP」のページが追加され、npxの設定方法が記載されました。この時点ではnpmでパッケージを検索しても見つかりませんでした。同日、コードリポジトリに「v0.1.5リリース準備」というコミットがプッシュされました
- 10/30 11:47にテスト版を公開。11:48にCLI 1.0.0、11:49にMCP 1.0.0を公開し、0.1.5を飛ばしました
——
本記事はXの@musinootで初公開
