NAVI Protocol MCP

resmi

Sui blokzincirinde NAVI DeFi protokolü ile piyasa verileri ve işlemler için etkileşim kurun.

GitHub

NAVI Protocol MCP ile neler yapabilirsiniz?

Get a protocol-wide summary — Ask for NAVI’s overall scale and key metrics using navi_get_protocol_stats.
Inspect lending pools — Retrieve supply/borrow rates, LTV, and risk parameters for specific pools via navi_get_pools and navi_get_pool.
Check wallet health and rewards — Review an address’s health factor with navi_get_health_factor and list unclaimed lending rewards.
Summarize wallet assets and positions — Combine navi_get_coins and get_positions to see holdings and active DeFi positions for a Sui address.
Get a swap quote — Request a price quote for a token swap without executing a trade using navi_get_swap_quote.
Explain a Sui transaction — Turn a raw transaction ID into plain-language actions and effects with sui_explain_transaction.

Dokümantasyon

NAVI Protocol MCP Kullanıcı Rehberi

Yapay zeka istemcileri için halka açık bir DeFi veri ve açıklama arayüzü. API anahtarı gerekmez, kutudan çıktığı gibi kullanıma hazırdır ve kullanıcı sorguları, içerik araştırması ve teknik entegrasyonlar için uygundur.

Tek Cümlede

NAVI Protocol MCP, açık bir Model Bağlam Protokolü hizmetidir. NAVI Protocol ekosistemindeki dağınık yetenekleri (kredi verme, takas, köprüleme, DCA, Volo Vault getiri kasaları, cüzdan varlıkları ve Sui işlem yorumlama dahil) yapay zeka istemcilerinin doğrudan çağırabileceği standartlaştırılmış bir araç setinde toplar.

Temel değeri yalnızca "bir API daha" olması değildir. Normalde protokol sayfaları, blok gezginleri ve birden fazla ürün sayfası arasında gezinmeyi gerektiren bilgileri, yapay zekanın anlayabileceği, birleştirebileceği ve açıklayabileceği yapılandırılmış bağlama dönüştürür. Kullanıcılar doğal dilde sorular sorabilir ve yapay zeka, gerçek karar verme ihtiyaçlarına daha yakın yanıtlar üretmek için NAVI Protocol MCP'yi çağırabilir.

Kimler İçindir

Birden fazla sayfayı manuel olarak kontrol etmeden NAVI Protocol ekosistemini hızlıca anlamak isteyen günlük kullanıcılar
Varlıkları, pozisyonları, işlemleri ve riskleri yorumlamak için yapay zeka yardımı isteyen, Sui'de halihazırda aktif olan zincir üstü kullanıcılar
Herkese açık, ücretsiz, kimlik doğrulamasız bir DeFi MCP hizmeti isteyen geliştiriciler, araştırmacılar veya ekipler
Analiz ve kararlara odaklanabilmek için veri alma ve sonuç yorumlamayı yapay zekanın yapmasını isteyen içerik üreticileri ve analistler

Temel Erişim Bilgileri

Öğe	Detaylar
Uç Nokta	`https://open-api.naviprotocol.io/api/mcp`
Kimlik Doğrulama	API anahtarı gerekmez
Maliyet	Ücretsiz
Önerilen aktarım	Akışkan HTTP
Yetenek sınırı	Salt okunur sorgulama ve yorumlama; imzalama, yetkilendirme veya işlem yürütme işlemlerini gerçekleştirmez

3 Dakikada Başlayın

Seçenek A: Uzak MCP'yi Destekleyen Bir İstemciye Doğrudan Ekleyin

İstemciniz Add MCP Server, Remote MCP veya HTTP MCP gibi girişler sağlıyorsa, yalnızca aşağıdakilere ihtiyacınız vardır:

Sunucu Adı: navi-protocol
URL: https://open-api.naviprotocol.io/api/mcp
Başlıklar: boş bırakın

Kaydedin ve yeniden bağlanın. Ardından belirli araç adlarını ezberlemeden doğrudan sohbette soru sorabilirsiniz.

Seçenek B: Cursor ile Örnek

