Helius pour les agents

Le serveur MCP Helius : les outils

Le Model Context Protocol (MCP) est un standard open source introduit par Anthropic qui permet aux modèles d’IA de se connecter de manière sécurisée à des sources de données, des outils et des API externes. Il remplace les intégrations personnalisées par une interface universelle et standardisée. 

Le serveur MCP Helius rend Helius — et Solana — accessible à n’importe quel client MCP.

Sans MCP, un agent qui tente de vérifier le solde d’un wallet doit ouvrir un shell, construire une commande curl, l’envoyer, analyser la sortie JSON et espérer avoir utilisé le bon endpoint et les bons paramètres.

Multipliez cela par chaque appel API d’un workflow donné et vous obtenez des interactions lentes, fragiles et sujettes aux erreurs, alourdies par la nécessité de lancer une instance de shell pour chaque commande.

Avec MCP, rien de tout cela ne se produit.

L’agent appelle getBalance sous forme d’appel d’outil structuré et reçoit une réponse typée. Aucun shell. Aucun curl. Aucune analyse de sortie : tout fonctionne directement.

Il en va de même pour parseTransaction, getAssetsByOwner, createWebhook et les plus de 60 autres outils. Les agents peuvent désormais utiliser Helius directement avec les bons paramètres et recevoir des données structurées. 

Le serveur MCP Helius fournit des outils pour :

• Inscription autonome : créer des comptes, obtenir des clés API, changer de plan, etc.
• Données blockchain en direct : RPC, DAS API, ZK Compression et plus encore
• Streaming de données :  WebSockets (standards et améliorés), LaserStream gRPC (latence au niveau des shreds)
• Envoi de transactions : Priority Fee API, transferts SPL et Sender
• Webhooks : créer, mettre à jour et supprimer des notifications déclenchées par des événements
• Wallet et historique : soldes, transferts, analyse de transactions, identité du wallet et analyse du financement
• Connaissances sur Solana : SIMDs, références au code source d’Agave et de Firedancer, contenu du blog Helius et recherche dans la documentation officielle de Solana

Installation rapide

Pour ajouter le serveur MCP Helius avec Claude Code, exécutez :

claude mcp add helius npx helius-mcp@latest

Pour Codex, exécutez :

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

Pour Cursor, VS Code ou des outils similaires, ajoutez ceci à votre configuration MCP :

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

Définissez ensuite votre clé API à l’aide de l’outil setHeliusApiKey ou d’une variable d’environnement (par exemple, HELIUS_API_KEY), puis commencez à déployer.

Pour les nouveaux utilisateurs, votre agent peut créer un compte de manière autonome : il génère une paire de clés, vous l’approvisionnez, puis vous appelez agenticSignup pour acheter le plan souhaité à partir de 1 $. 

Helius Skills : le cerveau

MCP donne aux agents accès à plus de 60 outils. Mais l’accès seul ne suffit pas : un agent disposant d’un catalogue d’outils ressemble à un développeur qui a ouvert tous les onglets de documentation sans avoir la moindre expérience. Il peut appeler les outils, mais il ne sait pas lequel choisir, comment les combiner pour une tâche donnée ni quelles erreurs éviter. 

Les skills sont le cerveau. Ce sont des ensembles d’instructions expertes — des prompts soigneusement conçus avec une logique de routage, des fichiers de référence et des règles — qui apprennent à un agent à devenir un développeur Solana expert.

Lorsqu’un skill est chargé, l’agent sait que searchAssets est préférable à getProgramAccounts pour rechercher des NFT, que les frais de priorité doivent être récupérés dynamiquement via getPriorityFeeEstimates et que les transactions doivent passer par Sender pour maximiser leur taux d’inclusion. Les skills apportent à votre agent une expertise métier.

Aujourd’hui, nous lançons quatre Helius Skills principaux :

Build

Le skill Build est destiné au développement Solana de base. Il dirige l’agent vers les bons outils pour DAS, Sender, WebSockets, LaserStream, Webhooks, Enhanced Transactions, l’analyse de wallets et l’intégration. C’est le skill par défaut pour développer quoi que ce soit sur Solana avec Helius. 

DFlow

Le skill DFlow est destiné au développement d’applications de trading. Il combine les API DFlow (par exemple, swaps spot, marchés de prédiction, streaming en temps réel et Proof KYC) à l’infrastructure Helius pour l’envoi de transactions, l’optimisation des frais et la surveillance on-chain. 

Phantom

Le skill Phantom est destiné au développement d’applications frontend avec le SDK Phantom Connect. Il couvre la connexion de wallets, le contrôle d’accès par token, la création de NFT, les paiements en cryptomonnaies, l’affichage de portefeuilles et l’architecture frontend sécurisée.

