Helius Core AI MCP Server

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, pag