Helius MCP Server - Helius Docs

Le serveur Helius MCP offre aux outils IA un accès direct aux API de Helius via 10 outils publics — 9 outils de domaine routés qui couvrent toutes les fonctionnalités de Helius et Solana, plus expandResult pour paginer à travers de grandes réponses.

9 Outils Routés

Outils groupés par domaine (heliusWallet, heliusAsset, heliusTransaction, …) — chaque action de Helius est accessible à travers l’un d’eux

Inscription au Compte

Créez un compte Helius depuis votre outil IA — payez via un lien hébergé ou autopay USDC depuis une paire de clés locale

Données en Temps Réel

Abonnez-vous à Enhanced WebSockets et LaserStream gRPC directement depuis votre outil IA

Tout Client MCP

Fonctionne avec Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex, et tout outil compatible MCP

Qu’est-ce que le MCP?

Le Model Context Protocol (MCP) est une norme open-source introduite par Anthropic qui permet aux modèles IA de se connecter en toute sécurité avec des sources de données externes, des outils et des APIs. Il utilise une architecture client-serveur où un hôte (comme Claude) se connecte à un serveur MCP, permettant à l’IA d’interroger des bases de données, d’appeler des APIs ou d’exécuter des actions via une interface universelle et standardisée. Pourquoi est-ce important pour Helius: Le MCP donne à Claude un accès direct aux données en direct de Solana et à l’infrastructure Helius — soldes, métadonnées d’actifs, transactions analysées, gestion des webhooks, streaming, et plus encore. Sans cela, Claude doit deviner les réponses des API ou faire des requêtes curl répétées pour obtenir le contexte. Le MCP permet à Claude d’interagir réellement avec Solana via Helius en utilisant des appels d’outils structurés.

Le site de documentation Helius sur helius.dev/docs expose également un serveur MCP distinct auto-généré par Mintlify. Ce serveur est limité à la recherche documentaire uniquement. helius-mcp documenté ici est le serveur complet couvrant toutes les fonctionnalités de Helius et Solana.

Démarrage rapide

Ajouter le serveur MCP

claude mcp add helius npx helius-mcp@latest

Ou ajoutez-le à la configuration de votre hôte MCP (Claude Desktop, Cursor, Windsurf, VS Code, etc.):

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

Configurez votre clé API

Si vous avez déjà une clé :

export HELIUS_API_KEY=YOUR_API_KEY

Ou définissez-la dans Claude en appelant l’action setHeliusApiKey sur heliusAccount. Les clés API sont résolues dans cet ordre :

Appel d’action setHeliusApiKey au sein de la session
Variable d’environnement HELIUS_API_KEY
~/.helius/config.json (défini via la CLI Helius)

Si vous avez besoin d’un nouveau compte : Voir Inscription ci-dessous.

Commencer à utiliser les outils

Posez des questions en anglais courant — l’outil et l’action appropriés sont sélectionnés automatiquement :

“Quels NFTs ce portefeuille possède-t-il ?”
“Analysez cette transaction : 5abc...”
“Obtenez le solde de Gh9ZwEm...”
“Envoyez 1 SOL à 7xKp...”
“Créez un webhook pour cette adresse”

Connexion au Serveur MCP Helius

Exécutez la commande suivante :

claude mcp add helius npx helius-mcp@latest

Ou ajoutez-le au .mcp.json de votre projet :

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

Vérifiez avec :

claude mcp list

Vous voulez des compétences + MCP en une seule étape ? Installez le plugin Helius à la place. Exécutez-les en deux commandes séparées :

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

Ouvrez Paramètres > Développeur > Modifier la Configuration et ajoutez le serveur :

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

Redémarrez Claude Desktop pour appliquer.

Ouvrez la palette de commandes (Cmd/Ctrl + Shift + P), recherchez MCP : Ajouter un Serveur, et entrez :

Nom : helius
Commande : npx helius-mcp@latest

Ou ajoutez-le au .cursor/mcp.json de votre projet :

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

Créez un fichier .vscode/mcp.json à la racine de votre projet :

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

Nécessite l’extension GitHub Copilot avec le support MCP activé.

Ouvrez la palette de commandes (Cmd/Ctrl + Shift + P), recherchez Configurer les Serveurs MCP, et ajoutez :

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

Exécutez la commande suivante :

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

Ou ajoutez-le à votre ~/.codex/config.toml (ou .codex/config.toml pour une portée projet) :

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

Vérifiez avec :

codex mcp list

Surface d’Outil Public

Helius MCP expose 10 outils publics : 9 outils de domaine routés plus expandResult. Chaque action Helius et Solana est accessible en tant qu’argument action sur l’outil routé approprié.

Outil	Portée
`heliusAccount`	Configuration de compte, auth, plans, facturation
`heliusWallet`	Soldes de portefeuille, avoirs, historique, identité
`heliusAsset`	Actifs, NFTs, collections, détenteurs de tokens
`heliusTransaction`	Analyse de transaction et historique de transaction de portefeuille
`heliusChain`	État de la chaîne, comptes de tokens, blocs, statut réseau, comptes de programme
`heliusStreaming`	CRUD de webhook et configuration d’abonnement (WebSockets, LaserStream)
`heliusKnowledge`	Docs, guides, tarification, dépannage, source, blog, SIMDs
`heliusWrite`	Transferts — Tokens SOL et SPL
`heliusCompression`	Preuves de Merkle pour NFTs compressés
`expandResult`	Élargir les sorties du résumé en premier avec `resultId`

