Servidor Helius MCP - Helius Docs

O servidor Helius MCP oferece às ferramentas de IA acesso direto às APIs do Helius por meio de 10 ferramentas públicas — 9 ferramentas de domínio roteado que cobrem toda a funcionalidade do Helius e Solana, além de expandResult para paginação de grandes respostas.

9 Ferramentas Roteadas

Ferramentas agrupadas por domínio (heliusWallet, heliusAsset, heliusTransaction, …) — cada ação do Helius é acessível através de uma delas.

Cadastro de Conta

Crie uma conta Helius a partir da sua ferramenta de IA — pague via link hospedado ou autopagamento USDC de um par de chaves local.

Dados em Tempo Real

Assine Enhanced WebSockets e LaserStream gRPC diretamente da sua ferramenta de IA.

Qualquer Cliente MCP

Funciona com Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex e qualquer ferramenta compatível com MCP.

O que é MCP?

O Protocolo de Contexto do Modelo (MCP) é um padrão de código aberto introduzido pela Anthropic que permite que modelos de IA se conectem de forma segura a fontes de dados externas, ferramentas e APIs. Ele utiliza uma arquitetura cliente-servidor onde um host (como Claude) se conecta a um servidor MCP, permitindo que a IA consulte bancos de dados, chame APIs ou execute ações por meio de uma interface universal e padronizada. Por que isso é importante para o Helius: O MCP dá ao Claude acesso direto a dados ao vivo do Solana e infraestrutura do Helius — saldos, metadados de ativos, transações analisadas, gerenciamento de webhooks, streaming e mais. Sem ele, Claude teria que adivinhar as respostas da API ou fazer solicitações curl repetidas para obter contexto. O MCP permite que Claude interaja realmente com Solana através do Helius usando chamadas de ferramenta estruturadas.

O site de documentação do Helius em helius.dev/docs também expõe um servidor MCP separado gerado automaticamente pela Mintlify. Esse servidor é limitado apenas à pesquisa de documentação. helius-mcp documentado aqui é o servidor abrangente que cobre toda a funcionalidade do Helius e Solana.

Início Rápido

Adicionar o servidor MCP

claude mcp add helius npx helius-mcp@latest

Ou adicione à configuração do host MCP (Claude Desktop, Cursor, Windsurf, VS Code, etc.):

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

Configure sua chave de API

Se você já tem uma chave:

export HELIUS_API_KEY=YOUR_API_KEY

Ou defina dentro do Claude chamando a ação setHeliusApiKey em heliusAccount. As chaves de API são resolvidas nesta ordem:

Chamada de ação setHeliusApiKey dentro da sessão
Variável de ambiente HELIUS_API_KEY
~/.helius/config.json (definida via Helius CLI)

Se você precisa de uma nova conta: Veja Cadastro abaixo.

Comece a usar as ferramentas

Faça perguntas em inglês simples — a ferramenta e a ação corretas são selecionadas automaticamente:

“Quais NFTs essa carteira possui?”
“Analise esta transação: 5abc...”
“Obtenha o saldo de Gh9ZwEm...”
“Envie 1 SOL para 7xKp...”
“Crie um webhook para este endereço”

Conectando ao Servidor Helius MCP

Execute o seguinte comando:

claude mcp add helius npx helius-mcp@latest

Ou adicione ao .mcp.json do seu projeto:

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

Verifique com:

claude mcp list

Quer habilidades + MCP em um passo? Instale o plugin Helius em vez disso:

claude plugin install helius @claude-plugins-official

Ou no marketplace do Helius:

/plugin marketplace add helius-labs/core-ai
/plugin install helius@helius-labs

Abra Configurações > Desenvolvedor > Editar Configuração e adicione o servidor:

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

Reinicie o Claude Desktop para aplicar.

Abra o palete de comandos (Cmd/Ctrl + Shift + P), procure por MCP: Add Server, e insira:

Nome: helius
Comando: npx helius-mcp@latest

Ou adicione ao .cursor/mcp.json do seu projeto:

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

Crie um arquivo .vscode/mcp.json na raiz do seu projeto:

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

Requer a extensão GitHub Copilot com suporte MCP habilitado.

Abra o palete de comandos (Cmd/Ctrl + Shift + P), procure por Configure MCP Servers, e adicione:

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

Execute o seguinte comando:

codex mcp add helius -- npx helius-mcp@latest

Ou adicione ao seu ~/.codex/config.toml (ou .codex/config.toml para âmbito do projeto):

[mcp_servers.helius]
command = "npx"
args = ["helius-mcp@latest"]

Verifique com:

codex mcp list

Superfície de Ferramenta Pública

O Helius MCP expõe 10 ferramentas públicas: 9 ferramentas de domínio roteado mais expandResult. Cada ação do Helius e Solana é acessível como um argumento action na ferramenta roteada apropriada.

Ferramenta	Escopo
`heliusAccount`	Configuração de conta, autenticação, planos, faturamento
`heliusWallet`	Saldos de carteira, participações, histórico, identidade
`heliusAsset`	Ativos, NFTs, coleções, detentores de tokens
`heliusTransaction`	Análise de transações e histórico de transações de carteira
`heliusChain`	Estado da cadeia, contas de token, blocos, status da rede, contas de programas
`heliusStreaming`	CRUD de webhook e configuração de assinaturas (WebSockets, LaserStream)
`heliusKnowledge`	Documentos, guias, preços, resolução de problemas, fonte, blog, SIMDs
`heliusWrite`	Transferências — tokens SOL e SPL
`heliusCompression`	Provas Merkle para NFTs comprimidos
`expandResult`	Expanda saídas resumo-primeiro por `resultId`

