Helius-MCP-Server - Helius Docs

Der Helius-MCP-Server gibt KI-Tools direkten Zugriff auf Helius-APIs über 10 öffentliche Tools — 9 geroutete Domain-Tools für alle Funktionen von Helius und Solana sowie expandResult zum Durchblättern großer responses.

9 Routed Tools

Nach Domain gruppierte Tools (heliusWallet, heliusAsset, heliusTransaction, …) — jede Helius-Aktion ist über eines davon erreichbar

Account Signup

Erstelle über dein KI-Tool ein Helius-Konto — bezahle über einen gehosteten Link oder automatisch mit USDC aus einem lokalen Schlüsselpaar

Real-Time Data

Abonniere Enhanced WebSockets und LaserStream gRPC direkt über dein KI-Tool

Any MCP Client

Funktioniert mit Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex und jedem MCP-kompatiblen Tool

Was ist MCP?

Das Model Context Protocol (MCP) ist ein von Anthropic eingeführter Open-Source-Standard. Er ermöglicht KI-Modellen, sich sicher mit externen Datenquellen, Tools und APIs zu verbinden. MCP verwendet eine Client-Server-Architektur, bei der sich ein Host wie Claude mit einem MCP-Server verbindet. So kann die KI über eine universelle, standardisierte Schnittstelle Datenbanken abfragen, APIs aufrufen oder Aktionen ausführen. Warum das für Helius wichtig ist: MCP gibt Claude direkten Zugriff auf aktuelle Solana-Daten und die Helius-Infrastruktur — Guthaben, Asset-Metadaten, geparste Transaktionen, Verwaltung von webhook, Streaming und mehr. Ohne MCP muss Claude API-responses erraten oder wiederholt curl-requests ausführen, um Kontext zu erhalten. Mit MCP kann Claude über strukturierte Tool-Aufrufe tatsächlich über Helius mit Solana interagieren.

Die Helius-Dokumentationswebsite unter helius.dev/docs stellt außerdem einen separaten MCP-Server bereit, den Mintlify automatisch generiert. Dieser Server ist ausschließlich für die Dokumentationssuche vorgesehen. Der hier dokumentierte helius-mcp ist der umfassende Server für alle Funktionen von Helius und Solana.

Schnellstart

Add the MCP server

claude mcp add helius npx helius-mcp@latest

Oder füge den Server der Konfiguration deines MCP-Hosts hinzu (Claude Desktop, Cursor, Windsurf, VS Code usw.):

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

Configure your API key

Wenn du bereits einen API key hast:

export HELIUS_API_KEY=YOUR_API_KEY

Du kannst ihn auch innerhalb von Claude festlegen, indem du die Aktion setHeliusApiKey auf heliusAccount aufrufst. API keys werden in dieser Reihenfolge ermittelt:

Aufruf der Aktion setHeliusApiKey innerhalb der Sitzung
Umgebungsvariable HELIUS_API_KEY
~/.helius/config.json (über die Helius CLI festgelegt)

Wenn du ein neues Konto benötigst: Weitere Informationen findest du unten unter Registrierung.

Start using tools

Stelle Fragen in natürlicher Sprache — das richtige Tool und die richtige Aktion werden automatisch ausgewählt:

„Welche NFTs besitzt diese Wallet?“
„Parse diese Transaktion: 5abc...“
„Rufe das Guthaben von Gh9ZwEm... ab“
„Sende 1 SOL an 7xKp...“
„Erstelle einen webhook für diese Adresse“

Verbindung mit dem Helius-MCP-Server herstellen

Führe den folgenden Befehl aus:

claude mcp add helius npx helius-mcp@latest

Oder füge Folgendes zu .mcp.json deines Projekts hinzu:

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

Überprüfe die Konfiguration mit:

claude mcp list

Möchtest du Skills und MCP in einem Schritt installieren? Installiere stattdessen das Helius-Plugin. Führe diese Befehle separat aus:

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

Öffne Settings > Developer > Edit Config und füge den Server hinzu:

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

