🧠NAVI Protocol MCP User Guide
Talk to NAVI with AI. Ask questions in plain English — get real on-chain answers. No API key. No code. Free.
Three Things You Need
#
What
Answer
1
What is it?
A free plug-in that lets any AI (ChatGPT, Claude, Gemini…) read live NAVI data — lending rates, wallet positions, swap quotes, and more.
2
Is it safe?
Yes. Read-only. It cannot sign transactions or move your funds.
3
How do I start?
Paste this URL into your AI's MCP / Connector settings and start chatting:
https://open-api.naviprotocol.io/api/mcpThat's it. The rest of this page explains what MCP is, how to set it up on each platform, and what you can do with it.
What Is MCP?
MCP (Model Context Protocol) is an open standard created by Anthropic. Think of it as "USB-C for AI":
USB-C unified charging ports across devices.
MCP unifies how AI connects to external tools and data.
Before MCP, every AI ↔ service integration needed custom code. With MCP, one URL works across ChatGPT, Claude, Gemini, Cursor, and any other MCP-compatible client.
NAVI Protocol MCP is NAVI's implementation of this standard. It consolidates fragmented DeFi data — lending, swaps, bridging, DCA, wallet assets, Sui transaction history — into a unified toolset any AI can call directly. Users ask questions in natural language; the AI fetches on-chain data and returns answers tailored to real-world decisions.
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
NAVI MCP is a remote service. Your AI client connects to it over the internet — nothing to install locally.
Pick your platform below.
🟢 AI Chat (No Coding Required)
Claude (claude.ai)
Settings → Connectors → Add custom connector
Name: NAVI Protocol · URL: https://open-api.naviprotocol.io/api/mcp · Advanced settings: leave blank
Click Add
In any chat, click + → Connectors → toggle NAVI Protocol on
Requires Claude Pro / Max / Team / Enterprise.
ChatGPT
Settings → Apps & Connectors → Advanced settings → enable Developer Mode
Back to Connectors → Create
Name: NAVI Protocol · MCP Server URL: https://open-api.naviprotocol.io/api/mcp · Auth: None
In a new chat: + → More → Developer Mode → check the NAVI connector
Requires ChatGPT Plus / Pro / Team / Enterprise.
Google Gemini (Web)
Not yet supported for custom remote MCP. Use Gemini CLI (below) or the Google Gen AI SDK instead.
🔵 AI IDEs (For Developers)
Cursor
Create .cursor/mcp.json in your project root:
Restart Cursor. Tools auto-discovered.
Claude Code
Gemini CLI
Add to ~/.gemini/settings.json:
VS Code / Windsurf / Other IDEs
Same pattern — add server name + URL in your IDE's MCP settings. See each IDE's docs for specifics.
🟡 Generic / Custom Agents
Any client that supports Add MCP Server or Remote MCP:
Server Name:
navi-protocolHeaders: Leave blank
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:
Summarize my current asset holdings.
Summarize my positions in NAVI and other protocols.
Alert me if my health factor indicates any risk.
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
2. List Tools
Bash
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.
Last updated