NAVI Protocol MCP

Guia do Usuário do NAVI Protocol MCP

Uma interface pública de dados e explicações DeFi para clientes de IA. Sem necessidade de chave de API, pronto para uso imediato e adequado para consultas de usuários, pesquisa de conteúdo e integrações técnicas.

Em Uma Frase

O NAVI Protocol MCP é um serviço aberto do Model Context Protocol. Ele empacota capacidades dispersas pelo ecossistema do NAVI Protocol — incluindo empréstimos, trocas, pontes, DCA, cofres de rendimento Volo Vault, ativos de carteira e interpretação de transações Sui — em um conjunto de ferramentas padronizado que clientes de IA podem chamar diretamente.

Seu valor central não é apenas "mais uma API". Ele transforma informações que normalmente exigem navegar entre páginas de protocolo, exploradores de blocos e múltiplas páginas de produtos em contexto estruturado que a IA pode entender, combinar e explicar. Os usuários podem simplesmente fazer perguntas em linguagem natural, e a IA pode chamar o NAVI Protocol MCP para produzir respostas mais próximas das necessidades reais de tomada de decisão.

Para Quem É Destinado

• Usuários comuns que desejam entender rapidamente o ecossistema do NAVI Protocol sem verificar manualmente várias páginas
• Usuários on-chain já ativos na Sui que desejam ajuda da IA para interpretar ativos, posições, transações e riscos
• Desenvolvedores, pesquisadores ou equipes que desejam um serviço DeFi MCP público, gratuito e sem autenticação
• Criadores de conteúdo e analistas que desejam que a IA lide com a recuperação de dados e interpretação de resultados para que possam focar em análises e decisões

Informações Principais de Acesso

Item	Detalhes
Endpoint	https://open-api.naviprotocol.io/api/mcp
Autenticação	Sem necessidade de chave de API
Custo	Gratuito
Transporte recomendado	HTTP Transmissível (Streamable HTTP)
Limite de capacidade	Consulta e interpretação somente leitura; não lida com assinatura, autorização ou execução de transações

Comece em 3 Minutos

Opção A: Adicionar Diretamente em um Cliente com Suporte a MCP Remoto

Se o seu cliente oferece entradas como Add MCP Server, Remote MCP ou HTTP MCP, você só precisa do seguinte:

• Nome do Servidor: navi-protocol
• URL: https://open-api.naviprotocol.io/api/mcp
• Cabeçalhos: deixar vazio

Salve e reconecte. Então você pode fazer perguntas diretamente no chat sem precisar memorizar nomes de ferramentas específicas.

Opção B: Exemplo com Cursor

Se você usa o Cursor, adicione um servidor remoto na sua configuração MCP:

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

Após a configuração, atualize a lista MCP ou reinicie o cliente, e então faça perguntas diretamente na caixa de chat.

Opção C: Exemplo com Claude Code

Se você usa o Claude Code, pode adicionar um serviço MCP HTTP através da linha de comando:

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

Opção D: Exemplo com Codex

Se você usa o OpenAI Codex, adicione o servidor MCP no config.toml global ou de projeto (por exemplo, ~/.codex/config.toml ou .codex/config.toml):

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

Você também pode adicioná-lo rapidamente via CLI:

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

Após a configuração, use os dois prompts abaixo para verificar rapidamente a conectividade:

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

Como Fazer Perguntas Melhores

Usuários comuns não precisam chamar ferramentas manualmente. A melhor maneira é dizer diretamente à IA seu objetivo, objeto alvo e formato de saída preferido.

Estilos de Prompt 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 Prompts de Maior Qualidade

• Especifique o estilo de saída, como "explique em linguagem simples" ou "resuma em formato de relatório de pesquisa"
• Especifique restrições, como "apenas cotação, não execute negociações" ou "apenas rede principal Sui"
• Especifique prioridades, como "foco em riscos primeiro", "foco em recompensas resgatáveis primeiro" ou "foco em alcance de pontes primeiro"

Capacidades Públicas Disponíveis Hoje

A tabela abaixo resume as principais capacidades atualmente expostas pelo NAVI Protocol MCP e exemplos de prompts em linguagem natural que os usuários podem fazer diretamente.