SVM

Le skill SVM permet aux agents de comprendre le fonctionnement interne du protocole Solana. Découvrez comment le bytecode sBPF est exécuté, les considérations liées à la conception d’Alpenglow, l’économie des validateurs et bien plus encore en récupérant du contenu en direct depuis le blog Helius, les SIMDs et le code source d’Agave/Firedancer. Aucune clé API requise.

Fonctionnement des skills

Les skills sont indépendants du modèle. Chacun inclut des variantes de prompts système prédéfinies pour fonctionner sur toutes les plateformes, et pas seulement avec Claude.

Utilisez openai.developer.md pour l’API OpenAI, claude.system.md pour l’API Claude ou full.md pour les règles Cursor, les instructions personnalisées de ChatGPT ou tout autre outil. Consultez la présentation des skills pour obtenir les instructions de configuration propres à chaque plateforme.

Les skills sont installés automatiquement lorsque vous utilisez le plugin Helius Claude Code. Les skills autonomes peuvent être installés en tant qu’Agent Skills : ils sont appelés automatiquement, sans commande slash :

# Clone our AI tooling repo
git clone https://github.com/helius-labs/core-ai.git

# Navigate to helius-skills
cd core-ai/helius-skills

# Install your desired skill
./helius/install.sh            # Build skill → ~/.claude/skills/helius/
./helius-dflow/install.sh      # DFlow skill → ~/.claude/skills/helius-dflow/
./svm/install.sh               # SVM skill   → ~/.claude/skills/svm/

Grâce à ces skills, les agents peuvent développer pratiquement n’importe quelle application Solana — des frontends de trading aux applications de marchés de prédiction, en passant par les systèmes de traitement des paiements en stablecoins — en appliquant les bons modèles dès le départ.

Le plugin Helius Claude Code : l’offre groupée

MCP fournit les outils, tandis que les skills constituent le cerveau. Le plugin Helius Claude Code forme l’offre groupée : une seule installation relie tous les éléments. Tout fonctionne directement.

Le plugin regroupe Helius MCP, DFlow MCP, les quatre skills et des fichiers de référence détaillés pour chaque produit Helius.

Aucune configuration manuelle de MCP. Aucune configuration séparée des skills.

Une seule installation suffit pour donner à votre agent, au cours d’une même session, un accès structuré à la blockchain et une expertise approfondie de Solana.

Installation rapide

Voici comment installer le plugin Helius depuis la marketplace Claude Code :

/plugin marketplace add helius-labs/core-ai
/plugin install helius@helius-labs

C’est tout. Le plugin démarre automatiquement les deux serveurs MCP et vous propose actuellement quatre commandes slash :

La configuration de la clé API est identique à celle du MCP autonome : utilisez une clé existante, activez l’inscription autonome ou utilisez Helius CLI. 

À quoi cela ressemble en pratique

Une fois le plugin installé, un seul prompt suffit pour obtenir une application fonctionnelle. Par exemple :

« Crée-moi un CLI de déclaration fiscale afin que je puisse récupérer l’activité on-chain de Toly à l’aide de l’adresse de son wallet 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Commence par le mois dernier (février) et génère un fichier CSV qui répertorie tous ses événements imposables. Conçois-le pour qu’il fonctionne avec n’importe quel wallet et n’importe quelle période. »

Claude le réalise en une seule tentative :   

Le skill /helius:build se déclenche et suggère correctement getTransactionsByAddress avec pagination et filtrage par horodatage afin de renvoyer un historique des transactions entièrement analysé à partir de l’activité récente de Toly.

Aucune sélection manuelle d’outils, aucun prompt intermédiaire. L’agent lit les bons fichiers de référence, appelle les bons outils MCP et produit un CLI fonctionnel compatible avec n’importe quel wallet et n’importe quelle plage de dates.

Bien entendu, les agents peuvent développer des applications plus complexes, comme des bots de trading :

Pour cet exemple, nous avons installé le plugin Helius Claude Code et demandé à Claude de développer un bot de trading qui suit les tokens PumpFun en temps réel en diffusant leur création et les transactions via LaserStream.

Nous lui avons également demandé d’afficher les données de marché et de fournir des graphiques simples pour nous permettre de simuler des transactions. C’est tout. Claude a développé ce bot de trading, avec streaming et trading de tokens en direct, en moins de 10 minutes.

Voilà la différence entre donner des outils à un agent et lui apporter une expertise.

Helius CLI