Catálogo Completo de Ferramentas

Cada ação agrupada por ferramenta roteada, com detalhes de formato de chamada e uso de expandResult

Formato de chamada da ferramenta roteada

Cada uma das 9 ferramentas roteadas compartilha um formato comum:

action — o nome da ação do Helius a executar, como getBalance ou createWebhook
parâmetros específicos do domínio — por exemplo address, signatures, ou webhookURL
opcional detail — summary, standard, ou full
campos de telemetria — _feedback, _feedbackTool, _model

Exemplo de chamada:

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

Respostas resumo-primeiro e `expandResult`

Respostas pesadas são resumo-primeiro. Ferramentas roteadas retornam um resumo compacto mais um resultId quando a resposta completa seria grande ou quando detail: "summary" é solicitado. Use expandResult com esse resultId para buscar uma seção específica, intervalo, página ou fragmento de continuação sob demanda. Isso mantém o uso de tokens baixo para consultas exploratórias, mas ainda permite que os agentes explorem o payload completo quando necessário.

Cadastro

Crie uma conta Helius a partir da sua ferramenta de IA através de um link de pagamento hospedado ou pagando USDC diretamente de um par de chaves local. O fluxo de cadastro acontece através da ferramenta roteada heliusAccount:

Gerar um par de chaves

A IA chama heliusAccount com action: "generateKeypair" — ele cria uma carteira Solana e retorna o endereço.

Crie a intenção de pagamento

A IA chama heliusAccount com action: "signup" e mode: "link" — retorna um paymentUrl (por exemplo, https://dashboard.helius.dev/pay/<id>) que o usuário abre para pagar com qualquer carteira. Ou passe mode: "autopay" para enviar USDC do par de chaves local automaticamente (a carteira deve conter ~0.001 SOL + o valor do plano em USDC).

Retome após o pagamento

Após pagar via link, a IA chama heliusAccount com action: "signup" e mode: "resume" — verifica a intenção de pagamento, finaliza o provisionamento da conta e configura a chave de API automaticamente.

Informações de contato: cada novo cadastro — incluindo o plano Agent — requer email, firstName e lastName. upgradePlan requer o mesmo.

Ou faça o mesmo a partir do terminal com o Helius CLI:

npx helius-cli@latest keygen
npx helius-cli@latest signup --plan agent --email you@example.com --first-name Jane --last-name Doe   # Print hosted payment link
# (pay in browser, then:)
npx helius-cli@latest signup --resume         # Finalize account
# Or autopay from the local keypair:
npx helius-cli@latest signup --plan agent --pay --email you@example.com --first-name Jane --last-name Doe

Configuração de Rede

O servidor MCP é padrão para mainnet-beta. Mude para devnet via variável de ambiente:

export HELIUS_NETWORK=devnet

Ou chame a ação setNetwork em heliusAccount dentro de uma sessão.

Prompts do Sistema

O pacote helius-mcp vem com prompts de sistema pré-construídos que ensinam os modelos de IA a usar as ferramentas Helius de forma eficaz. Eles estão em system-prompts/:

system-prompts/
├── helius/              # Core Helius skill
├── helius-phantom/      # Phantom frontend skill
├── helius-jupiter/      # Jupiter DeFi skill
├── helius-dflow/        # DFlow trading skill
├── helius-okx/          # OKX trading & intelligence skill
└── svm/                 # SVM architecture skill

Cada um contém três variantes:

openai.developer.md — para OpenAI Responses/Chat Completions API (mensagem developer)
claude.system.md — para Claude API (prompt de sistema)
full.md — autossuficiente com todas as referências incorporadas (Cursor Rules, ChatGPT, etc.)

Consulte o guia de integração helius-skills/SYSTEM-PROMPTS.md para exemplos de código.

Habilidades

Habilidades são conjuntos de instruções especializadas que ensinam o Claude a direcionar suas solicitações para as ações MCP certas e arquivos de referência. Elas vão além do acesso bruto às ferramentas — incluem lógica de roteamento, padrões corretos de SDK e regras que evitam erros comuns.

Visão Geral das Habilidades

Seis habilidades disponíveis: Build (desenvolvimento geral Solana), Phantom (dApps frontend), Jupiter (DeFi), DFlow (aplicativos de negociação), OKX (negociação e inteligência) e SVM (internals de protocolo)

Saiba Mais

Plugin Claude Code

Instalação com um clique de MCP + habilidades

Helius CLI

Gerenciamento de contas via linha de comando

Especificação MCP

Saiba mais sobre o padrão Model Context Protocol

helius-mcp no npm

Detalhes do pacote e histórico de versões

Changelog

Histórico de versões e notas de lançamento

Contribuir

Guia de contribuição para helius-mcp

9 Ferramentas Roteadas

Cadastro de Conta

Dados em Tempo Real

Qualquer Cliente MCP

​O que é MCP?

​Início Rápido

​Conectando ao Servidor Helius MCP

​Superfície de Ferramenta Pública

Catálogo Completo de Ferramentas

​Formato de chamada da ferramenta roteada

​Respostas resumo-primeiro e expandResult

​Cadastro

​Configuração de Rede

​Prompts do Sistema

​Habilidades

Visão Geral das Habilidades

​Saiba Mais

Plugin Claude Code

Helius CLI

Especificação MCP

helius-mcp no npm

Changelog

Contribuir

O que é MCP?

Início Rápido

Conectando ao Servidor Helius MCP

Superfície de Ferramenta Pública

Formato de chamada da ferramenta roteada

Respostas resumo-primeiro e `expandResult`

Cadastro

Configuração de Rede

Prompts do Sistema

Habilidades

Saiba Mais