NAVI Protocol MCP User Guide

An Open DeFi Data & Interpretation Interface for AI Clients. > No API Key required. Out-of-the-box access for user queries, content research, and technical integration.

Understanding in One Sentence

The NAVI Protocol MCP (Model Context Protocol) is a standardized interface that consolidates fragmented data—including lending, swaps, bridging, DCA, wallet assets, and Sui transaction explanations—into a unified toolset that AI clients can call directly.

Its core value isn't just "another API"; it transforms raw data from protocol pages and block explorers into a structured context that AI can understand, combine, and explain. Users can ask questions in natural language, and the AI uses this MCP to provide answers tailored to real-world decision-making.

---

Targeted Audience

• General Users: Those who want to understand the NAVI ecosystem quickly without manual searching across multiple pages.

• On-chain Users: Active Sui ecosystem participants who want AI to explain their assets, positions, transactions, and risks.

• Developers & Researchers: Teams looking to integrate an open, free, and permissionless DeFi MCP service.

• Content Creators & Analysts: Those who want to delegate "data fetching" to AI so they can focus on analysis and strategy.

---

Core Connection Info

Item	Description
Service URL	https://open-api.naviprotocol.io/api/mcp
Authentication	None (No API Key required)
Cost	Free
Transport Type	Streamable HTTP
Capability Boundary	Read-only queries and explanations; cannot sign, authorize, or execute transactions.

---

Get Started in 3 Minutes

Option A: Direct Integration (Remote MCP)

If your client (e.g., a specialized AI dashboard) supports Add MCP Server or Remote MCP, use these details:

• Server Name: navi-protocol

• URL: https://open-api.naviprotocol.io/api/mcp

• Headers: Leave blank

Option B: Using Cursor

If you use the Cursor code editor, add it to your MCP configuration:

JSON

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

Option C: Using Claude Code

For Claude Code users, add the service via the command line:

Bash

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

---

Recommended Prompts

You don't need to manually trigger specific tools. Simply tell the AI your goal, the object of interest, and your preferred output format.

Examples

• "Introduce the current status of NAVI Protocol using non-technical language."

• "I want to see the core parameters of the SUI lending pool; please explain them to me."

• "What is the quote for swapping 1 SUI to USDC? (Quote only, do not execute)."

• "Find the contract address, decimals, and current price for DEEP."

• "Explain what happened in this Sui transaction: 2aWS5J9i4SxW3DVfKheR9Sdx6iMKPW6vfka56v5tuTSw."

• "This is my Sui address: <YOUR_SUI_ADDRESS>. Please summarize my assets, positions, and risks."

Tips for High-Quality Results

• Specify Style: e.g., "Explain in layman's terms" or "Summarize as a research report."

• Specify Constraints: e.g., "Only show Sui Mainnet data" or "Focus on risks first."

---

Available Capabilities

Use Case	Core Tools	Example Prompt
Protocol Overview	navi_get_protocol_stats	"What is the total scale of NAVI Protocol right now?"
Lending Analysis	navi_get_pools, navi_get_pool	"What are the supply/borrow rates and LTV for the SUI pool?"
Risk Assessment	navi_get_health_factor	"Is the health factor for this address safe?"
Rewards	navi_get_available_rewards	"What unclaimed lending rewards does this address have?"
Wallet & Positions	navi_get_coins, get_positions	"Summarize the assets and DeFi positions for this address."
Market Config	navi_get_market_config	"Which assets does NAVI Main Market currently support?"
Token Info	navi_search_tokens	"Search for DEEP token details and price."
Swap Quotes	navi_get_swap_quote	"If I swap 1 SUI for USDC, how much will I get?"
Bridging	navi_get_bridge_chains, etc.	"Which chains are supported for bridging USDC from Sui?"
DCA Orders	navi_list_dca_orders	"List the DCA orders for this address."
TX Explanation	sui_explain_transaction	"Translate this transaction into human-readable language."

---

Template for Address-Based Queries

If you provide your Sui address, the AI can aggregate your data. Copy and paste this template:

Address: <YOUR_SUI_ADDRESS>

Please complete these 4 tasks:

1. Summarize my current asset holdings.

2. Summarize my positions in NAVI and other protocols.

3. Alert me if my health factor indicates any risk.

4. Tell me if I have any unclaimed rewards.

---

Technical Testing (via cURL)

To verify the service via terminal, use the protocol version 2025-06-18.

1. Initialize

Bash

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

2. List Tools

Bash

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

---

Important Considerations

• Read-Only: The MCP does not handle signatures or private keys. It cannot move your funds.

• Client Support: Performance depends on your AI client's implementation of Remote MCP and HTTP streaming.

• Upstream Limits: Address queries or cross-chain status may be subject to rate limits from upstream providers.

• Intent: If you want a summary rather than raw JSON, explicitly ask the AI to "summarize" or "interpret" the data.