# NAVI Protocol MCP User Guide ### **Three Things You Need**
#WhatAnswer
1What 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.
2Is it safe?Yes. Read-only. It cannot sign transactions or move your funds.
3How do I start?Paste this URL into your AI's MCP / Connector settings and start chatting:
``` https://open-api.naviprotocol.io/api/mcp ``` That'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**](http://claude.ai)**)**
1. **Settings** → **Connectors** → **Add custom connector** 2. **Name:** NAVI Protocol · **URL:** · Advanced settings: leave blank 3. Click **Add** 4. In any chat, click **+** → **Connectors** → toggle **NAVI Protocol** on Requires Claude Pro / Max / Team / Enterprise. #### **ChatGPT** 1. **Settings** → **Apps & Connectors** → **Advanced settings** → enable **Developer Mode** 2. Back to Connectors → **Create** 3. **Name:** NAVI Protocol · **MCP Server URL:** · **Auth:** None 4. 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: ```json { "mcpServers": { "navi-protocol": { "url": "https://open-api.naviprotocol.io/api/mcp" } } } ``` Restart Cursor. Tools auto-discovered. #### **Claude Code** ```bash claude mcp add --transport http navi-protocol https://open-api.naviprotocol.io/api/mcp ``` #### **Gemini CLI** Add to `~/.gemini/settings.json:` ```json { "mcpServers": { "navi-protocol": { "url": "https://open-api.naviprotocol.io/api/mcp" } } } ``` #### **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-protocol` * **URL:** [`https://open-api.naviprotocol.io/api/mcp`](https://open-api.naviprotocol.io/api/mcp) * **Headers:** 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: ``. 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: `` > > 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. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://naviprotocol.gitbook.io/navi-protocol-developer-docs/navi-protocol-mcp-user-guide.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.