helius
Official Helius MCP Server - Complete Solana blockchain data access for Claude
Installation
npx helius-mcpAsk AI about helius
Powered by Claude Β· Grounded in docs
I know everything about helius. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
Helius Core AI
The official Helius AI tooling repository β everything you need to interact with Helius and Solana from the command line, from AI assistants like Claude, or autonomously as an agent.
Packages
| Package | Description | Install |
|---|---|---|
helius-cli | CLI for managing Helius accounts and querying Solana data | npm install -g helius-cli |
helius-mcp | MCP server with 10 public tools total: 9 routed domains plus expandResult | claude mcp add helius npx helius-mcp@latest |
helius-skills | Standalone Claude Code skills for building on Solana | ./install.sh |
helius-plugin | Claude Code plugin β bundles all skills and auto-starts the MCP server | /plugin install helius@helius |
helius-cli
A CLI built for developers and LLM agents to manage Helius accounts, query Solana blockchain data, and automate workflows.
Installation
npm install -g helius-cli
# or
pnpm add -g helius-cli
Quick Start
Existing Helius users
If you already have an API key, just set it and go:
helius config set-api-key <your-api-key>
Get your key from dashboard.helius.dev. That's it β skip the steps below.
New users β create an account
Step 1 β Generate a keypair
helius keygen
This creates a new Solana keypair and saves it to ~/.helius/keypair.json. The public key is printed to the terminal β you'll need it for the next step.
Step 2 β Fund the keypair (manual)
Before creating an account, send the following to the public key from step 1:
- 1 USDC (used as payment for the basic plan)
- A small amount of SOL to cover transaction fees (~0.01 SOL is sufficient)
You can use any wallet or exchange to send funds. The CLI will not proceed until the keypair has the required balance.
Step 3 β Create your Helius account
helius signup
Step 4 β Start using the CLI
# Query a wallet balance
helius balance <wallet-address>
# Parse a transaction
helius tx parse <signature>
Features
Account & Auth β Generate keypairs, create and upgrade Helius accounts, manage projects and API keys
Blockchain Queries β SOL and token balances, transaction parsing and history, digital assets (NFTs) via the DAS API, account info, block data, network status, and priority fee estimation
Webhooks β Create, update, and delete webhooks for transaction monitoring
Real-time Streaming β WebSocket subscriptions for accounts, logs, slots, signatures, and programs
Staking β Create and manage stake accounts, stake and unstake transactions
ZK Compression β 24+ commands for working with compressed accounts and tokens
Transaction Sending β Use Helius Sender for low-latency sends
Configuration
The CLI stores configuration at ~/.helius/config.json. API keys are resolved in this order:
--api-key <key>flagHELIUS_API_KEYenvironment variable~/.helius/config.json
helius config show # View current config
helius config set-api-key <key> # Set API key
helius config set-network devnet # Switch to devnet
helius config clear # Reset config
helius-mcp
A Model Context Protocol server that exposes Helius and Solana tools directly to AI assistants. Once connected, Claude and other MCP-compatible models can query blockchain data, manage webhooks, and send transactions without any additional code.
Note on the Helius docs MCP: The Helius docs site at helius.dev/docs exposes a separate MCP server auto-generated by Mintlify. That server is scoped only to documentation search and is not related to this repo.
helius-mcphere is the comprehensive server covering all Helius and Solana functionality.
Public Tool Surface
The server exposes 10 public tools total: 9 routed domain tools plus expandResult.
heliusAccountβ account setup, auth, plans, billingheliusWalletβ wallet balances, holdings, identity, wallet historyheliusAssetβ assets, NFTs, collections, token holdersheliusTransactionβ parsed transactions and wallet transaction historyheliusChainβ raw chain state, token accounts, blocks, network status, stake reads, priority feesheliusStreamingβ webhook CRUD and live subscription configurationheliusKnowledgeβ docs, guides, pricing references, troubleshooting, source, blog, SIMDsheliusWriteβ SOL/token transfers and staking mutationsheliusCompressionβ compressed account, proof, balance, and history queriesexpandResultβ expand summary-first results byresultId
The 9 domain tools take a Helius action name in action, for example heliusWallet + getBalance or heliusStreaming + createWebhook. Heavy responses are summary-first; use expandResult to fetch a full section, range, page, or continuation on demand.
Add to Claude
claude mcp add helius npx helius-mcp@latest
Configuration
API keys are resolved in this order:
setHeliusApiKeytool call within the sessionHELIUS_API_KEYenvironment variable~/.helius/config.json
Set the network via HELIUS_NETWORK (defaults to mainnet-beta, supports devnet).
Local Development
cd helius-mcp
pnpm install
pnpm build
# Add the local build to Claude
claude mcp add helius node $(pwd)/dist/index.js
helius-skills
Standalone Claude Code skills that turn Claude into a domain expert. Each skill is a self-contained directory with a SKILL.md and reference files β install once, invoke with /skill-name in any Claude Code session.
Available Skills
| Skill | Invoke | Description |
|---|---|---|
helius | /helius | Build Solana apps with Helius infrastructure β Sender, DAS API, WebSockets, Laserstream, webhooks, priority fees, and our Wallet API |
helius-dflow | /helius-dflow | Build Solana trading apps combining DFlow's trading APIs (spot swaps, prediction markets, Proof KYC) with Helius infrastructure |
svm | /svm | Explore Solana's architecture and protocol internals β SVM execution engine, account model, consensus, validator economics, and token extensions |
helius-phantom | /helius-phantom | Build browser-based Solana apps with Phantom wallet + Helius β wallet connection, transaction signing, API key proxying, and secure URLs |
Installation
Each skill has its own install.sh. Clone this repo and run the installer for whichever skills you want:
git clone https://github.com/helius-labs/core-ai.git
cd core-ai
# Install individual skills
./helius-skills/helius/install.sh # Helius skill
./helius-skills/svm/install.sh # SVM architecture skill
By default, skills install to ~/.claude/skills/ (personal, available in all projects). Use --project to install to .claude/skills/ in your current project instead:
./helius-skills/helius/install.sh --project
Prerequisites
All skills except svm require a Helius API key. The svm skill uses public knowledge tools only. Add the MCP server before using any skill:
claude mcp add helius npx helius-mcp@latest
helius-plugin
An all-in-one Claude Code plugin that bundles all skills and auto-starts the MCP server. The easiest way to get everything set up in one step.
Install
/plugin marketplace add helius-labs/claude-plugins
/plugin install helius@helius
What's Included
Helius MCP Server β auto-starts with the plugin. Exposes 10 public tools total: 9 routed domain tools plus expandResult. Domain tools take Helius action names via action, and heavy responses are summary-first.
Skills:
| Skill | Invoke | Description |
|---|---|---|
| Build | /helius:build | Expert Solana developer β Helius APIs, routing logic, SDK patterns, and common-mistake prevention |
| DFlow | /helius:dflow | Expert Solana trading apps β DFlow swaps, prediction markets, Proof KYC, combined with Helius infrastructure |
| SVM | /helius:svm | Solana protocol expert β architecture, internals, consensus, and validator economics |
| Phantom (coming soon) | /helius:phantom | Expert frontend Solana dev β Phantom wallet integration, CORS handling, API proxying |
API Key Setup
The plugin auto-starts the MCP server, but you still need a Helius API key. On first use, Claude will guide you through one of these paths:
- Existing key: Use the
setHeliusApiKeytool with your key from https://dashboard.helius.dev - New account: Autonomous signup via
generateKeypairβ fund wallet βagenticSignup - CLI:
npx helius-cli@latest keygenβ fund βnpx helius-cli@latest signup
Local Testing
claude --plugin-dir ./helius-plugin
Cross-Platform Skills
Helius skills are model-agnostic β they work across Claude Code, Codex CLI, OpenAI API, Claude API, Cursor, and other AI tools.
3-Layer Architecture
| Layer | What | Where |
|---|---|---|
| A: Harness | Runtime-specific behavior | AGENTS.md (Codex), preamble in prompt variants (API), built-in (Claude Code) |
| B: Skills | Reusable domain expertise | SKILL.md files β single source of truth in helius-skills/ |
| C: Task | User request | Provided at runtime |
Platform Support
| Platform | How to use |
|---|---|
| Claude Code | Install via helius-plugin or helius-skills/install.sh |
| Codex CLI | Auto-discovers AGENTS.md + .agents/skills/ from repo root |
| OpenAI API | Use .agents/skills/<skill>/prompts/openai.developer.md as a developer message |
| Claude API | Use .agents/skills/<skill>/prompts/claude.system.md as a system prompt |
| Cursor | Use .agents/skills/<skill>/prompts/full.md as Cursor Rules |
| npm consumers | Find prompts in helius-mcp/system-prompts/ (shipped with the npm package) |
See helius-skills/SYSTEM-PROMPTS.md for detailed integration guides and code examples.
Development
All packages use TypeScript and pnpm.
cd helius-cli # or helius-mcp
pnpm install # Install dependencies
pnpm build # Compile TypeScript β dist/
pnpm dev # Watch mode
The skills and plugin (helius-skills/, helius-plugin/) are Markdown-based and require no build step.
Requirements: Node.js 20+, pnpm, and a Helius API key β get one at helius.dev.