Starte Claude Desktop neu, um die Änderungen anzuwenden.

Öffne die Befehlspalette (Cmd/Ctrl + Shift + P), suche nach MCP: Add Server und gib Folgendes ein:

Name: helius
Befehl: npx helius-mcp@latest

Oder füge Folgendes zu .cursor/mcp.json deines Projekts hinzu:

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

Erstelle im Stammverzeichnis deines Projekts eine Datei namens .vscode/mcp.json:

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

Erfordert die Erweiterung GitHub Copilot mit aktivierter MCP-Unterstützung.

Öffne die Befehlspalette (Cmd/Ctrl + Shift + P), suche nach Configure MCP Servers und füge Folgendes hinzu:

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

Führe den folgenden Befehl aus:

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

Oder füge Folgendes zu ~/.codex/config.toml hinzu (beziehungsweise zu .codex/config.toml für eine projektspezifische Konfiguration):

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

Überprüfe die Konfiguration mit:

codex mcp list

Öffentliche Tool-Oberfläche

Helius MCP stellt 10 öffentliche Tools bereit: 9 geroutete Domain-Tools sowie expandResult. Jede Aktion von Helius und Solana ist als action-Argument über das passende geroutete Tool erreichbar.

Tool	Umfang
`heliusAccount`	Kontoeinrichtung, Authentifizierung, Tarife, Abrechnung
`heliusWallet`	Wallet-Guthaben, Bestände, Verlauf, Identität
`heliusAsset`	Assets, NFTs, Sammlungen, Token-Inhaber
`heliusTransaction`	Parsen von Transaktionen und Transaktionsverlauf von Wallets
`heliusChain`	Chain-Status, Token-Konten, Blöcke, Netzwerkstatus, Programmkonten
`heliusStreaming`	CRUD für webhook und Abonnementkonfiguration (WebSockets, LaserStream)
`heliusKnowledge`	Dokumentation, Anleitungen, Preise, Fehlerbehebung, Quellcode, Blog, SIMDs
`heliusWrite`	Übertragungen — SOL- und SPL-Token
`heliusCompression`	Merkle-Beweise für komprimierte NFTs
`expandResult`	Erweitert zuerst zusammengefasste Ausgaben anhand von `resultId`

Full Tool Catalog

Alle Aktionen nach geroutetem Tool gruppiert, einschließlich Details zur Aufrufstruktur und zur Verwendung von expandResult

Aufrufstruktur gerouteter Tools

Alle 9 gerouteten Tools verwenden dieselbe grundlegende Struktur:

action — der Name der auszuführenden Helius-Aktion, zum Beispiel getBalance oder createWebhook
domainspezifische Parameter — zum Beispiel address, signatures oder webhookURL
optionales detail — summary, standard oder full
Telemetriefelder — _feedback, _feedbackTool, _model

Beispielaufruf:

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

Zuerst zusammengefasste responses und `expandResult`

Umfangreiche responses werden zuerst zusammengefasst. Geroutete Tools geben eine kompakte Zusammenfassung sowie ein resultId zurück, wenn die vollständige response groß wäre oder detail: "summary" angefordert wurde. Verwende expandResult mit diesem resultId, um bei Bedarf einen bestimmten Abschnitt, Bereich, eine Seite oder den nächsten Teil abzurufen. Dadurch bleibt der Token-Verbrauch bei explorativen Abfragen niedrig. Agents können trotzdem bei Bedarf die vollständige payload untersuchen.

Registrierung

Erstelle über dein KI-Tool ein Helius-Konto. Bezahle entweder über einen gehosteten Zahlungslink oder direkt mit USDC aus einem lokalen Schlüsselpaar. Der Registrierungsablauf verwendet das geroutete Tool heliusAccount:

Generate a keypair

Die KI ruft heliusAccount mit action: "generateKeypair" auf. Dadurch erstellt sie eine Solana-Wallet und gibt die Adresse zurück.

Create the payment intent

