NAVI Protocol MCP

Guide d'utilisation de NAVI Protocol MCP

Une interface publique de données et d'explications DeFi pour les clients IA. Aucune clé API requise, prêt à l'emploi, et adapté aux requêtes utilisateur, à la recherche de contenu et aux intégrations techniques.

En une phrase

NAVI Protocol MCP est un service ouvert Model Context Protocol. Il regroupe des fonctionnalités dispersées au sein de l'écosystème NAVI Protocol – incluant le prêt, l'échange, le pontage, le DCA, les coffres de rendement Volo Vault, les actifs de portefeuille et l'interprétation des transactions Sui – en une boîte à outils standardisée que les clients IA peuvent appeler directement.

Sa valeur fondamentale n'est pas simplement « une API de plus ». Il transforme des informations qui nécessitent normalement de naviguer entre les pages du protocole, les explorateurs de blocs et de multiples pages produits en un contexte structuré que l'IA peut comprendre, combiner et expliquer. Les utilisateurs peuvent simplement poser des questions en langage naturel, et l'IA peut appeler NAVI Protocol MCP pour produire des réponses plus proches des besoins réels de prise de décision.

À qui cela s'adresse

• Aux utilisateurs quotidiens qui souhaitent comprendre rapidement l'écosystème NAVI Protocol sans vérifier manuellement plusieurs pages
• Aux utilisateurs on-chain déjà actifs sur Sui qui souhaitent une aide de l'IA pour interpréter les actifs, les positions, les transactions et les risques
• Aux développeurs, chercheurs ou équipes qui souhaitent un service MCP DeFi public, gratuit et sans authentification
• Aux créateurs de contenu et analystes qui souhaitent que l'IA gère la récupération des données et l'interprétation des résultats afin de se concentrer sur l'analyse et les décisions

Informations d'accès principales

Élément	Détails
Point de terminaison	https://open-api.naviprotocol.io/api/mcp
Authentification	Aucune clé API requise
Coût	Gratuit
Transport recommandé	HTTP streamable
Limite de capacité	Interrogation et interprétation en lecture seule ; ne gère pas la signature, l'autorisation ou l'exécution de transactions

Démarrez en 3 minutes

Option A : Ajouter directement dans un client prenant en charge MCP distant

Si votre client propose des entrées telles que Add MCP Server, Remote MCP ou HTTP MCP, vous avez seulement besoin de ce qui suit :

• Nom du serveur : navi-protocol
• URL : https://open-api.naviprotocol.io/api/mcp
• En-têtes : laisser vide

Enregistrez et reconnectez-vous. Vous pourrez alors poser des questions directement dans le chat sans mémoriser de noms d'outils spécifiques.

Option B : Exemple avec Cursor

Si vous utilisez Cursor, ajoutez un serveur distant dans votre configuration MCP :

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

Après la configuration, actualisez la liste MCP ou redémarrez le client, puis posez des questions directement dans la boîte de dialogue.

Option C : Exemple avec Claude Code

Si vous utilisez Claude Code, vous pouvez ajouter un service MCP HTTP via la ligne de commande :

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

Option D : Exemple avec Codex

Si vous utilisez OpenAI Codex, ajoutez le serveur MCP dans le fichier config.toml global ou au niveau du projet (par exemple, ~/.codex/config.toml ou .codex/config.toml) :

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

Vous pouvez également l'ajouter rapidement via l'interface en ligne de commande :

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

Après la configuration, utilisez les deux invites ci-dessous pour vérifier rapidement la connectivité :

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

Comment poser de meilleures questions

Les utilisateurs réguliers n'ont pas besoin d'appeler les outils manuellement. La meilleure façon est de communiquer directement à l'IA votre objectif, l'objet cible et le format de sortie souhaité.

Styles d'invite recommandés

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

Habitudes pour des invites de meilleure qualité

• Spécifiez le style de sortie, comme « expliquer en langage simple » ou « résumer au format rapport de recherche »
• Spécifiez des contraintes, comme « citer uniquement, ne pas exécuter de transactions » ou « réseau principal Sui uniquement »
• Spécifiez des priorités, comme « se concentrer d'abord sur les risques », « se concentrer d'abord sur les récompenses réclamables » ou « se concentrer d'abord sur l'accessibilité du pont »

Capacités publiques disponibles aujourd'hui