Cursor kullanıyorsanız, MCP yapılandırmanıza bir uzak sunucu ekleyin:

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

Yapılandırmadan sonra MCP listesini yenileyin veya istemciyi yeniden başlatın, ardından doğrudan sohbet kutusunda soru sorun.

Seçenek C: Claude Code ile Örnek

Claude Code kullanıyorsanız, komut satırı aracılığıyla bir HTTP MCP hizmeti ekleyebilirsiniz:

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

Seçenek D: Codex ile Örnek

OpenAI Codex kullanıyorsanız, MCP sunucusunu global veya proje düzeyinde config.toml (örneğin, ~/.codex/config.toml veya .codex/config.toml) içine ekleyin:

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

Ayrıca CLI aracılığıyla hızlıca ekleyebilirsiniz:

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

Kurulumdan sonra, bağlantıyı hızlıca doğrulamak için aşağıdaki iki istemi kullanın:

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

Daha İyi Soru Sorma Yolları

Normal kullanıcıların araçları manuel olarak çağırması gerekmez. En iyi yol, yapay zekaya hedefinizi, hedef nesnenizi ve tercih ettiğiniz çıktı biçimini doğrudan söylemektir.

Önerilen İstem Stilleri

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.

Daha Kaliteli İstemler İçin Alışkanlıklar

"Sade bir dille açıkla" veya "araştırma raporu formatında özetle" gibi çıktı stilini belirtin
"Yalnızca alıntı yap, işlem yapma" veya "yalnızca Sui ana ağı" gibi kısıtlamalar belirtin
"Önce risklere odaklan", "önce talep edilebilir ödüllere odaklan" veya "önce köprü erişilebilirliğine odaklan" gibi öncelikler belirtin

Bugün Kullanılabilir Herkese Açık Yetenekler

Aşağıdaki tablo, NAVI Protocol MCP tarafından şu anda sunulan ana yetenekleri ve kullanıcıların doğrudan sorabileceği örnek doğal dil istemlerini özetlemektedir.

Kullanım Durumu	Temsili Araçlar	Önerilen İstem
Protokol genel bakış	`navi_get_protocol_stats`	`What is the current overall scale of NAVI Protocol?`
Kredi havuzu analizi	`navi_get_pools`, `navi_get_pool`	`What are the supply/borrow rates, LTV, and risk parameters for the SUI pool?`
Risk kontrolleri	`navi_get_health_factor`, `navi_get_price_feeds`	`Is this address's health factor safe?`
Ödül bilgisi	`navi_get_lending_rewards`, `navi_get_available_rewards`	`What lending rewards are still unclaimed for this address?`
Cüzdan ve pozisyonlar	`navi_get_coins`, `get_positions`	`Please summarize this address's current assets and DeFi positions.`
Piyasa yapılandırması	`navi_get_market_config`	`Which assets are currently supported in NAVI Main Market?`
Token bilgisi	`navi_search_tokens`	`Help me check DEEP's contract address, decimals, and current price.`
Takas teklifleri	`navi_get_swap_quote`	`If I swap 1 SUI to USDC, about how much can I get?`
Köprü keşfi	`navi_get_bridge_chains`, `navi_search_bridge_tokens`, `navi_get_bridge_quote`	`Which chains support bridging? Can this token bridge cross-chain?`
Köprü takibi	`navi_get_bridge_tx_status`, `navi_get_bridge_history`	`Help me check what stage this bridge transaction is currently in.`
DCA sorguları	`navi_get_dca_orders`, `navi_get_dca_order_details`, `navi_list_dca_orders`	`Please list DCA orders for this address.`
Volo Vault genel bakış	`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 analitiği	`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 kullanıcı pozisyonları	`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?`
İşlem açıklaması	`sui_get_transaction`, `sui_explain_transaction`	`Please translate this transaction into plain human-readable language.`

Adres Tabanlı Sorular İçin Önerilen Şablon

Sui adresinizi vermeye istekliyseniz, yapay zeka varlıklarınızı, pozisyonlarınızı, risklerinizi ve ödüllerinizi daha da özetleyebilir. İşte kopyalayıp doğrudan kullanabileceğiniz bir şablon:

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.

