NAVI Protocol MCP

официальный

Взаимодействуйте с DeFi-протоколом NAVI на блокчейне Sui для получения рыночных данных и выполнения транзакций.

GitHub

Что можно делать с NAVI Protocol MCP?

Получить сводку по протоколу — Запросите общий масштаб и ключевые метрики NAVI с помощью navi_get_protocol_stats.
Проверить кредитные пулы — Получите ставки по депозитам/займам, LTV и параметры риска для конкретных пулов через navi_get_pools и navi_get_pool.
Проверить состояние кошелька и вознаграждения — Просмотрите коэффициент здоровья адреса с помощью navi_get_health_factor и перечислите невостребованные вознаграждения по кредитам.
Свести активы и позиции кошелька — Объедините navi_get_coins и get_positions, чтобы увидеть балансы и активные DeFi-позиции для адреса Sui.
Получить котировку обмена — Запросите ценовую котировку для обмена токенов без совершения сделки с помощью navi_get_swap_quote.
Объяснить транзакцию Sui — Преобразуйте идентификатор сырой транзакции в действия и результаты на простом языке с помощью sui_explain_transaction.

Документация

Руководство пользователя NAVI Protocol MCP

Публичный интерфейс данных и объяснений DeFi для AI-клиентов. Не требует API-ключа, готов к использованию «из коробки» и подходит для пользовательских запросов, исследования контента и технических интеграций.

В одном предложении

NAVI Protocol MCP — это открытый сервис Model Context Protocol. Он объединяет разрозненные возможности экосистемы NAVI Protocol — включая кредитование, обмен, мосты, DCA, доходные хранилища Volo Vault, активы кошельков и интерпретацию транзакций Sui — в стандартизированный набор инструментов, которые AI-клиенты могут вызывать напрямую.

Его основная ценность не просто в «ещё одном API». Он превращает информацию, для получения которой обычно требуется переключаться между страницами протоколов, обозревателями блоков и множеством страниц продуктов, в структурированный контекст, который AI может понять, объединить и объяснить. Пользователи могут просто задавать вопросы на естественном языке, а AI — вызывать NAVI Protocol MCP для получения ответов, более приближенных к реальным потребностям принятия решений.

Для кого это

Обычные пользователи, желающие быстро понять экосистему NAVI Protocol без ручной проверки множества страниц
Ончейн-пользователи, уже активные в Sui, которым нужна помощь AI в интерпретации активов, позиций, транзакций и рисков
Разработчики, исследователи или команды, которым нужен публичный, бесплатный, не требующий авторизации DeFi MCP-сервис
Создатели контента и аналитики, желающие, чтобы AI занимался получением данных и интерпретацией результатов, а сами они могли сосредоточиться на анализе и решениях

Основная информация для доступа

Пункт	Детали
Конечная точка	`https://open-api.naviprotocol.io/api/mcp`
Аутентификация	API-ключ не требуется
Стоимость	Бесплатно
Рекомендуемый транспорт	Streamable HTTP
Границы возможностей	Запросы и интерпретация только для чтения; не обрабатывает подписание, авторизацию или выполнение транзакций

Начало работы за 3 минуты

Вариант A: Добавление напрямую в клиенте, поддерживающем удалённый MCP

Если ваш клиент предоставляет такие пункты, как Add MCP Server, Remote MCP или HTTP MCP, вам потребуется только следующее:

Имя сервера: navi-protocol
URL: https://open-api.naviprotocol.io/api/mcp
Заголовки: оставьте пустыми

Сохраните и переподключитесь. После этого вы сможете задавать вопросы прямо в чате, не запоминая конкретные названия инструментов.

Вариант B: Пример с Cursor

Если вы используете Cursor, добавьте удалённый сервер в конфигурацию MCP:

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

После настройки обновите список MCP или перезапустите клиент, затем задавайте вопросы прямо в окне чата.

Вариант C: Пример с Claude Code

Если вы используете Claude Code, вы можете добавить HTTP MCP-сервис через командную строку:

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

Вариант D: Пример с Codex

Если вы используете OpenAI Codex, добавьте MCP-сервер в глобальный или проектный config.toml (например, ~/.codex/config.toml или .codex/config.toml):

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

Вы также можете быстро добавить его через CLI:

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

После настройки используйте два приведённых ниже запроса для быстрой проверки соединения:

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

Как задавать более качественные вопросы

Обычным пользователям не нужно вызывать инструменты вручную. Лучший способ — напрямую сообщить AI свою цель, целевой объект и предпочтительный формат вывода.

Привычки для более качественных запросов

Указывайте стиль вывода, например «объясни простым языком» или «обобщи в формате исследовательского отчёта»
Указывайте ограничения, например «только котировки, не выполняй сделки» или «только основная сеть Sui»
Указывайте приоритеты, например «сначала о рисках», «сначала о доступных наградах» или «сначала о доступности мостов»

