NAVI Protocol MCP

NAVI Protocol MCP – Benutzerhandbuch

Eine öffentliche DeFi-Daten- und Erklärungsschnittstelle für KI-Clients. Kein API-Schlüssel erforderlich, sofort einsatzbereit und geeignet für Benutzeranfragen, Inhaltsrecherche und technische Integrationen.

In einem Satz

NAVI Protocol MCP ist ein offener Model-Context-Protocol-Dienst. Er bündelt verstreute Funktionen im gesamten NAVI-Protocol-Ökosystem – darunter Lending, Swapping, Bridging, DCA, Volo-Vault-Yield-Vaults, Wallet-Assets und Sui-Transaktionsinterpretation – in einem standardisierten Toolset, das KI-Clients direkt aufrufen können.

Sein Kernwert ist nicht nur „eine weitere API“. Er verwandelt Informationen, die normalerweise das Springen zwischen Protokollseiten, Block-Explorern und mehreren Produktseiten erfordern, in strukturierten Kontext, den KI verstehen, kombinieren und erklären kann. Benutzer können einfach Fragen in natürlicher Sprache stellen, und die KI kann NAVI Protocol MCP aufrufen, um Antworten zu liefern, die echten Entscheidungsbedürfnissen näherkommen.

Für wen es geeignet ist

• Alltagsnutzer, die das NAVI-Protocol-Ökosystem schnell verstehen möchten, ohne mehrere Seiten manuell prüfen zu müssen
• On-Chain-Nutzer, die bereits auf Sui aktiv sind und KI-Hilfe bei der Interpretation von Assets, Positionen, Transaktionen und Risiken wünschen
• Entwickler, Forscher oder Teams, die einen öffentlichen, kostenlosen, auth-freien DeFi-MCP-Dienst nutzen möchten
• Content-Ersteller und Analysten, die die Datenabfrage und Ergebnisinterpretation der KI überlassen wollen, um sich auf Analyse und Entscheidungen zu konzentrieren

Zentrale Zugangsinformationen

Element	Details
Endpunkt	https://open-api.naviprotocol.io/api/mcp
Authentifizierung	Kein API-Schlüssel erforderlich
Kosten	Kostenlos
Empfohlener Transport	Streamable HTTP
Funktionsumfang	Nur lesende Abfragen und Interpretation; übernimmt keine Signierung, Autorisierung oder Transaktionsausführung

Einstieg in 3 Minuten

Option A: Direktes Hinzufügen in einem Client, der Remote MCP unterstützt

Wenn Ihr Client Einträge wie Add MCP Server, Remote MCP oder HTTP MCP bereitstellt, benötigen Sie nur Folgendes:

• Server-Name: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• Headers: leer lassen

Speichern und erneut verbinden. Anschließend können Sie Fragen direkt im Chat stellen, ohne sich bestimmte Tool-Namen merken zu müssen.

Option B: Beispiel mit Cursor

Wenn Sie Cursor verwenden, fügen Sie einen Remote-Server in Ihrer MCP-Konfiguration hinzu:

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

Aktualisieren Sie nach der Konfiguration die MCP-Liste oder starten Sie den Client neu und stellen Sie dann Fragen direkt im Chat-Fenster.

Option C: Beispiel mit Claude Code

Wenn Sie Claude Code verwenden, können Sie einen HTTP-MCP-Dienst über die Befehlszeile hinzufügen:

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

Option D: Beispiel mit Codex

Wenn Sie OpenAI Codex verwenden, fügen Sie den MCP-Server in der globalen oder projektbezogenen config.toml hinzu (zum Beispiel ~/.codex/config.toml oder .codex/config.toml):

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

Sie können ihn auch schnell per CLI hinzufügen:

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

Verwenden Sie nach der Einrichtung die folgenden zwei Prompts, um die Konnektivität schnell zu überprüfen:

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

Wie man bessere Fragen stellt

Normale Benutzer müssen Tools nicht manuell aufrufen. Der beste Weg ist, der KI direkt Ihr Ziel, das Zielobjekt und das bevorzugte Ausgabeformat mitzuteilen.

Empfohlene Prompt-Stile

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

Gewohnheiten für hochwertigere Prompts

• Geben Sie den Ausgabestil an, z. B. „in einfacher Sprache erklären“ oder „im Forschungsbericht-Format zusammenfassen“
• Geben Sie Einschränkungen an, z. B. „nur zitieren, keine Trades ausführen“ oder „nur Sui-Mainnet“
• Geben Sie Prioritäten an, z. B. „Risiken zuerst behandeln“, „forderbare Belohnungen zuerst behandeln“ oder „Bridge-Erreichbarkeit zuerst behandeln“

Derzeit verfügbare öffentliche Funktionen

Die folgende Tabelle fasst die wichtigsten Funktionen zusammen, die NAVI Protocol MCP derzeit bereitstellt, sowie beispielhafte Prompts in natürlicher Sprache, die Benutzer direkt stellen können.

