Helius MCP Server

MCP server for Helius — Solana blockchain data access for AI assistants, provided by Solana's fastest, most reliable infrastructure provider

See the CHANGELOG for version history and release notes.

Interested in contributing? Read the contribution guide before opening a PR.

Quick Start

1. Add the MCP server

Add to your MCP host's config (works with Claude, Cursor, Windsurf, and any MCP-compatible client):

{
  "mcpServers": {
    "helius": {
      "command": "npx",
      "args": ["helius-mcp@latest"]
    }
  }
}

Or if you're using Claude Code:

claude mcp add helius npx helius-mcp@latest

2. Configure your API key

If you already have a Helius API key:

export HELIUS_API_KEY=your-api-key

Or set it from your AI assistant by calling the setHeliusApiKey tool.

If you need a new account:

The MCP includes a fully autonomous signup flow — no browser needed:

1. Call the generateKeypair tool — it creates a Solana wallet and returns the address
2. Fund the wallet with ~0.001 SOL (transaction fees) + 1 USDC (basic plan costs $1)
3. Call checkSignupBalance to verify funds arrived
4. Call agenticSignup to create your account — API key is configured automatically

Paid plans (developer/business/professional): agenticSignup and upgradePlan require email, firstName, and lastName. Basic plan does not.

Or do the same from the terminal:

npx helius-cli@latest keygen     # Generate keypair
# Fund the wallet address shown above with ~0.001 SOL + 1 USDC
npx helius-cli@latest signup      # Verify balance + create account

3. Start using tools

Ask questions in plain English — the right tool is selected automatically:

• "What NFTs does this wallet own?"
• "Parse this transaction: 5abc..."
• "Get the balance of Gh9ZwEm..."
• "Create a webhook for <address>"

Public Tool Surface

Helius MCP exposes 10 public tools total: 9 routed domain tools plus expandResult.

• heliusAccount — account setup, auth, plans, billing
• heliusWallet — wallet balances, holdings, wallet history, identity
• heliusAsset — assets, NFTs, collections, token holders
• heliusTransaction — transaction parsing and wallet transaction history
• heliusChain — chain state, token accounts, blocks, network status, stake reads
• heliusStreaming — webhook CRUD and subscription config
• heliusKnowledge — docs, guides, pricing, troubleshooting, source, blog, SIMDs
• heliusWrite — transfers and staking mutations
• heliusCompression — compressed account, balance, proof, and history actions
• expandResult — expand summary-first outputs by resultId

The 9 routed domain tools share a common shape:

• action — the Helius action name to run, such as getBalance or createWebhook
• domain-specific params — for example address, signatures, or webhookURL
• optional detail — summary, standard, or full
• telemetry fields — _feedback, _feedbackTool, _model

Each routed tool takes an action field with the Helius action name:

{
  "name": "heliusWallet",
  "arguments": {
    "action": "getBalance",
    "address": "Gh9ZwEmdLJ8DscKNTkTqPbNwLNNBjuSzaG9Vp2KGtKJr",
    "_feedback": "initial balance check",
    "_feedbackTool": "heliusWallet.getBalance",
    "_model": "your-model-id"
  }
}

Heavy responses are summary-first. Routed tools return a compact summary plus resultId when the full response would be large or when detail: "summary" is requested. Use expandResult with that resultId to fetch a specific section, range, page, or continuation slice on demand.

System Prompts

This package ships with pre-built system prompts that teach AI models how to use Helius tools effectively. Find them in system-prompts/:

system-prompts/
├── helius/              # Core Helius skill
├── helius-dflow/        # DFlow trading skill
├── helius-phantom/      # Phantom frontend skill
└── svm/                 # SVM architecture skill

Each contains three variants:

• openai.developer.md — for OpenAI Responses/Chat Completions API (developer message)
• claude.system.md — for Claude API (system prompt)
• full.md — self-contained with all references inlined (Cursor Rules, ChatGPT, etc.)

See helius-skills/SYSTEM-PROMPTS.md for integration guides and code examples.

Networks

Mainnet Beta (default) and Devnet. Set via HELIUS_NETWORK env var or setNetwork in the session

Related Resources

• Full Documentation
• LLM-Optimized Docs
• API Reference
• Billing and Credits
• Rate Limits
• Dashboard
• Status Page
• Full Agent Signup Instructions