Die KI ruft heliusAccount mit action: "signup" und mode: "link" auf. Der Aufruf gibt ein paymentUrl zurück, zum Beispiel https://dashboard.helius.dev/pay/<id>. Der Benutzer öffnet es und bezahlt mit einer beliebigen Wallet. Übergib alternativ mode: "autopay", um USDC automatisch aus dem lokalen Schlüsselpaar zu senden. Die Wallet muss etwa 0,001 SOL und den Tarifbetrag in USDC enthalten.

Resume after payment

Nach der Zahlung über den Link ruft die KI heliusAccount mit action: "signup" und mode: "resume" auf. Der Aufruf fragt den Zahlungsstatus wiederholt ab, schließt die Kontobereitstellung ab und konfiguriert den API key automatisch.

Kontaktinformationen: Jede neue Registrierung – auch für den Agent-Plan – erfordert email, firstName und lastName. Die Wallet wird nur zum Bezahlen verwendet. Für upgradePlan gilt dasselbe.

Du kannst denselben Vorgang auch über das Terminal mit der Helius CLI ausführen:

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

Netzwerkkonfiguration

Der MCP-Server verwendet standardmäßig mainnet-beta. Wechsle über eine Umgebungsvariable zu devnet:

export HELIUS_NETWORK=devnet

Oder rufe innerhalb einer Sitzung die Aktion setNetwork auf heliusAccount auf.

System-Prompts

Das Paket helius-mcp enthält vorgefertigte System-Prompts, die KI-Modellen die effektive Verwendung der Helius-Tools vermitteln. Du findest sie unter 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

Jeder enthält drei Varianten:

openai.developer.md — für die OpenAI Responses/Chat Completions API (Nachricht developer)
claude.system.md — für die Claude API (System-Prompt)
full.md — eigenständig mit allen direkt eingebetteten Referenzen (Cursor Rules, ChatGPT usw.)

Codebeispiele findest du im Integrationsleitfaden helius-skills/SYSTEM-PROMPTS.md.

Skills

Skills sind fachkundige Anweisungssätze. Sie zeigen Claude, wie deine requests an die richtigen MCP-Aktionen und Referenzdateien weitergeleitet werden. Sie bieten mehr als nur direkten Tool-Zugriff: Sie enthalten Routing-Logik, korrekte SDK-Muster und Regeln, die häufige Fehler verhindern.

Skills Overview

Sechs Skills sind verfügbar: Build (allgemeine Solana-Entwicklung), Phantom (Frontend-dApps), Jupiter (DeFi), DFlow (Trading-Apps), OKX (Trading und Analysen) sowie SVM (interne Protokollmechanismen)

Weitere Informationen

Claude Code Plugin

Installation von MCP und Skills mit einem Klick

Helius CLI

Kontoverwaltung über die Befehlszeile

MCP Specification

Erfahre mehr über den Standard Model Context Protocol

helius-mcp on npm

Paketdetails und Versionsverlauf

Changelog

Versionsverlauf und Versionshinweise

Contribute

Leitfaden für Beiträge zu helius-mcp

9 Routed Tools

Account Signup

Real-Time Data

Any MCP Client

​Was ist MCP?

​Schnellstart

​Verbindung mit dem Helius-MCP-Server herstellen

​Öffentliche Tool-Oberfläche

Full Tool Catalog

​Aufrufstruktur gerouteter Tools

​Zuerst zusammengefasste responses und expandResult

​Registrierung

​Netzwerkkonfiguration

​System-Prompts

​Skills

Skills Overview

​Weitere Informationen

Claude Code Plugin

Helius CLI

MCP Specification

helius-mcp on npm

Changelog

Contribute

Was ist MCP?

Schnellstart

Verbindung mit dem Helius-MCP-Server herstellen

Öffentliche Tool-Oberfläche

Aufrufstruktur gerouteter Tools

Zuerst zusammengefasste responses und `expandResult`

Registrierung

Netzwerkkonfiguration

System-Prompts

Skills

Weitere Informationen