> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Helius MCP Server

> MCP server for Helius — 60+ tools for querying Solana, sending transactions, managing webhooks, streaming data, and more. Gives AI tools direct access to Helius APIs.

The [Helius MCP server](https://www.npmjs.com/package/helius-mcp) gives AI tools direct access to Helius APIs through 60+ tools — querying Solana, sending transactions, managing webhooks, streaming data, wallet analysis, and autonomous account signup.

<CardGroup cols={2}>
  <Card title="60+ Live Tools" icon="bolt">
    DAS API, RPC, transfers, webhooks, streaming, wallet analysis, priority fees, onboarding, and docs
  </Card>

  <Card title="Autonomous Signup" icon="robot">
    Create a Helius account and get an API key entirely within Claude — no browser needed
  </Card>

  <Card title="Real-Time Data" icon="signal-stream">
    Subscribe to Enhanced WebSockets and LaserStream gRPC directly from your AI tool
  </Card>

  <Card title="Any MCP Client" icon="plug">
    Works with Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, and any MCP-compatible tool
  </Card>
</CardGroup>

## What is MCP?

The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open-source standard introduced by Anthropic that allows AI models to securely connect with external data sources, tools, and APIs. It uses a client-server architecture where a host (like Claude) connects to an MCP server, allowing the AI to query databases, call APIs, or execute actions through a universal, standardized interface.

**Why this matters for Helius:** The MCP gives Claude direct access to tools like `getBalance`, `parseTransactions`, and `getAssetsByOwner`. Without it, Claude has to guess at API responses or make numerous curl requests to gain context. The MCP allows Claude to actually interact with Solana through Helius because it has the relevant tooling — live blockchain data, transaction submission, webhook management, and more.

<Note>
  The Helius docs site at [helius.dev/docs](https://www.helius.dev/docs) also exposes a separate MCP server auto-generated by Mintlify. That server is scoped to documentation search only. `helius-mcp` documented here is the comprehensive server covering all Helius and Solana functionality.
</Note>

## Quick Start

<Steps>
  <Step title="Add the MCP server">
    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```
  </Step>

  <Step title="Configure your API key">
    **If you already have a key:**

    ```bash theme={"system"}
    export HELIUS_API_KEY=YOUR_API_KEY
    ```

    Or set it inside Claude by calling the `setHeliusApiKey` tool. 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 via the [Helius CLI](/agents/cli))

    **If you need a new account:** See [Autonomous Signup](#autonomous-signup) below.
  </Step>

  <Step title="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...`"
    * "Send 1 SOL to `7xKp...`"
    * "Create a webhook for this address"
  </Step>
</Steps>

## Connecting to the Helius MCP Server

<Tabs>
  <Tab title="Claude Code">
    Run the following command:

    ```bash theme={"system"}
    claude mcp add helius npx helius-mcp@latest
    ```

    Or add to your project's `.mcp.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Verify with:

    ```bash theme={"system"}
    claude mcp list
    ```

    <Tip>
      Want skills + MCP in one step? Install the [Helius plugin](/agents/claude-code-plugin) instead:

      ```
      /plugin marketplace add helius-labs/core-ai
      /plugin install helius@helius-labs
      ```
    </Tip>
  </Tab>

  <Tab title="Claude Desktop">
    Open **Settings > Developer > Edit Config** and add the server:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Restart Claude Desktop to apply.
  </Tab>

  <Tab title="Cursor">
    Open the command palette (`Cmd/Ctrl + Shift + P`), search for **MCP: Add Server**, and enter:

    * **Name:** `helius`
    * **Command:** `npx helius-mcp@latest`

    Or add to your project's `.cursor/mcp.json`:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="VS Code">
    Create a `.vscode/mcp.json` file in your project root:

    ```json theme={"system"}
    {
      "servers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```

    Requires the [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) extension with MCP support enabled.
  </Tab>

  <Tab title="Windsurf">
    Open the command palette (`Cmd/Ctrl + Shift + P`), search for **Configure MCP Servers**, and add:

    ```json theme={"system"}
    {
      "mcpServers": {
        "helius": {
          "command": "npx",
          "args": ["helius-mcp@latest"]
        }
      }
    }
    ```
  </Tab>

  <Tab title="Codex">
    Run the following command:

    ```bash theme={"system"}
    codex mcp add helius -- npx helius-mcp@latest
    ```

    Or add to your `~/.codex/config.toml` (or `.codex/config.toml` for project-scoped):

    ```toml theme={"system"}
    [mcp_servers.helius]
    command = "npx"
    args = ["helius-mcp@latest"]
    ```

    Verify with:

    ```bash theme={"system"}
    codex mcp list
    ```
  </Tab>
</Tabs>

## Autonomous Signup

Create a Helius account entirely within your AI tool — no browser needed:

<Steps>
  <Step title="Generate a keypair">
    The AI calls the `generateKeypair` tool — it creates a Solana wallet and returns the address.
  </Step>

  <Step title="Fund the wallet">
    Send **\~0.001 SOL** (transaction fees) + **1 USDC** (signup payment) to the wallet address.
  </Step>

  <Step title="Verify balance">
    The AI calls `checkSignupBalance` to confirm funds arrived.
  </Step>

  <Step title="Create account">
    The AI calls `agenticSignup` — processes the USDC payment, creates the Helius account, and configures the API key automatically.
  </Step>
</Steps>

Or do the same from the terminal with the [Helius CLI](/agents/cli):

```bash theme={"system"}
npx helius-cli@latest keygen     # Generate keypair
# Fund the wallet address with ~0.001 SOL + 1 USDC
npx helius-cli@latest signup      # Create account
```

## Tool Catalog

The MCP server exposes 60+ tools across 14 categories — onboarding, DAS API, RPC, transfers, webhooks, WebSockets, LaserStream, wallet analysis, billing, Solana knowledge, and docs.

<Card title="Full Tool Catalog" icon="bolt" href="/agents/mcp/tools">
  All 60+ tools organized by category with descriptions for every tool
</Card>

## Network Configuration

The MCP server defaults to **mainnet-beta**. Switch to devnet via environment variable:

```bash theme={"system"}
export HELIUS_NETWORK=devnet
```

Or call the `setNetwork` tool within a session.

## Skills

Skills are expert instruction sets that teach Claude how to route your requests to the right MCP tools and reference files. They go beyond raw tool access — they include routing logic, correct SDK patterns, and rules that prevent common mistakes.

<Card title="Skills Overview" icon="brain" href="/agents/skills/overview">
  Four skills available: Build (general Solana dev), Phantom (frontend dApps), DFlow (trading apps), and SVM (protocol internals)
</Card>

## Learn More

<CardGroup cols={2}>
  <Card title="Claude Code Plugin" icon="puzzle-piece" href="/agents/claude-code-plugin">
    One-click install of MCP + skills
  </Card>

  <Card title="Helius CLI" icon="terminal" href="/agents/cli">
    Command-line account management
  </Card>

  <Card title="MCP Specification" icon="book" href="https://modelcontextprotocol.io/">
    Learn about the Model Context Protocol standard
  </Card>

  <Card title="helius-mcp on npm" icon="npm" href="https://www.npmjs.com/package/helius-mcp">
    Package details and version history
  </Card>
</CardGroup>