NAVI Protocol MCP

NAVI Protocol MCP ユーザーガイド

AIクライアント向けのパブリックDeFiデータおよび説明インターフェース。APIキー不要で、すぐに使用可能。ユーザーからの問い合わせ、コンテンツリサーチ、技術統合に適しています。

一言で

NAVI Protocol MCPは、オープンなModel Context Protocolサービスです。レンディング、スワップ、ブリッジ、DCA、Volo Vaultのイールドボールト、ウォレット資産、Suiトランザクションの解釈など、NAVI Protocolエコシステム全体に散在する機能を、AIクライアントが直接呼び出せる標準化されたツールセットにまとめます。

その本質的な価値は「単なるもう一つのAPI」ではありません。通常、プロトコルページ、ブロックエクスプローラー、複数の製品ページを行き来しなければならない情報を、AIが理解し、組み合わせ、説明できる構造化されたコンテキストに変換します。ユーザーは自然言語で質問するだけで、AIがNAVI Protocol MCPを呼び出し、実際の意思決定ニーズにより近い回答を生成できます。

対象ユーザー

• 複数のページを手動で確認することなく、NAVI Protocolエコシステムを素早く理解したい一般ユーザー
• 資産、ポジション、トランザクション、リスクの解釈をAIに支援させたい、Suiで既にアクティブなオンチェーンユーザー
• パブリックで無料、認証不要のDeFi MCPサービスを求める開発者、研究者、チーム
• データ取得と結果の解釈をAIに任せ、分析と意思決定に集中したいコンテンツクリエイターやアナリスト

主要アクセス情報

項目	詳細
エンドポイント	https://open-api.naviprotocol.io/api/mcp
認証	APIキー不要
コスト	無料
推奨トランスポート	Streamable HTTP
機能範囲	読み取り専用のクエリと解釈。署名、認可、トランザクション実行は処理しません

3分で始める

オプションA: リモートMCPをサポートするクライアントに直接追加する

お使いのクライアントが Add MCP Server、Remote MCP、HTTP MCP のようなエントリを提供している場合、必要なのは以下の情報だけです。

• サーバー名: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• ヘッダー: 空のまま

保存して再接続すれば、特定のツール名を覚えることなく、チャットで直接質問できます。

オプションB: Cursorでの例

Cursorを使用している場合、MCP設定にリモートサーバーを追加します。

{
  "mcpServers": {
    "navi-protocol": {
      "url": "https://open-api.naviprotocol.io/api/mcp"
    }
  }
}

設定後、MCPリストを更新するかクライアントを再起動し、チャットボックスで直接質問してください。

オプションC: Claude Codeでの例

Claude Codeを使用している場合、コマンドラインからHTTP MCPサービスを追加できます。

claude mcp add --transport http navi-protocol https://open-api.naviprotocol.io/api/mcp

オプションD: Codexでの例

OpenAI Codexを使用している場合、グローバルまたはプロジェクトレベルの config.toml（例: ~/.codex/config.toml または .codex/config.toml）にMCPサーバーを追加します。

[mcp_servers.navi-protocol]
url = "https://open-api.naviprotocol.io/api/mcp"

CLIから素早く追加することも可能です。

codex mcp add navi-protocol --url https://open-api.naviprotocol.io/api/mcp

セットアップ後、以下の2つのプロンプトで接続を素早く確認できます。

• Please explain in plain language what capabilities NAVI Protocol mainly supports right now.
• Please list NAVI's major lending pools.

より良い質問の仕方

一般ユーザーは手動でツールを呼び出す必要はありません。目標、対象オブジェクト、希望する出力形式をAIに直接伝えるのが最善の方法です。

推奨プロンプトスタイル

• Please introduce NAVI Protocol's current overall status in non-technical language.
• I want to see the key parameters of the SUI lending pool. Please explain them to me.
• If I swap 1 SUI to USDC, roughly how much would I get? Quote only, do not execute any transaction.
• Help me check DEEP's contract address, decimals, and current price.
• Which chains are currently supported by NAVI Astros Bridge? Can USDC on Sui be bridged?
• Help me explain what happened in this Sui transaction: 2aWS5J9i4SxW3DVfKheR9Sdx6iMKPW6vfka56v5tuTSw
• What Volo Vault yield vaults are available right now? Which one has the highest APY?
• This is my Sui address: <YOUR_SUI_ADDRESS>. Please summarize my assets, positions, and risks.

より高品質なプロンプトのための習慣

• 「平易な言葉で説明して」や「調査レポート形式で要約して」など、出力スタイルを指定する
• 「引用のみ、取引は実行しないで」や「Suiメインネットのみ」など、制約を指定する
• 「リスクを最初に重視して」「請求可能な報酬を最初に重視して」「ブリッジの到達可能性を最初に重視して」など、優先順位を指定する

現在利用可能なパブリック機能

以下の表は、NAVI Protocol MCPが現在公開している主な機能と、ユーザーが直接尋ねることができる自然言語プロンプトの例をまとめたものです。