Публичные возможности, доступные сегодня

В таблице ниже приведены основные возможности, предоставляемые NAVI Protocol MCP в настоящее время, и примеры запросов на естественном языке, которые пользователи могут задавать напрямую.

Вариант использования	Характерные инструменты	Рекомендуемый запрос
Обзор протокола	`navi_get_protocol_stats`	`What is the current overall scale of NAVI Protocol?`
Анализ пулов кредитования	`navi_get_pools`, `navi_get_pool`	`What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?`
Проверка рисков	`navi_get_health_factor`, `navi_get_price_feeds`	`Is this address's health factor safe?`
Информация о наградах	`navi_get_lending_rewards`, `navi_get_available_rewards`	`What lending rewards are still unclaimed for this address?`
Кошелёк и позиции	`navi_get_coins`, `get_positions`	`Please summarize this address's current assets and DeFi positions.`
Конфигурация рынка	`navi_get_market_config`	`Which assets are currently supported in NAVI Main Market?`
Информация о токенах	`navi_search_tokens`	`Help me check DEEP's contract address, decimals, and current price.`
Котировки обмена	`navi_get_swap_quote`	`If I swap 1 SUI to USDC, about how much can I get?`
Поиск мостов	`navi_get_bridge_chains`, `navi_search_bridge_tokens`, `navi_get_bridge_quote`	`Which chains support bridging? Can this token bridge cross-chain?`
Отслеживание мостов	`navi_get_bridge_tx_status`, `navi_get_bridge_history`	`Help me check what stage this bridge transaction is currently in.`
Запросы DCA	`navi_get_dca_orders`, `navi_get_dca_order_details`, `navi_list_dca_orders`	`Please list DCA orders for this address.`
Обзор 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?`
Аналитика 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?`
Позиции пользователей 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?`
Объяснение транзакций	`sui_get_transaction`, `sui_explain_transaction`	`Please translate this transaction into plain human-readable language.`

Прямое тестирование для технических пользователей

Если вы хотите сначала проверить доступность сервиса в терминале, вы можете отправлять MCP-запросы напрямую. В примере инициализации ниже используется версия протокола 2025-06-18, которая была проверена в этом руководстве. Если ваш клиент автоматически согласовывает версии протокола, ручное указание не требуется.

1. Инициализация

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. Список инструментов

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. Прямой вызов инструмента

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

Советы по использованию

Если вы впервые работаете с DeFi, попросите AI объяснить результаты простым языком, а не выводить сырой JSON напрямую.
Если вы хотите оценить, стоит ли актив или пул более глубокого исследования, используйте сначала этот путь: обзор протокола -> параметры пула -> котировка -> риск.
Если вы не уверены в адресе контракта токена или количестве десятичных знаков, ищите напрямую по символу, например: Help me check DEEP token info.
Если вы планируете предоставить свой адрес, попросите AI обобщить активы, позиции и риски вместе для более полного и эффективного результата.
Если вы хотите сначала просто проверить соединение, начните с запроса, не зависящего от адресов кошельков, например обзор протокола, параметры пула SUI или объяснение публичной транзакции.

Общие ограничения и примечания

NAVI Protocol MCP в настоящее время служит уровнем запросов и интерпретации только для чтения. Он не обрабатывает подписание, авторизацию или прямое выполнение сделок.
Поддерживает ли AI-клиент Remote MCP, Streamable HTTP или автоматическое согласование протокола, зависит от реализации самого клиента.
Запросы на основе адреса, история мостов или некоторые агрегированные возможности могут зависеть от состояния вышестоящего сервиса, ограничений частоты запросов и тайм-аутов.
Если вам нужна интерпретация, а не сырые данные, явно попросите AI в вашем запросе обобщить, сравнить или выделить риски.

Почему это важно для пользовательского опыта

Ценность NAVI Protocol MCP в том, что он объединяет множество ончейн-возможностей в единый уровень доступа, который AI может вызывать напрямую, значительно снижая когнитивную нагрузку на пользователя.

Традиционный процесс использования часто выглядит так:

Проверить число на странице протокола
Отследить транзакцию в обозревателе блоков
Открыть другие страницы для проверки маршрутов обмена или поддержки мостов
Вручную собрать контекст и принять решение

С NAVI Protocol MCP AI может сначала получить структурированные данные, а затем объединить их с вашим вопросом для получения ответов, более приближенных к реальным сценариям принятия решений. Для пользователей по-настоящему важны не сами поля, а «как мне интерпретировать эти данные прямо сейчас?» Именно здесь MCP приносит наибольшую пользу на уровне опыта продукта.