Caso de Uso	Ferramentas Representativas	Prompt Recomendado
Visão geral do protocolo	navi_get_protocol_stats	What is the current overall scale of NAVI Protocol?
Análise de pools de empréstimo	navi_get_pools, navi_get_pool	What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?
Verificações de risco	navi_get_health_factor, navi_get_price_feeds	Is this address's health factor safe?
Informações de recompensa	navi_get_lending_rewards, navi_get_available_rewards	What lending rewards are still unclaimed for this address?
Carteira e posições	navi_get_coins, get_positions	Please summarize this address's current assets and DeFi positions.
Configuração de mercado	navi_get_market_config	Which assets are currently supported in NAVI Main Market?
Informações de token	navi_search_tokens	Help me check DEEP's contract address, decimals, and current price.
Cotações de troca	navi_get_swap_quote	If I swap 1 SUI to USDC, about how much can I get?
Descoberta de pontes	navi_get_bridge_chains, navi_search_bridge_tokens, navi_get_bridge_quote	Which chains support bridging? Can this token bridge cross-chain?
Rastreamento de pontes	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.
Visão geral do 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?
Análise do 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?
Posições de usuário no 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?
Explicação de transação	sui_get_transaction, sui_explain_transaction	Please translate this transaction into plain human-readable language.

Modelo Recomendado para Perguntas Baseadas em Endereço

Se você estiver disposto a fornecer seu endereço Sui, a IA pode resumir ainda mais seus ativos, posições, riscos e recompensas. Aqui está um modelo que você pode copiar e usar diretamente:

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.

Essas solicitações geralmente combinam as seguintes capacidades:

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

Se consultas baseadas em endereço ocasionalmente atingirem limites de taxa ou tempos limite do serviço upstream, tentar novamente mais tarde geralmente funciona.

Teste Direto para Usuários Técnicos

Se você quiser verificar a disponibilidade do serviço primeiro em um terminal, pode enviar solicitações MCP diretamente. O exemplo de inicialização abaixo usa a versão de protocolo 2025-06-18, que foi verificada neste guia. Se o seu cliente negociar automaticamente as versões de protocolo, a especificação manual não é necessária.

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 Ferramentas

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. Chamar uma Ferramenta Diretamente

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

Dicas de Uso

• Se esta é sua primeira vez com DeFi, peça à IA para explicar os resultados em linguagem simples em vez de gerar JSON bruto diretamente.
• Se você quiser avaliar se um ativo ou pool merece uma pesquisa mais aprofundada, use este caminho primeiro: visão geral do protocolo -> parâmetros do pool -> cotação -> risco.
• Se você não tiver certeza sobre o endereço do contrato ou decimais de um token, pesquise diretamente pelo símbolo, por exemplo: Help me check DEEP token info.
• Se você planeja fornecer seu próprio endereço, peça à IA para resumir ativos, posições e riscos juntos para um resultado mais completo e eficiente.
• Se você quiser apenas testar a conectividade primeiro, comece com um prompt que não dependa de endereços de carteira, como visão geral do protocolo, parâmetros do pool SUI ou explicação de uma transação pública.

Limites Comuns e Observações

• O NAVI Protocol MCP atualmente serve como uma camada de consulta e interpretação somente leitura. Ele não lida com assinatura, autorização ou execução direta de negociações.
• Se um cliente de IA suporta MCP Remoto, HTTP Transmissível ou negociação automática de protocolo depende da implementação do próprio cliente.
• Consultas baseadas em endereço, histórico de pontes ou algumas capacidades agregadas podem ser afetadas pelo status do serviço upstream, limites de taxa e tempos limite.
• Se você precisar de interpretação em vez de dados brutos, peça explicitamente à IA para resumir, comparar ou destacar riscos em seu prompt.

Por Que Isso Importa para a Experiência do Usuário

O valor do NAVI Protocol MCP é que ele unifica múltiplas capacidades on-chain em uma única camada de acesso que a IA pode chamar diretamente, reduzindo significativamente a carga cognitiva do usuário.

Um fluxo de uso tradicional geralmente é:

• Verificar um número em uma página de protocolo
• Rastrear uma transação em um explorador de blocos
• Abrir outras páginas para verificar rotas de troca ou suporte de pontes
• Juntar manualmente o contexto e fazer um julgamento

Com o NAVI Protocol MCP, a IA pode primeiro buscar dados estruturados e depois combiná-los com sua pergunta para produzir respostas mais próximas de cenários reais de decisão. Para os usuários, o que realmente importa não são os campos em si, mas "como devo interpretar esses dados agora?" É exatamente aqui que o MCP entrega o maior valor no nível da experiência do produto.