ユースケース	代表的なツール	推奨プロンプト
プロトコル概要	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
レンディングプール分析	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
リスクチェック	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
報酬情報	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
ウォレットとポジション	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
市場設定	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
トークン情報	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
スワップ見積もり	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
ブリッジ検出	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
ブリッジ追跡	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
DCAクエリ	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
Volo Vault概要	volo_get_vaults, volo_get_vault, volo_get_vault_system_summary	What Volo Vault yield vaults are available? What is the overall TVL and revenue?
Volo Vault分析	volo_get_vault_apy_history, volo_get_vault_share_price_history, volo_get_vault_tvl_history, volo_get_vault_total_tvl_history	How has this Volo Vault's APY trended over the past month?
Volo Vaultユーザーポジション	volo_get_vault_user_positions, volo_get_vault_user_status, volo_get_vault_user_transactions	How much has this address staked in Volo Vault? What are the earnings?
トランザクション説明	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

アドレスベースの質問に推奨するテンプレート

Suiアドレスを提供する場合、AIは資産、ポジション、リスク、報酬をさらに要約できます。以下はコピーして直接使用できるテンプレートです。

This is my Sui address: <YOUR_SUI_ADDRESS>.
Please help me with the following 5 things:
1. Summarize what assets I currently hold;
2. Summarize my positions in NAVI and other protocols;
3. If my health factor has risk, warn me directly;
4. Tell me whether I have any unclaimed rewards;
5. Summarize my Volo Vault positions and earnings.

これらのリクエストは通常、以下の機能を組み合わせます。

• navi_get_coins
• get_positions
• navi_get_health_factor
• navi_get_available_rewards
• volo_get_vault_user_positions
• volo_get_vault_user_status

アドレスベースのクエリが上流のレート制限やタイムアウトに時々影響を受ける場合、通常は後で再試行すれば機能します。

テクニカルユーザー向けの直接テスト

最初にターミナルでサービスの可用性を確認したい場合は、MCPリクエストを直接送信できます。以下の初期化例では、プロトコルバージョン 2025-06-18 を使用しており、このガイドで検証済みです。クライアントがプロトコルバージョンを自動ネゴシエーションする場合、手動での指定は不要です。

1. 初期化

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-06-18",
      "capabilities": {},
      "clientInfo": {
        "name": "demo-client",
        "version": "1.0.0"
      }
    }
  }'

2. ツール一覧

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/list",
    "params": {}
  }'

3. ツールを直接呼び出す

curl https://open-api.naviprotocol.io/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data-binary '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "navi_get_protocol_stats",
      "arguments": {}
    }
  }'

使用上のヒント

• DeFiが初めての場合は、生のJSONを直接出力するのではなく、結果を平易な言葉で説明するようAIに依頼してください。
• 資産やプールがより深く調査する価値があるか評価したい場合は、まずプロトコル概要 -> プールパラメータ -> 見積もり -> リスクの順で進めてください。
• トークンのコントラクトアドレスや小数点以下の桁数が不明な場合は、シンボルで直接検索してください（例: Help me check DEEP token info）。
• 自身のアドレスを提供する予定がある場合は、資産、ポジション、リスクをまとめて要約するようAIに依頼すると、より充実した効率的な結果が得られます。
• 最初に接続のみをテストしたい場合は、プロトコル概要、SUIプールパラメータ、公開トランザクションの説明など、ウォレットアドレスに依存しないプロンプトから始めてください。

一般的な制限と注意事項

• NAVI Protocol MCPは現在、読み取り専用のクエリおよび解釈レイヤーとして機能します。署名、認可、直接的な取引実行は処理しません。
• AIクライアントがリモートMCP、Streamable HTTP、または自動プロトコルネゴシエーションをサポートするかどうかは、クライアント自身の実装に依存します。
• アドレスベースのクエリ、ブリッジ履歴、または一部の集約機能は、上流サービスの状態、レート制限、タイムアウトの影響を受ける可能性があります。
• 生データではなく解釈が必要な場合は、プロンプトで要約、比較、またはリスクの強調をAIに明示的に依頼してください。

これがユーザーエクスペリエンスにとって重要な理由

NAVI Protocol MCPの価値は、複数のオンチェーン機能をAIが直接呼び出せる単一のアクセスレイヤーに統合し、ユーザーの認知的負荷を大幅に軽減することにあります。

従来の利用フローは多くの場合、次のようなものでした。

• プロトコルページで数値を確認する
• ブロックエクスプローラーでトランザクションを追跡する
• 他のページを開いてスワップルートやブリッジサポートを確認する
• 手動でコンテキストをつなぎ合わせて判断する

NAVI Protocol MCPを使用すると、AIはまず構造化データを取得し、それをあなたの質問と組み合わせて、実際の意思決定シナリオにより近い回答を生成できます。ユーザーにとって本当に重要なのは、フィールドそのものではなく、「このデータを今どのように解釈すべきか」です。これはまさに、MCPが製品体験レベルで最大の価値を提供するポイントです。