NAVI Protocol MCP

Guía de Usuario de NAVI Protocol MCP

Una interfaz pública de datos DeFi y explicaciones para clientes de IA. No requiere clave API, lista para usar de inmediato, y adecuada para consultas de usuarios, investigación de contenido e integraciones técnicas.

En Una Frase

NAVI Protocol MCP es un servicio abierto del Protocolo de Contexto de Modelo. Agrupa capacidades dispersas en el ecosistema de NAVI Protocol —incluyendo préstamos, intercambios, puentes, DCA, bóvedas de rendimiento Volo Vault, activos de billetera e interpretación de transacciones en Sui— en un conjunto de herramientas estandarizado que los clientes de IA pueden invocar directamente.

Su valor central no es solo "una API más". Convierte información que normalmente requiere saltar entre páginas de protocolo, exploradores de bloques y múltiples páginas de producto en contexto estructurado que la IA puede entender, combinar y explicar. Los usuarios pueden simplemente hacer preguntas en lenguaje natural, y la IA puede llamar a NAVI Protocol MCP para producir respuestas más cercanas a las necesidades reales de toma de decisiones.

Para Quién Es

• Usuarios cotidianos que quieren entender rápidamente el ecosistema de NAVI Protocol sin revisar manualmente múltiples páginas
• Usuarios on-chain ya activos en Sui que desean ayuda de IA para interpretar activos, posiciones, transacciones y riesgos
• Desarrolladores, investigadores o equipos que quieren un servicio DeFi MCP público, gratuito y sin autenticación
• Creadores de contenido y analistas que desean que la IA maneje la obtención de datos y la interpretación de resultados para poder enfocarse en el análisis y las decisiones

Información Central de Acceso

Elemento	Detalles
Endpoint	https://open-api.naviprotocol.io/api/mcp
Autenticación	No requiere clave API
Costo	Gratuito
Transporte recomendado	HTTP transmitible
Límite de capacidad	Consulta e interpretación de solo lectura; no maneja firma, autorización ni ejecución de transacciones

Comience en 3 Minutos

Opción A: Agregar Directamente en un Cliente que Soporte MCP Remoto

Si su cliente proporciona entradas como Add MCP Server, Remote MCP o HTTP MCP, solo necesita lo siguiente:

• Nombre del Servidor: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• Encabezados: dejar vacío

Guarde y reconecte. Luego puede hacer preguntas directamente en el chat sin memorizar nombres de herramientas específicos.

Opción B: Ejemplo con Cursor

Si usa Cursor, agregue un servidor remoto en su configuración MCP:

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

Después de la configuración, actualice la lista MCP o reinicie el cliente, luego haga preguntas directamente en la caja de chat.

Opción C: Ejemplo con Claude Code

Si usa Claude Code, puede agregar un servicio HTTP MCP a través de la línea de comandos:

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

Opción D: Ejemplo con Codex

Si usa OpenAI Codex, agregue el servidor MCP en config.toml global o a nivel de proyecto (por ejemplo, ~/.codex/config.toml o .codex/config.toml):

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

También puede agregarlo rápidamente mediante CLI:

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

Después de la configuración, use las dos indicaciones siguientes para verificar rápidamente la conectividad:

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

Cómo Hacer Mejores Preguntas

Los usuarios regulares no necesitan llamar a las herramientas manualmente. La mejor manera es decirle a la IA su objetivo, objeto de interés y formato de salida preferido directamente.

Estilos de Indicación Recomendados

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

Hábitos para Indicaciones de Mayor Calidad

• Especifique el estilo de salida, como "explique en lenguaje sencillo" o "resuma en formato de informe de investigación"
• Especifique restricciones, como "solo cotizar, no ejecutar operaciones" o "solo red principal de Sui"
• Especifique prioridades, como "enfoque en riesgos primero", "enfoque en recompensas reclamables primero" o "enfoque en accesibilidad de puentes primero"

Capacidades Públicas Disponibles Hoy

La tabla a continuación resume las principales capacidades actualmente expuestas por NAVI Protocol MCP y ejemplos de indicaciones en lenguaje natural que los usuarios pueden preguntar directamente.

