> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Server MCP Helius

> Server MCP untuk Helius — 9 alat terarah ditambah expandResult menyediakan kueri Solana, pengiriman transaksi, webhook, streaming, dan analisis dompet bagi asisten AI.

[Server MCP Helius](https://www.npmjs.com/package/helius-mcp) 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.

<CardGroup cols={2}>
  <Card title="9 Routed Tools" icon="bolt">
    Alat yang dikelompokkan berdasarkan domain (`heliusWallet`, `heliusAsset`, `heliusTransaction`, …) — setiap tindakan Helius dapat diakses melalui salah satunya
  </Card>

  <Card title="Account Signup" icon="robot">
    Buat akun Helius dari alat AI Anda — bayar melalui tautan yang di-host atau pembayaran otomatis USDC dari keypair lokal
  </Card>

  <Card title="Real-Time Data" icon="signal-stream">
    Berlangganan Enhanced WebSockets dan LaserStream gRPC langsung dari alat AI Anda
  </Card>

  <Card title="Any MCP Client" icon="plug">
    Berfungsi dengan Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, dan alat apa pun yang kompatibel dengan MCP
  </Card>
</CardGroup>

## Apa itu MCP?

[Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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.

<Note>
  Situs dokumentasi Helius di [helius.dev/docs](https://www.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.
</Note>

## Mulai Cepat

<Steps>
  <Step title="Add the MCP server">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```

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

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```
  </Step>

  <Step title="Configure your API key">
    **Jika Anda sudah memiliki kunci:**

    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

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

    1. Pemanggilan tindakan `setHeliusApiKey` dalam sesi
    2. Variabel lingkungan `HELIUS_API_KEY`
    3. `~/.helius/config.json` (diatur melalui [Helius CLI](/docs/id/agents/cli))

    **Jika Anda memerlukan akun baru:** Lihat [Pendaftaran](#pendaftaran) di bawah.
  </Step>

  <Step title="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"
  </Step>
</Steps>

## Menghubungkan ke Server MCP Helius

<Tabs>
  <Tab title="Claude Code">
    Jalankan perintah berikut:

    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```

    Atau tambahkan ke `.mcp.json` proyek Anda:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Verifikasi dengan:

    ```bash theme={"system"}
    claude mcp list
    ```

    <Tip>
      Ingin keterampilan + MCP dalam satu langkah? Instal [plugin Helius](/docs/id/agents/claude-code-plugin) sebagai gantinya. Jalankan ini sebagai dua perintah terpisah:

      ```
      /plugin marketplace add helius-labs/core-ai
      ```

      ```
      /plugin install helius@helius-labs
      ```
    </Tip>
  </Tab>

  <Tab title="Claude Desktop">
    Buka **Settings > Developer > Edit Config**, lalu tambahkan server:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Mulai ulang Claude Desktop untuk menerapkan perubahan.
  </Tab>

  <Tab title="Cursor">
    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:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    Buat file `.vscode/mcp.json` di direktori root proyek Anda:

    ```json theme={"system"}
    {
      "servers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Memerlukan ekstensi [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) dengan dukungan MCP yang diaktifkan.
  </Tab>

  <Tab title="Windsurf">
    Buka palet perintah (`Cmd/Ctrl + Shift + P`), cari **Configure MCP Servers**, lalu tambahkan:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Codex">
    Jalankan perintah berikut:

    ```bash theme={"system"}
    codex mcp add helius -- npx helius-mcp@latest
    ```

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

    ```toml theme={"system"}
    [mcp_servers.helius]
    command = "npx"
    args = ["helius-mcp@latest"]
    ```

    Verifikasi dengan:

    ```bash theme={"system"}
    codex mcp list
    ```
  </Tab>
</Tabs>

## 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`     |

<Card title="Full Tool Catalog" icon="bolt" href="/docs/id/agents/mcp/tools">
  Setiap tindakan dikelompokkan berdasarkan alat terarah, dengan detail format pemanggilan dan penggunaan `expandResult`
</Card>

### 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:

```json theme={"system"}
{
  "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`:

<Steps>
  <Step title="Generate a keypair">
    AI memanggil `heliusAccount` dengan `action: "generateKeypair"` — tindakan ini membuat dompet Solana dan mengembalikan alamatnya.
  </Step>

  <Step title="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).
  </Step>

  <Step title="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.
  </Step>
</Steps>

<Note>
  **Informasi kontak:** setiap pendaftaran baru — termasuk paket Agent — memerlukan `email`, `firstName`, dan `lastName`. `upgradePlan` memerlukan hal yang sama.
</Note>

Atau lakukan hal yang sama dari terminal dengan [Helius CLI](/docs/id/agents/cli):

```bash theme={"system"}
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:

```bash theme={"system"}
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`](https://github.com/helius-labs/core-ai/blob/main/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.

<Card title="Skills Overview" icon="brain" href="/docs/id/agents/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)
</Card>

## Pelajari Lebih Lanjut

<CardGroup cols={2}>
  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/docs/id/agents/claude-code-plugin">
    Instalasi MCP + keterampilan dengan sekali klik
  </Card>

  <Card title="Helius CLI" icon="terminal" href="/docs/id/agents/cli">
    Pengelolaan akun melalui baris perintah
  </Card>

  <Card title="MCP Specification" icon="book" href="https://modelcontextprotocol.io/">
    Pelajari standar Model Context Protocol
  </Card>

  <Card title="helius-mcp on npm" icon="npm" href="https://www.npmjs.com/package/helius-mcp">
    Detail paket dan riwayat versi
  </Card>

  <Card title="Changelog" icon="list" href="https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CHANGELOG.md">
    Riwayat versi dan catatan rilis
  </Card>

  <Card title="Contribute" icon="github" href="https://github.com/helius-labs/core-ai/blob/main/helius-mcp/CONTRIBUTING.md">
    Panduan kontribusi untuk `helius-mcp`
  </Card>
</CardGroup>