Helius CLI est une interface de ligne de commande complète proposant plus de 95 commandes CLI qui couvrent tout, de la gestion des comptes à l’interrogation de Solana, en passant par l’envoi de transactions, la gestion des webhooks, le streaming en temps réel, le staking, ZK Compression et bien plus encore.

Bien que nous recommandions MCP pour les workflows pilotés par l’IA — les appels d’outils structurés sont préférables au lancement d’instances de shell et à l’analyse de leur sortie — le CLI est le choix adapté aux scripts shell, à la création de pipelines CI/CD ou aux environnements dans lesquels MCP n’est pas disponible. Chaque commande prend en charge l’option --json pour produire une sortie lisible par les machines et renvoie des codes de sortie structurés, ce qui permet aux automatisations de gérer les erreurs par programmation.

Installation rapide

Pour les nouveaux utilisateurs, la procédure est simple :

# Install the CLI
npm install -g helius-cli
helius keygen                    # Generate keypair

# Fund wallet with ~0.001 SOL + 1 USDC
helius signup --json             # Create account, get API key
helius projects                  # List projects
helius apikeys <project-id>      # Get API keys

Pour les utilisateurs existants, il suffit d’exécuter :

helius config set-api-key YOUR_API_KEY

SDK optimisés pour les agents

Pour les agents qui développent des applications par programmation, nous avons publié une documentation optimisée pour les agents concernant notre SDK TypeScript et nos SDK Rust.

Ces pages présentent les modèles recommandés pour les workflows courants des agents, notamment l’envoi de transactions via Sender, le traitement par lots, les données en temps réel, la pagination et la gestion des erreurs. 

SDK TypeScript

Le SDK Helius TypeScript fournit des méthodes à typage sûr pour chaque appel API Helius. Le point essentiel pour les agents est que les méthodes propres à Helius réduisent les workflows Solana en plusieurs étapes à des appels uniques. 

Par exemple, getTransactionsForAddress remplace l’ancien modèle standard en deux étapes, qui consiste à récupérer les signatures puis les transactions, par un seul appel avec filtrage côté serveur, plages temporelles et prise en charge des comptes de tokens : 

import { createHelius } from "helius-sdk";

const helius = createHelius({ apiKey: "YOUR_API_KEY" });

// Single call: full transaction history with token activity
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    transactionDetails: "full",
    limit: 100,
    filters: { tokenAccounts: "balanceChanged" },
  },
]);

De même, sendSmartTransaction gère automatiquement la simulation, l’estimation des unités de calcul, les frais de priorité et la confirmation.

sendTransactionWithSender va encore plus loin en étant optimisé pour l’envoi de transactions avec une latence ultra-faible.

Consultez les bonnes pratiques TypeScript pour le traitement par lots, la pagination, les données en temps réel via webhook et WebSockets, la récupération incrémentielle des comptes, la gestion des erreurs et les pièges courants que les agents doivent éviter. 

SDK Rust

Le SDK Helius Rust fournit des bindings Rust asynchrones avec les mêmes méthodes Helius, ce qui le rend idéal pour les workflows agentiques à hautes performances :

use helius::Helius;
use helius::types::*;

let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;

// Same single-call pattern as TypeScript
let txs = helius.rpc().get_transactions_for_address(
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
    GetTransactionsForAddressOptions {
        transaction_details: Some(TransactionDetails::Full),
        limit: Some(100),
        filters: Some(GetTransactionsFilters {
            token_accounts: Some(TokenAccountsFilter::BalanceChanged),
            ..Default::default()
        }),
        ..Default::default()
    },
).await?;

Le SDK Rust fournit également des variantes d’erreurs typées (par exemple, HeliusError::RateLimitExceeded), ce qui permet aux agents de faire correspondre directement les erreurs au lieu d’analyser des chaînes de caractères.

Consultez les bonnes pratiques Rust pour appliquer les mêmes modèles en Rust (par exemple, traitement par lots, pagination, Sender, stratégies de nouvelle tentative et pièges courants). 

Commencer

Helius offre aux agents la boîte à outils la plus complète pour développer des applications prêtes pour la production sur Solana. Voici comment commencer :

• Chemin le plus rapide : installez le plugin Claude Code 
• N’importe quel client MCP : ajoutez le serveur MCP Helius à Claude Desktop, Cursor, VS Code, Codex ou Windsurf
• Automatisation shell : installez Helius CLI pour les scripts et la CI/CD
• Intégration API : ajoutez un prompt système de skill à l’API OpenAI, à l’API Claude ou à ChatGPT

Consultez notre documentation, explorez le dépôt GitHub, proposez une intégration de skill et contactez notre équipe d’assistance si vous avez des questions.