Anwendungsfall	Repräsentative Tools	Empfohlener Prompt
Protokollübersicht	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
Lending-Pool-Analyse	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
Risikoprüfungen	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
Belohnungsinformationen	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
Wallet und Positionen	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
Marktkonfiguration	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
Token-Informationen	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
Swap-Angebote	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
Bridge-Erkennung	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
Bridge-Verfolgung	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
DCA-Abfragen	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
Volo-Vault-Übersicht	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-Analyse	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-Benutzerpositionen	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?
Transaktionserklärung	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

Empfohlene Vorlage für adressbasierte Fragen

Wenn Sie bereit sind, Ihre Sui-Adresse anzugeben, kann die KI Ihre Assets, Positionen, Risiken und Belohnungen weiter zusammenfassen. Hier ist eine Vorlage, die Sie kopieren und direkt verwenden können:

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.

Diese Anfragen kombinieren in der Regel die folgenden Funktionen:

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

Falls adressbasierte Abfragen gelegentlich auf Upstream-Ratenlimits oder Timeouts stoßen, funktioniert ein späterer Wiederholungsversuch in der Regel.

Direkttests für technische Benutzer

Wenn Sie die Dienstverfügbarkeit zuerst in einem Terminal überprüfen möchten, können Sie MCP-Anfragen direkt senden. Das folgende Initialisierungsbeispiel verwendet Protokollversion 2025-06-18, die in diesem Handbuch verifiziert wurde. Wenn Ihr Client Protokollversionen automatisch aushandelt, ist keine manuelle Angabe erforderlich.

1. Initialisieren

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. Tools auflisten

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. Ein Tool direkt aufrufen

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": {}
    }
  }'

Nutzungstipps

• Falls dies Ihr erster Kontakt mit DeFi ist, bitten Sie die KI, Ergebnisse in einfacher Sprache zu erklären, anstatt rohes JSON direkt auszugeben.
• Wenn Sie bewerten möchten, ob ein Asset oder Pool eine tiefere Recherche wert ist, nutzen Sie diesen Pfad: Protokollübersicht -> Pool-Parameter -> Angebot -> Risiko.
• Wenn Sie sich bei der Vertragsadresse oder den Dezimalstellen eines Tokens unsicher sind, suchen Sie direkt nach dem Symbol, zum Beispiel: Help me check DEEP token info.
• Wenn Sie Ihre eigene Adresse angeben möchten, bitten Sie die KI, Assets, Positionen und Risiken gemeinsam zusammenzufassen, um ein vollständigeres und effizienteres Ergebnis zu erhalten.
• Wenn Sie zunächst nur die Konnektivität testen möchten, beginnen Sie mit einem Prompt, der nicht von Wallet-Adressen abhängt, wie z. B. Protokollübersicht, SUI-Pool-Parameter oder Erklärung einer öffentlichen Transaktion.

Allgemeine Grenzen und Hinweise

• NAVI Protocol MCP dient derzeit als reine Lese- und Interpretationsschicht. Es übernimmt keine Signierung, Autorisierung oder direkte Handelsausführung.
• Ob ein KI-Client Remote MCP, Streamable HTTP oder automatische Protokollaushandlung unterstützt, hängt von der Implementierung des jeweiligen Clients ab.
• Adressbasierte Abfragen, Bridge-Verlauf oder einige aggregierte Funktionen können durch den Upstream-Dienststatus, Ratenlimits und Timeouts beeinträchtigt werden.
• Wenn Sie Interpretation statt Rohdaten benötigen, bitten Sie die KI ausdrücklich in Ihrem Prompt, zusammenzufassen, zu vergleichen oder Risiken hervorzuheben.

Warum dies für die Benutzererfahrung wichtig ist

Der Wert von NAVI Protocol MCP liegt darin, dass es mehrere On-Chain-Funktionen in einer einzigen Zugriffsschicht vereint, die KI direkt aufrufen kann, und so die kognitive Belastung der Benutzer erheblich reduziert.

Ein traditioneller Nutzungsablauf sieht oft so aus:

• Eine Zahl auf einer Protokollseite prüfen
• Eine Transaktion in einem Block-Explorer verfolgen
• Andere Seiten öffnen, um Swap-Routen oder Bridge-Unterstützung zu prüfen
• Kontext manuell zusammenfügen und eine Entscheidung treffen

Mit NAVI Protocol MCP kann die KI zuerst strukturierte Daten abrufen und sie dann mit Ihrer Frage kombinieren, um Antworten zu liefern, die echten Entscheidungsszenarien näherkommen. Für Benutzer zählt nicht die Felder an sich, sondern „wie soll ich diese Daten jetzt interpretieren?“ Genau hier liefert MCP den größten Mehrwert auf Produkterlebnisebene.