Helius Official Core Ai

---
name: helius-official-core-ai
description: "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."
---

# helius-official-core-ai

_Source: [github.com/helius-labs/core-ai](https://github.com/helius-labs/core-ai). The body below is the upstream README.md captured at the time of registration._

---

# 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`](./helius-cli) | CLI for managing Helius accounts and querying Solana data | `npm install -g helius-cli` |
| [`helius-mcp`](./helius-mcp) | MCP server with 10 public tools total: 9 routed domains plus `expandResult` | `claude mcp add helius npx helius-mcp@latest` |
| [`helius-skills`](./helius-skills) | Standalone Claude Code skills for building on Solana | `./install.sh` |
| [`helius-plugin`](./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

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

```bash
helius config set-api-key <your-api-key>
```

Get your key from [dashboard.helius.dev](https://dashboard.helius.dev). That's it — skip the steps below.

#### New users — create an account

**Step 1 — Generate a keypair**

```bash
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**

```bash
helius signup
```

**Step 4 — Start using the CLI**

```bash
# 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`

```bash
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](https://modelcontextprotocol.io) 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](https://www.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

```bash
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

```bash
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](https://docs.anthropic.com/en/docs/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-skills/helius) | `/helius` | Build Solana apps with Helius infrastructure — Sender, DAS API, WebSockets, Laserstream, webhooks, priority fees, and our Wallet API |
| [`helius-dflow`](./helius-skills/helius-dflow) | `/helius-dflow` | Build Solana trading apps combining DFlow's trading APIs (spot swaps, prediction markets, Proof KYC) with Helius infrastructure |
| [`svm`](./helius-skills/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:

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

```bash
./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:

```bash
claude mcp add helius npx helius-mcp@latest
```

---

## helius-plugin

An all-in-one [Claude Code plugin](https://docs.anthropic.com/en/docs/claude-code/plugins) 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 `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

```bash
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`](./helius-skills/SYSTEM-PROMPTS.md) for detailed integration guides and code examples.

---

## Development

All packages use TypeScript and `pnpm`.

```bash
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](https://www.helius.dev).

---

## Resources

- [Helius](https://www.helius.dev/)
- [Helius Docs](https://www.helius.dev/docs)
- [helius-sdk](https://github.com/helius-labs/helius-sdk)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [Claude Code Skills](https://docs.anthropic.com/en/docs/claude-code/skills)
- [Claude Code Plugins](https://docs.anthropic.com/en/docs/claude-code/plugins)