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

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:

1. --api-key <key> flag
2. HELIUS_API_KEY environment variable
3. ~/.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, billing
• heliusWallet — wallet balances, holdings, identity, wallet history
• heliusAsset — assets, NFTs, collections, token holders
• heliusTransaction — parsed transactions and wallet transaction history
• heliusChain — raw chain state, token accounts, blocks, network status, stake reads, priority fees
• heliusStreaming — webhook CRUD and live subscription configuration
• heliusKnowledge — docs, guides, pricing references, troubleshooting, source, blog, SIMDs
• heliusWrite — SOL/token transfers and staking mutations
• heliusCompression — compressed account, proof, balance, and history queries
• expandResult — 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:

1. setHeliusApiKey tool call within the session
2. HELIUS_API_KEY environment variable
3. ~/.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

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:

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: 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

Platform Support

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

• Helius
• Helius Docs
• helius-sdk
• Model Context Protocol
• Claude Code Skills
• Claude Code Plugins