Server MCP Helius - Helius Docs

Server MCP Helius memberi alat AI akses langsung ke API Helius melalui 10 alat publik — 9 alat domain terarah yang mencakup seluruh fungsionalitas Helius dan Solana, ditambah expandResult untuk menelusuri respons besar per halaman.

9 Routed Tools

Alat yang dikelompokkan berdasarkan domain (heliusWallet, heliusAsset, heliusTransaction, …) — setiap tindakan Helius dapat diakses melalui salah satunya

Account Signup

Buat akun Helius dari alat AI Anda — bayar melalui tautan yang di-host atau pembayaran otomatis USDC dari keypair lokal

Real-Time Data

Berlangganan Enhanced WebSockets dan LaserStream gRPC langsung dari alat AI Anda

Any MCP Client

Berfungsi dengan Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, dan alat apa pun yang kompatibel dengan MCP

Apa itu MCP?

Model Context Protocol (MCP) adalah standar sumber terbuka yang diperkenalkan oleh Anthropic dan memungkinkan model AI terhubung secara aman ke sumber data, alat, serta API eksternal. MCP menggunakan arsitektur klien-server, tempat host (seperti Claude) terhubung ke server MCP sehingga AI dapat membuat kueri ke basis data, memanggil API, atau menjalankan tindakan melalui antarmuka universal yang terstandarisasi. Mengapa hal ini penting untuk Helius: MCP memberi Claude akses langsung ke data Solana real-time dan infrastruktur Helius — saldo, metadata aset, transaksi yang telah diuraikan, pengelolaan webhook, streaming, dan lainnya. Tanpa MCP, Claude harus menebak respons API atau membuat permintaan curl berulang kali untuk memperoleh konteks. MCP memungkinkan Claude benar-benar berinteraksi dengan Solana melalui Helius menggunakan pemanggilan alat terstruktur.

Situs dokumentasi Helius di helius.dev/docs juga menyediakan server MCP terpisah yang dibuat secara otomatis oleh Mintlify. Cakupan server tersebut hanya untuk pencarian dokumentasi. helius-mcp yang didokumentasikan di sini adalah server komprehensif yang mencakup seluruh fungsionalitas Helius dan Solana.

Mulai Cepat

Add the MCP server

claude mcp add helius npx helius-mcp@latest

Atau tambahkan ke konfigurasi host MCP Anda (Claude Desktop, Cursor, Windsurf, VS Code, dan sebagainya):

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Configure your API key

Jika Anda sudah memiliki kunci:

export HELIUS_API_KEY=YOUR_API_KEY

Atau atur di dalam Claude dengan memanggil tindakan setHeliusApiKey pada heliusAccount. Kunci API ditentukan dalam urutan berikut:

Pemanggilan tindakan setHeliusApiKey dalam sesi
Variabel lingkungan HELIUS_API_KEY
~/.helius/config.json (diatur melalui Helius CLI)

Jika Anda memerlukan akun baru: Lihat Pendaftaran di bawah.

Start using tools

Ajukan pertanyaan dalam bahasa Inggris biasa — alat dan tindakan yang tepat akan dipilih secara otomatis:

“NFT apa yang dimiliki dompet ini?”
“Uraikan transaksi ini: 5abc...”
“Dapatkan saldo Gh9ZwEm...”
“Kirim 1 SOL ke 7xKp...”
“Buat webhook untuk alamat ini”

Menghubungkan ke Server MCP Helius

Jalankan perintah berikut:

claude mcp add helius npx helius-mcp@latest

Atau tambahkan ke .mcp.json proyek Anda:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Verifikasi dengan:

claude mcp list

Ingin keterampilan + MCP dalam satu langkah? Instal plugin Helius sebagai gantinya. Jalankan ini sebagai dua perintah terpisah:

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

Buka Settings > Developer > Edit Config, lalu tambahkan server:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Mulai ulang Claude Desktop untuk menerapkan perubahan.

Buka palet perintah (Cmd/Ctrl + Shift + P), cari MCP: Add Server, lalu masukkan:

Nama: helius
Perintah: npx helius-mcp@latest