Catalogue Complet d'Outils

Chaque action groupée par outil routé, avec détails de la forme d’appel et utilisation de expandResult

Forme d’appel de l’outil routé

Chacun des 9 outils routés partage une forme commune :

action — le nom de l’action Helius à exécuter, tel que getBalance ou createWebhook
paramètres spécifiques au domaine — par exemple address, signatures, ou webhookURL
optionnel detail — summary, standard, ou full
champs de télémétrie — _feedback, _feedbackTool, _model

Exemple d’appel :

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

Réponses en Résumé d’abord et `expandResult`

Les réponses lourdes sont en résumé d’abord. Les outils routés retournent un résumé compact plus un resultId lorsque la réponse complète serait grande ou lorsque detail: "summary" est demandée. Utilisez expandResult avec ce resultId pour récupérer une section spécifique, une plage, une page ou une tranche de continuation sur demande. Cela maintient l’utilisation des tokens faible pour les requêtes exploratoires tout en permettant aux agents d’approfondir le contenu complet lorsque nécessaire.

Inscription

Créez un compte Helius depuis votre outil IA via un lien de paiement hébergé ou en payant USDC directement depuis une paire de clés locale. Le flux d’inscription passe par l’outil routé heliusAccount :

Générer une paire de clés

L’IA appelle heliusAccount avec action: "generateKeypair" — elle crée un portefeuille Solana et retourne l’adresse.

Créer l'intention de paiement

L’IA appelle heliusAccount avec action: "signup" et mode: "link" — retourne un paymentUrl (e.g. https://dashboard.helius.dev/pay/<id>) que l’utilisateur ouvre pour payer avec n’importe quel portefeuille. Ou passez mode: "autopay" pour envoyer USDC depuis la paire de clés locale automatiquement (le portefeuille doit contenir ~0.001 SOL + le montant du plan en USDC).

Reprendre après le paiement

Après avoir payé via le lien, l’IA appelle heliusAccount avec action: "signup" et mode: "resume" — sonde l’intention de paiement, finalise l’approvisionnement du compte, et configure automatiquement la clé API.

Informations de contact : chaque nouvelle inscription — y compris le plan Agent — nécessite email, firstName, et lastName. upgradePlan nécessite la même chose.

Ou faites de même depuis le terminal avec la CLI Helius :

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

Configuration du Réseau

Le serveur MCP est par défaut sur mainnet-beta. Passez à devnet via la variable d’environnement :

export HELIUS_NETWORK=devnet

Ou appelez l’action setNetwork sur heliusAccount au sein d’une session.

Invites Système

Le package helius-mcp est livré avec des invites système préconstruites qui enseignent aux modèles IA comment utiliser efficacement les outils Helius. Elles se trouvent dans 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

Chacune contient trois variantes :

openai.developer.md — pour OpenAI Responses/Chat Completions API (message developer)
claude.system.md — pour Claude API (invite système)
full.md — autonome avec toutes les références intégrées (Règles Cursor, ChatGPT, etc.)

Voir le guide d’intégration helius-skills/SYSTEM-PROMPTS.md pour des exemples de code.

Compétences

Les compétences sont des ensembles d’instructions expertes qui apprennent à Claude comment acheminer vos requêtes vers les bonnes actions MCP et fichiers de référence. Elles vont au-delà de l’accès simple aux outils — elles incluent la logique d’acheminement, les modèles appropriés de SDK et les règles qui préviennent les erreurs courantes.

Aperçu des Compétences

Six compétences disponibles : Build (développement Solana général), Phantom (dApps frontend), Jupiter (DeFi), DFlow (applications de trading), OKX (trading et intelligence), et SVM (internes du protocole)

En Savoir Plus

Plugin Claude Code

Installation en un clic de MCP + compétences

Helius CLI

Gestion de compte en ligne de commande

Spécification MCP

En savoir plus sur la norme Model Context Protocol

helius-mcp sur npm

Détails du package et historique des versions

Changelog

Historique des versions et notes de mise à jour

Contribuer

Guide de contribution pour helius-mcp

9 Outils Routés

Inscription au Compte

Données en Temps Réel

Tout Client MCP

​Qu’est-ce que le MCP?

​Démarrage rapide

​Connexion au Serveur MCP Helius

​Surface d’Outil Public

Catalogue Complet d'Outils

​Forme d’appel de l’outil routé

​Réponses en Résumé d’abord et expandResult

​Inscription

​Configuration du Réseau

​Invites Système

​Compétences

Aperçu des Compétences

​En Savoir Plus

Plugin Claude Code

Helius CLI

Spécification MCP

helius-mcp sur npm

Changelog

Contribuer

Qu’est-ce que le MCP?

Démarrage rapide

Connexion au Serveur MCP Helius

Surface d’Outil Public

Forme d’appel de l’outil routé

Réponses en Résumé d’abord et `expandResult`

Inscription

Configuration du Réseau

Invites Système

Compétences

En Savoir Plus