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-cursor | Cursor plugin — live blockchain tools and expert coding patterns | /add-plugin → search "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_KEY environment 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-mcp here 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 fees, transaction simulationheliusStreaming — 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 by resultId
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:
setHeliusApiKey tool call within the sessionHELIUS_API_KEY environment 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 |
helius-jupiter | /helius-jupiter | Build Solana DeFi apps combining Jupiter's APIs with Helius infrastructure — swaps, lending, limit orders, DCA, perps, and price data |
helius-okx | /helius-okx | Compose OKX DEX aggregation and market data with Helius Solana infrastructure — swaps, token discovery, smart money signals, and portfolio intelligence |
helius-phantom | /helius-phantom | Build browser-based Solana apps with Phantom wallet + Helius — wallet connection, transaction signing, API key proxying, and secure URLs |
svm | /svm | Explore Solana's architecture and protocol internals — SVM execution engine, account model, consensus, validator economics, and token extensions |
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 |
| Jupiter | /helius:jupiter | Expert Solana DeFi apps — Jupiter swaps, lending, limit orders, DCA, perps, and price data combined with Helius infrastructure |
| OKX | /helius:okx | Compose OKX DEX aggregation and market data with Helius Solana infrastructure |
| Phantom | /helius:phantom | Expert frontend Solana dev — Phantom wallet integration, CORS handling, API proxying |
| SVM | /helius:svm | Solana protocol expert — architecture, internals, consensus, and validator economics |
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
setHeliusApiKey tool with your key from https://dashboard.helius.dev
- New account:
generateKeypair → signup with mode: "link" (browser pay) or mode: "autopay" (pay USDC from local keypair) → after browser payment, signup with mode: "resume"
- CLI:
npx helius-cli@latest keygen → npx helius-cli@latest signup --plan agent (link) → user pays in browser → npx helius-cli@latest signup --resume (or --pay to autopay)
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.
Resources