Atau tambahkan ke .cursor/mcp.json proyek Anda:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Buat file .vscode/mcp.json di direktori root proyek Anda:

{
  "servers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Memerlukan ekstensi GitHub Copilot dengan dukungan MCP yang diaktifkan.

Buka palet perintah (Cmd/Ctrl + Shift + P), cari Configure MCP Servers, lalu tambahkan:

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Jalankan perintah berikut:

codex mcp add helius -- npx helius-mcp@latest

Atau tambahkan ke ~/.codex/config.toml Anda (atau .codex/config.toml untuk cakupan proyek):

[mcp_servers.helius]
command = "npx"
args = ["helius-mcp@latest"]

Verifikasi dengan:

codex mcp list

Antarmuka Alat Publik

MCP Helius menyediakan 10 alat publik: 9 alat domain terarah ditambah expandResult. Setiap tindakan Helius dan Solana dapat diakses sebagai argumen action pada alat terarah yang sesuai.

Alat	Cakupan
`heliusAccount`	Penyiapan akun, autentikasi, paket, penagihan
`heliusWallet`	Saldo dompet, kepemilikan, riwayat, identitas
`heliusAsset`	Aset, NFT, koleksi, pemegang token
`heliusTransaction`	Penguraian transaksi dan riwayat transaksi dompet
`heliusChain`	Status chain, akun token, blok, status jaringan, akun program
`heliusStreaming`	CRUD webhook dan konfigurasi langganan (WebSockets, LaserStream)
`heliusKnowledge`	Dokumentasi, panduan, harga, pemecahan masalah, kode sumber, blog, SIMD
`heliusWrite`	Transfer — token SOL dan SPL
`heliusCompression`	Bukti Merkle untuk NFT terkompresi
`expandResult`	Perluas keluaran yang mendahulukan ringkasan berdasarkan `resultId`

Full Tool Catalog

Setiap tindakan dikelompokkan berdasarkan alat terarah, dengan detail format pemanggilan dan penggunaan expandResult

Format pemanggilan alat terarah

Masing-masing dari 9 alat terarah memiliki format umum yang sama:

action — nama tindakan Helius yang akan dijalankan, seperti getBalance atau createWebhook
parameter khusus domain — misalnya address, signatures, atau webhookURL
detail opsional — summary, standard, atau full
kolom telemetri — _feedback, _feedbackTool, _model

Contoh pemanggilan:

{
  "name": "heliusWallet",
  "arguments": {
    "action": "getBalance",
    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
    "_feedback": "initial balance check",
    "_feedbackTool": "heliusWallet.getBalance",
    "_model": "your-model-id"
  }
}

Respons yang mendahulukan ringkasan dan `expandResult`

Respons berukuran besar mendahulukan ringkasan. Alat terarah mengembalikan ringkasan ringkas beserta resultId ketika respons lengkap akan berukuran besar atau ketika detail: "summary" diminta. Gunakan expandResult dengan resultId tersebut untuk mengambil bagian, rentang, halaman, atau potongan lanjutan tertentu sesuai permintaan. Hal ini menjaga penggunaan token tetap rendah untuk kueri eksploratif sekaligus memungkinkan agen menelusuri payload lengkap saat diperlukan.

Pendaftaran

Buat akun Helius dari alat AI Anda melalui tautan pembayaran yang di-host atau dengan membayar USDC langsung dari keypair lokal. Alur pendaftaran dijalankan melalui alat terarah heliusAccount:

Generate a keypair

AI memanggil heliusAccount dengan action: "generateKeypair" — tindakan ini membuat dompet Solana dan mengembalikan alamatnya.

Create the payment intent

AI memanggil heliusAccount dengan action: "signup" dan mode: "link" — tindakan ini mengembalikan paymentUrl (misalnya https://dashboard.helius.dev/pay/<id>) yang dibuka pengguna untuk membayar dengan dompet apa pun. Atau teruskan mode: "autopay" untuk mengirim USDC dari keypair lokal secara otomatis (dompet harus memiliki sekitar 0,001 SOL + jumlah paket dalam USDC).

Resume after payment

Setelah membayar melalui tautan, AI memanggil heliusAccount dengan action: "signup" dan mode: "resume" — tindakan ini memeriksa intent pembayaran secara berkala, menyelesaikan penyediaan akun, dan mengonfigurasi kunci API secara otomatis.

Informasi kontak: setiap pendaftaran baru — termasuk paket Agent — memerlukan email, firstName, dan lastName. upgradePlan memerlukan hal yang sama.

Atau lakukan hal yang sama dari terminal dengan Helius CLI:

npx helius-cli@latest keygen
npx helius-cli@latest signup --plan agent --email you@example.com --first-name Jane --last-name Doe   # Print hosted payment link
# (pay in browser, then:)
npx helius-cli@latest signup --resume         # Finalize account
# Or autopay from the local keypair:
npx helius-cli@latest signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

Konfigurasi Jaringan

Server MCP secara default menggunakan mainnet-beta. Beralihlah ke devnet melalui variabel lingkungan:

export HELIUS_NETWORK=devnet

Atau panggil tindakan setNetwork pada heliusAccount dalam suatu sesi.

Prompt Sistem

Paket helius-mcp menyertakan prompt sistem siap pakai yang mengajarkan model AI cara menggunakan alat Helius secara efektif. Prompt tersebut berada di system-prompts/:

system-prompts/
├── helius/              # Core Helius skill
├── helius-phantom/      # Phantom frontend skill
├── helius-jupiter/      # Jupiter DeFi skill
├── helius-dflow/        # DFlow trading skill
├── helius-okx/          # OKX trading & intelligence skill
└── svm/                 # SVM architecture skill

Masing-masing berisi tiga varian:

openai.developer.md — untuk OpenAI Responses/Chat Completions API (pesan developer)
claude.system.md — untuk Claude API (prompt sistem)
full.md — mandiri dengan semua referensi disertakan langsung (Cursor Rules, ChatGPT, dan sebagainya)

Lihat panduan integrasi helius-skills/SYSTEM-PROMPTS.md untuk contoh kode.

Keterampilan

Keterampilan adalah kumpulan instruksi ahli yang mengajarkan Claude cara mengarahkan permintaan Anda ke tindakan MCP dan file referensi yang tepat. Keterampilan ini melampaui akses alat dasar — di dalamnya terdapat logika perutean, pola SDK yang benar, dan aturan yang mencegah kesalahan umum.

Skills Overview

Tersedia enam keterampilan: Build (pengembangan Solana umum), Phantom (dApp frontend), Jupiter (DeFi), DFlow (aplikasi perdagangan), OKX (perdagangan dan intelijen), serta SVM (internal protokol)

Pelajari Lebih Lanjut

Claude Code Plugin

Instalasi MCP + keterampilan dengan sekali klik

Helius CLI

Pengelolaan akun melalui baris perintah

MCP Specification

Pelajari standar Model Context Protocol

helius-mcp on npm

Detail paket dan riwayat versi

Changelog

Riwayat versi dan catatan rilis

Contribute

Panduan kontribusi untuk helius-mcp

9 Routed Tools

Account Signup

Real-Time Data

Any MCP Client

​Apa itu MCP?

​Mulai Cepat

​Menghubungkan ke Server MCP Helius

​Antarmuka Alat Publik

Full Tool Catalog

​Format pemanggilan alat terarah

​Respons yang mendahulukan ringkasan dan expandResult

​Pendaftaran

​Konfigurasi Jaringan

​Prompt Sistem

​Keterampilan

Skills Overview

​Pelajari Lebih Lanjut

Claude Code Plugin

Helius CLI

MCP Specification

helius-mcp on npm

Changelog

Contribute

Apa itu MCP?

Mulai Cepat

Menghubungkan ke Server MCP Helius

Antarmuka Alat Publik

Format pemanggilan alat terarah

Respons yang mendahulukan ringkasan dan `expandResult`

Pendaftaran

Konfigurasi Jaringan

Prompt Sistem

Keterampilan

Pelajari Lebih Lanjut