Caso de Uso	Herramientas Representativas	Indicación Recomendada
Resumen del protocolo	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
Análisis de pools de préstamo	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
Verificaciones de riesgo	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
Información de recompensas	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
Billetera y posiciones	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
Configuración de mercado	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
Información de tokens	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
Cotizaciones de intercambio	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
Descubrimiento de puentes	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
Seguimiento de puentes	navi_get_bridge_tx_status, navi_get_bridge_history	Help me check what stage this bridge transaction is currently in.
Consultas DCA	navi_get_dca_orders, navi_get_dca_order_details, navi_list_dca_orders	Please list DCA orders for this address.
Resumen de 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?
Analíticas de 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?
Posiciones de usuario en 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?
Explicación de transacciones	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

Plantilla Recomendada para Preguntas Basadas en Dirección

Si está dispuesto a proporcionar su dirección de Sui, la IA puede resumir aún más sus activos, posiciones, riesgos y recompensas. Aquí hay una plantilla que puede copiar y usar directamente:

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.

Estas solicitudes generalmente combinan las siguientes capacidades:

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

Si las consultas basadas en dirección ocasionalmente encuentran límites de tasa o tiempos de espera aguas arriba, generalmente reintentar más tarde funciona.

Pruebas Directas para Usuarios Técnicos

Si desea verificar la disponibilidad del servicio en una terminal primero, puede enviar solicitudes MCP directamente. El ejemplo de inicialización a continuación usa la versión de protocolo 2025-06-18, la cual ha sido verificada en esta guía. Si su cliente negocia automáticamente las versiones de protocolo, no se requiere especificación manual.

1. Inicializar

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. Listar Herramientas

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. Llamar a una Herramienta Directamente

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

Consejos de Uso

• Si es su primera vez con DeFi, pida a la IA que explique los resultados en lenguaje sencillo en lugar de mostrar JSON crudo directamente.
• Si desea evaluar si un activo o pool merece una investigación más profunda, use esta ruta primero: resumen del protocolo -> parámetros del pool -> cotización -> riesgo.
• Si no está seguro sobre la dirección de contrato o decimales de un token, busque por símbolo directamente, por ejemplo: Help me check DEEP token info.
• Si planea proporcionar su propia dirección, pida a la IA que resuma activos, posiciones y riesgos juntos para un resultado más completo y eficiente.
• Si solo desea probar la conectividad primero, comience con una indicación que no dependa de direcciones de billetera, como resumen del protocolo, parámetros del pool SUI o explicación de una transacción pública.

Límites Comunes y Notas

• NAVI Protocol MCP actualmente sirve como una capa de consulta e interpretación de solo lectura. No maneja firma, autorización ni ejecución directa de operaciones.
• Si un cliente de IA soporta MCP Remoto, HTTP transmitible o negociación automática de protocolo depende de la implementación del propio cliente.
• Las consultas basadas en dirección, el historial de puentes o algunas capacidades agregadas pueden verse afectadas por el estado del servicio aguas arriba, límites de tasa y tiempos de espera.
• Si necesita interpretación en lugar de datos crudos, pida explícitamente a la IA que resuma, compare o destaque riesgos en su indicación.

Por Qué Esto Importa para la Experiencia del Usuario

El valor de NAVI Protocol MCP es que unifica múltiples capacidades on-chain en una sola capa de acceso que la IA puede llamar directamente, reduciendo significativamente la carga cognitiva del usuario.

Un flujo de uso tradicional a menudo es:

• Verificar un número en una página de protocolo
• Rastrear una transacción en un explorador de bloques
• Abrir otras páginas para verificar rutas de intercambio o soporte de puentes
• Unir manualmente el contexto y emitir un juicio

Con NAVI Protocol MCP, la IA puede primero obtener datos estructurados, luego combinarlos con su pregunta para producir respuestas más cercanas a escenarios de decisión reales. Para los usuarios, lo que realmente importa no son los campos en sí, sino "¿cómo debo interpretar estos datos ahora mismo?" Aquí es exactamente donde MCP entrega el mayor valor a nivel de experiencia de producto.