Bu istekler genellikle aşağıdaki yetenekleri birleştirir:

navi_get_coins
get_positions
navi_get_health_factor
navi_get_available_rewards
volo_get_vault_user_positions
volo_get_vault_user_status

Adres tabanlı sorgular zaman zaman üst akış hız sınırlarına veya zaman aşımlarına takılırsa, daha sonra tekrar denemek genellikle işe yarar.

Teknik Kullanıcılar İçin Doğrudan Test

Hizmet kullanılabilirliğini önce bir terminalde doğrulamak isterseniz, doğrudan MCP istekleri gönderebilirsiniz. Aşağıdaki başlatma örneği, bu kılavuzda doğrulanmış olan 2025-06-18 protokol sürümünü kullanır. İstemciniz protokol sürümlerini otomatik olarak müzakere ediyorsa, manuel belirtme gerekmez.

1. Başlat

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. Araçları Listele

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. Bir Aracı Doğrudan Çağır

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

Kullanım İpuçları

DeFi ile ilk kez karşılaşıyorsanız, yapay zekadan sonuçları ham JSON çıktısı yerine sade bir dille açıklamasını isteyin.
Bir varlığın veya havuzun daha derin araştırmaya değer olup olmadığını değerlendirmek istiyorsanız, önce şu yolu kullanın: protokol genel bakış -> havuz parametreleri -> teklif -> risk.
Bir token'ın sözleşme adresinden veya ondalık basamaklarından emin değilseniz, doğrudan sembolle arayın, örneğin: Help me check DEEP token info.
Kendi adresinizi vermeyi planlıyorsanız, daha eksiksiz ve verimli bir sonuç için yapay zekadan varlıkları, pozisyonları ve riskleri birlikte özetlemesini isteyin.
Yalnızca bağlantıyı test etmek istiyorsanız, protokol genel bakışı, SUI havuz parametreleri veya herkese açık bir işlemin açıklaması gibi cüzdan adreslerine bağlı olmayan bir istemle başlayın.

Yaygın Sınırlar ve Notlar

NAVI Protocol MCP şu anda salt okunur bir sorgulama ve yorumlama katmanı olarak hizmet verir. İmzalama, yetkilendirme veya doğrudan işlem yürütme işlemlerini gerçekleştirmez.
Bir yapay zeka istemcisinin Uzak MCP'yi, Akışkan HTTP'yi veya otomatik protokol müzakeresini destekleyip desteklemediği istemcinin kendi uygulamasına bağlıdır.
Adres tabanlı sorgular, köprü geçmişi veya bazı toplu yetenekler, üst akış hizmet durumu, hız sınırları ve zaman aşımlarından etkilenebilir.
Ham veri yerine yoruma ihtiyacınız varsa, isteminizde yapay zekadan açıkça özetlemesini, karşılaştırmasını veya riskleri vurgulamasını isteyin.

Bunun Kullanıcı Deneyimi İçin Önemi

NAVI Protocol MCP'nin değeri, birden fazla zincir üstü yeteneği, yapay zekanın doğrudan çağırabileceği tek bir erişim katmanında birleştirerek kullanıcı bilişsel yükünü önemli ölçüde azaltmasıdır.

Geleneksel bir kullanım akışı genellikle şöyledir:

Bir protokol sayfasındaki bir sayıyı kontrol et
Bir blok gezgininde bir işlemi takip et
Takas yollarını veya köprü desteğini kontrol etmek için diğer sayfaları aç
Bağlamı manuel olarak bir araya getir ve bir yargıya var

NAVI Protocol MCP ile yapay zeka, önce yapılandırılmış verileri alabilir, ardından bunu sorunuzla birleştirerek gerçek karar senaryolarına daha yakın yanıtlar üretebilir. Kullanıcılar için asıl önemli olan alanların kendisi değil, "bu veriyi şu anda nasıl yorumlamalıyım?" sorusudur. MCP'nin ürün deneyimi düzeyinde en fazla değeri sağladığı yer tam da burasıdır.