# NAVI Protocol MCP User Guide

### **Three Things You Need**

<table data-header-hidden><thead><tr><th width="98"></th><th width="206"></th><th></th></tr></thead><tbody><tr><td><strong>#</strong></td><td><strong>What</strong></td><td><strong>Answer</strong></td></tr><tr><td>1</td><td><strong>What is it?</strong></td><td>A free plug-in that lets any AI (ChatGPT, Claude, Gemini…) read live NAVI data — lending rates, wallet positions, swap quotes, and more.</td></tr><tr><td>2</td><td><strong>Is it safe?</strong></td><td>Yes. Read-only. It <strong>cannot</strong> sign transactions or move your funds.</td></tr><tr><td>3</td><td><strong>How do I start?</strong></td><td>Paste this URL into your AI's MCP / Connector settings and start chatting:</td></tr></tbody></table>

```
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.

<figure><img src="https://2230654657-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWcKfs3vWiDuhitgCkBQQ%2Fuploads%2FDIeeCk500hMPejwF5RXE%2Fimage.png?alt=media&#x26;token=8de6a328-e667-47e1-9441-f02cf36e9210" alt=""><figcaption></figcaption></figure>

***

### 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)**)**

<figure><img src="https://2230654657-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWcKfs3vWiDuhitgCkBQQ%2Fuploads%2FcicjL7uNluSx6FTvzjzv%2Fimage.png?alt=media&#x26;token=c1cb5160-95fa-4ed7-94b3-ad6e60d1a288" alt=""><figcaption></figcaption></figure>

1. **Settings** → **Connectors** → **Add custom connector**
2. **Name:** NAVI Protocol · **URL:** <https://open-api.naviprotocol.io/api/mcp> · 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:** <https://open-api.naviprotocol.io/api/mcp> · **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: `<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.