Le tableau ci-dessous résume les principales capacités actuellement exposées par NAVI Protocol MCP et des exemples d'invites en langage naturel que les utilisateurs peuvent poser directement.

Cas d'utilisation	Outils représentatifs	Invite recommandée
Aperçu du protocole	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
Analyse des pools de prêt	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
Vérifications des risques	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
Informations sur les récompenses	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
Portefeuille et positions	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
Configuration du marché	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
Informations sur les jetons	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
Devis d'échange	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
Découverte de ponts	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
Suivi de ponts	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
Requêtes DCA	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
Aperçu Volo Vault	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?
Analyse Volo Vault	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?
Positions utilisateur Volo Vault	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?
Explication de transaction	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

Modèle recommandé pour les questions basées sur l'adresse

Si vous acceptez de fournir votre adresse Sui, l'IA peut en outre résumer vos actifs, positions, risques et récompenses. Voici un modèle que vous pouvez copier et utiliser directement :

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.

Ces requêtes combinent généralement les capacités suivantes :

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

Si les requêtes basées sur l'adresse rencontrent occasionnellement des limites de débit ou des délais d'attente en amont, réessayer plus tard fonctionne généralement.

Test direct pour les utilisateurs techniques

Si vous souhaitez d'abord vérifier la disponibilité du service dans un terminal, vous pouvez envoyer des requêtes MCP directement. L'exemple d'initialisation ci-dessous utilise la version de protocole 2025-06-18, qui a été vérifiée dans ce guide. Si votre client négocie automatiquement les versions de protocole, la spécification manuelle n'est pas requise.

1. Initialiser

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. Lister les outils

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. Appeler un outil directement

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

Conseils d'utilisation

• Si c'est votre première expérience avec la DeFi, demandez à l'IA d'expliquer les résultats en langage simple au lieu de produire directement du JSON brut.
• Si vous souhaitez évaluer si un actif ou un pool mérite une recherche approfondie, utilisez d'abord ce chemin : aperçu du protocole -> paramètres du pool -> devis -> risque.
• Si vous n'êtes pas sûr de l'adresse du contrat ou des décimales d'un jeton, effectuez une recherche par symbole directement, par exemple : Help me check DEEP token info.
• Si vous prévoyez de fournir votre propre adresse, demandez à l'IA de résumer ensemble les actifs, les positions et les risques pour un résultat plus complet et plus efficace.
• Si vous souhaitez seulement tester la connectivité d'abord, commencez par une invite qui ne dépend pas des adresses de portefeuille, comme l'aperçu du protocole, les paramètres du pool SUI ou l'explication d'une transaction publique.

Limites et remarques courantes

• NAVI Protocol MCP sert actuellement de couche d'interrogation et d'interprétation en lecture seule. Il ne gère pas la signature, l'autorisation ou l'exécution directe de transactions.
• La prise en charge par un client IA du MCP distant, du HTTP streamable ou de la négociation automatique de protocole dépend de l'implémentation propre du client.
• Les requêtes basées sur l'adresse, l'historique des ponts ou certaines capacités agrégées peuvent être affectées par l'état du service en amont, les limites de débit et les délais d'attente.
• Si vous avez besoin d'une interprétation plutôt que de données brutes, demandez explicitement à l'IA de résumer, de comparer ou de mettre en évidence les risques dans votre invite.

Pourquoi cela est important pour l'expérience utilisateur

La valeur de NAVI Protocol MCP réside dans le fait qu'il unifie de multiples capacités on-chain en une seule couche d'accès que l'IA peut appeler directement, réduisant ainsi considérablement la charge cognitive de l'utilisateur.

Un flux d'utilisation traditionnel est souvent :

• Vérifier un nombre sur une page de protocole
• Suivre une transaction dans un explorateur de blocs
• Ouvrir d'autres pages pour vérifier les routes d'échange ou la prise en charge des ponts
• Assembler manuellement le contexte et porter un jugement

Avec NAVI Protocol MCP, l'IA peut d'abord récupérer des données structurées, puis les combiner avec votre question pour produire des réponses plus proches des scénarios de décision réels. Pour les utilisateurs, ce qui importe vraiment n'est pas les champs eux-mêmes, mais « comment dois-je interpréter ces données maintenant ? » C'est précisément là que MCP apporte le plus de valeur au niveau de l'expérience produit.