Helius para agentes

O Helius MCP Server: as ferramentas

O Model Context Protocol (MCP) é um padrão de código aberto apresentado pela Anthropic para permitir que modelos de IA se conectem com segurança a fontes de dados, ferramentas e APIs externas. Ele substitui integrações personalizadas por uma interface universal e padronizada. 

O Helius MCP Server disponibiliza a Helius — e a Solana — para qualquer cliente MCP.

Sem MCP, um agente que tenta verificar o saldo de uma carteira precisa abrir um shell, criar um comando curl, enviá-lo, analisar a saída JSON e torcer para ter usado o endpoint e os parâmetros corretos.

Multiplique isso por cada chamada de API em um determinado fluxo de trabalho e você terá interações lentas, frágeis e propensas a erros, prejudicadas pela necessidade de iniciar instâncias de shell para cada comando.

Com o MCP, nada disso acontece.

O agente chama getBalance como uma chamada de ferramenta estruturada e recebe uma resposta tipada. Sem shell. Sem curl. Sem analisar a saída — simplesmente funciona.

O mesmo vale para parseTransaction, getAssetsByOwner, createWebhook e todas as outras mais de 60 ferramentas. Agora, os agentes podem usar a Helius diretamente com os parâmetros corretos e receber dados estruturados. 

O Helius MCP Server oferece ferramentas para:

• Cadastro autônomo: criar contas, obter chaves de API, fazer upgrade etc.
• Dados ao vivo da blockchain: RPC, DAS API, ZK Compression e muito mais
• Streaming de dados: WebSockets (padrão e aprimorados), LaserStream gRPC (latência no nível de shred)
• Envio de transações: Priority Fee API, transferências SPL e Sender
• Webhooks: criar, atualizar e excluir notificações orientadas por eventos
• Carteiras e histórico: consultar saldos e transferências, analisar transações, identificar carteiras e realizar análises de financiamento
• Conhecimento sobre a Solana: SIMDs, referências ao código-fonte do Agave e Firedancer, conteúdo do blog da Helius e pesquisa na documentação oficial da Solana

Instalação rápida

Para adicionar o Helius MCP Server com o Claude Code, execute:

claude mcp add helius npx helius-mcp@latest

Para o Codex, execute:

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

Para o Cursor, VS Code ou ferramentas semelhantes, adicione à sua configuração do MCP:

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

Depois, defina sua chave de API usando a ferramenta setHeliusApiKey ou uma variável de ambiente (por exemplo, HELIUS_API_KEY) e comece a criar.

Para novos usuários, seu agente pode criar uma conta de forma autônoma — ele gera um par de chaves, você adiciona fundos e depois chama agenticSignup para comprar o plano desejado a partir de US$ 1. 

Helius Skills: o cérebro

O MCP dá aos agentes acesso a mais de 60 ferramentas. Mas apenas o acesso não basta — um agente com um catálogo de ferramentas é como um desenvolvedor com várias abas de documentação abertas e nenhuma experiência. Ele consegue chamar as ferramentas, mas não sabe qual delas usar, como combiná-las em uma determinada tarefa nem quais erros evitar. 

As skills são o cérebro. Elas são conjuntos de instruções especializadas — prompts cuidadosamente elaborados com lógica de roteamento, arquivos de referência e regras — que ensinam um agente a atuar como um desenvolvedor especialista em Solana.

Quando uma skill é carregada, o agente sabe que searchAssets é melhor que getProgramAccounts para consultas de NFT, que as taxas de prioridade devem ser obtidas dinamicamente por meio de getPriorityFeeEstimates e que as transações devem passar pelo Sender para alcançar as maiores taxas de inclusão. As skills dão ao seu agente conhecimento especializado.

Hoje, estamos lançando quatro Helius Skills principais:

Build

A skill Build é voltada ao desenvolvimento essencial na Solana. Ela direciona o agente às ferramentas certas para DAS, Sender, WebSockets, LaserStream, Webhooks, Enhanced Transactions, análise de carteiras e onboarding. Essa é a skill padrão para criar qualquer coisa na Solana com a Helius. 

DFlow

A skill DFlow serve para criar aplicativos de trading. Ela combina as APIs da DFlow (como swaps spot, mercados de previsão, streaming em tempo real e Proof KYC) com a infraestrutura da Helius para envio de transações, otimização de taxas e monitoramento on-chain. 

Phantom

A skill Phantom serve para criar aplicativos frontend com o Phantom Connect SDK. Ela abrange conexões de carteira, acesso restrito por tokens, cunhagem de NFTs, pagamentos com criptomoedas, exibição de portfólios e arquitetura frontend segura.

SVM

A skill SVM permite que agentes entendam os detalhes internos do protocolo da Solana. Explore como o bytecode sBPF é executado, as considerações de design do Alpenglow, a economia dos validadores e muito mais consultando conteúdo ao vivo no blog da Helius, nos SIMDs e no código-fonte do Agave/Firedancer. Nenhuma chave de API é necessária.

Como as skills funcionam

As skills não dependem de um modelo específico. Cada uma inclui variantes predefinidas de prompts de sistema para funcionar em todas as plataformas, não apenas no Claude.

Use openai.developer.md para a OpenAI API, claude.system.md para a Claude API ou full.md para Cursor Rules, instruções personalizadas do ChatGPT ou qualquer outra ferramenta. Consulte a visão geral das skills para ver a configuração específica de cada plataforma.

As skills são instaladas automaticamente ao usar o Helius Claude Code Plugin. Skills independentes podem ser instaladas como Agent Skills — elas são acionadas automaticamente, sem a necessidade de comandos com barra:

# Clone our AI tooling repo
git clone https://github.com/helius-labs/core-ai.git

# Navigate to helius-skills
cd core-ai/helius-skills

# Install your desired skill
./helius/install.sh            # Build skill → ~/.claude/skills/helius/
./helius-dflow/install.sh      # DFlow skill → ~/.claude/skills/helius-dflow/
./svm/install.sh               # SVM skill   → ~/.claude/skills/svm/

Com essas skills, os agentes podem criar praticamente qualquer aplicativo na Solana — de frontends de trading a aplicativos de mercados de previsão e processadores de pagamentos com stablecoins — usando os padrões corretos desde o início.

O Helius Claude Code Plugin: o pacote completo

O MCP fornece as ferramentas, enquanto as skills são o cérebro. O Helius Claude Code Plugin é o pacote completo — uma única instalação que conecta tudo. Simplesmente funciona.

O plugin reúne o Helius MCP, o DFlow MCP, as quatro skills e arquivos de referência detalhados para cada produto da Helius.

Sem configuração manual do MCP. Sem configuração separada das skills.

Com uma única instalação, seu agente passa a ter acesso estruturado à blockchain e conhecimento especializado sobre a Solana em uma só sessão.

Instalação rápida

Veja como instalar o Helius Plugin pelo marketplace do Claude Code:

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

É só isso. O plugin inicia automaticamente os dois servidores MCP e oferece atualmente quatro comandos com barra:

A configuração da chave de API é igual à do MCP independente: use uma chave existente, habilite o cadastro autônomo ou use a Helius CLI. 

Como isso funciona na prática

Com o plugin instalado, você pode passar de um único prompt a um aplicativo funcional. Por exemplo:

“Crie para mim uma CLI de declaração fiscal para que eu possa consultar as atividades on-chain do Toly usando o endereço de carteira 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Comece pelo mês passado (fevereiro) e gere um arquivo CSV com todos os eventos tributáveis dele. Desenvolva-a para funcionar com qualquer carteira e período.”

O Claude faz tudo com um único prompt:   

A skill /helius:build entra em ação e sugere corretamente getTransactionsByAddress com paginação e filtragem por timestamp para retornar um histórico de transações totalmente analisado com base nas atividades recentes do Toly.

Sem seleção manual de ferramentas nem prompts intermediários. O agente lê os arquivos de referência corretos, aciona as ferramentas MCP corretas e gera uma CLI funcional compatível com qualquer carteira e intervalo de datas.

É claro que os agentes podem criar aplicativos mais complexos, como bots de trading:

Neste exemplo, instalamos o Helius Claude Code Plugin e pedimos ao Claude que criasse um bot de trading para acompanhar tokens da PumpFun em tempo real, transmitindo criações e negociações de tokens via LaserStream.

Também pedimos que ele exibisse dados de mercado e fornecesse gráficos básicos para que pudéssemos fazer operações simuladas. Só isso. O Claude criou este bot de trading, incluindo streaming e negociação de tokens ao vivo, em menos de 10 minutos.

Essa é a diferença entre dar ferramentas a um agente e dar conhecimento especializado a ele.

A Helius CLI

A Helius CLI é uma interface de linha de comando completa, com mais de 95 comandos CLI que abrangem desde o gerenciamento de contas até consultas à Solana, envio de transações, gerenciamento de webhooks, streaming em tempo real, staking, ZK Compression e muito mais.

Embora recomendemos o MCP para fluxos de trabalho orientados por IA — chamadas estruturadas de ferramentas são melhores do que iniciar instâncias de shell e analisar a saída —, a CLI é a escolha certa para scripts de shell, criação de pipelines de CI/CD ou ambientes em que o MCP não está disponível. Todos os comandos são compatíveis com a opção --json para gerar uma saída legível por máquinas e retornam códigos de saída estruturados, permitindo que as automações tratem erros de forma programática.

Instalação rápida

Para novos usuários, o fluxo é simples:

# Install the CLI
npm install -g helius-cli
helius keygen                    # Generate keypair

# Fund wallet with ~0.001 SOL + 1 USDC
helius signup --json             # Create account, get API key
helius projects                  # List projects
helius apikeys <project-id>      # Get API keys

Para usuários existentes, basta executar:

helius config set-api-key YOUR_API_KEY

SDKs otimizados para agentes

Para agentes que criam aplicativos de forma programática, publicamos uma documentação otimizada para agentes sobre nossos SDKs de TypeScript e Rust.

Essas páginas abordam padrões recomendados para fluxos de trabalho comuns de agentes, incluindo envio de transações via Sender, processamento em lotes, dados em tempo real, paginação e tratamento de erros. 

SDK de TypeScript

O SDK de TypeScript da Helius oferece métodos com segurança de tipos para cada chamada de API da Helius. O principal ponto para os agentes é que os métodos específicos da Helius condensam fluxos de trabalho da Solana com várias etapas em chamadas únicas. 

Por exemplo, getTransactionsForAddress substitui o padrão convencional ultrapassado de duas etapas, que primeiro busca assinaturas e depois busca transações, por uma única chamada com filtragem no servidor, intervalos de tempo e suporte a contas de tokens: 

import { createHelius } from "helius-sdk";

const helius = createHelius({ apiKey: "YOUR_API_KEY" });

// Single call: full transaction history with token activity
const txs = await helius.getTransactionsForAddress([
  "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY",
  {
    transactionDetails: "full",
    limit: 100,
    filters: { tokenAccounts: "balanceChanged" },
  },
]);

Da mesma forma, sendSmartTransaction cuida automaticamente da simulação, da estimativa de unidades de computação, das taxas de prioridade e da confirmação.

sendTransactionWithSender leva isso a outro patamar, com otimização para o envio de transações com latência ultrabaixa.

Consulte as práticas recomendadas para TypeScript para saber mais sobre processamento em lotes, paginação, dados em tempo real via webhook e WebSockets, consulta incremental de contas, tratamento de erros e armadilhas comuns que os agentes devem evitar. 

SDK de Rust

O SDK de Rust da Helius fornece bindings assíncronos para Rust com os mesmos métodos da Helius, sendo ideal para fluxos de trabalho agênticos de alto desempenho:

use helius::Helius;
use helius::types::*;

let helius = Helius::new("YOUR_API_KEY", Cluster::MainnetBeta)?;

// Same single-call pattern as TypeScript
let txs = helius.rpc().get_transactions_for_address(
    "86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY".to_string(),
    GetTransactionsForAddressOptions {
        transaction_details: Some(TransactionDetails::Full),
        limit: Some(100),
        filters: Some(GetTransactionsFilters {
            token_accounts: Some(TokenAccountsFilter::BalanceChanged),
            ..Default::default()
        }),
        ..Default::default()
    },
).await?;

O SDK de Rust também fornece variantes de erros tipadas (por exemplo, HeliusError::RateLimitExceeded), permitindo que os agentes correspondam diretamente aos erros em vez de analisar strings.

Consulte as práticas recomendadas para Rust para conhecer os mesmos padrões em Rust (como processamento em lotes, paginação, Sender, estratégias de repetição e armadilhas comuns). 

Comece agora

A Helius oferece aos agentes o conjunto de ferramentas mais completo para criar aplicativos prontos para produção na Solana. Veja como começar:

• Caminho mais rápido: instale o Claude Code Plugin 
• Qualquer cliente MCP: adicione o Helius MCP Server ao Claude Desktop, Cursor, VS Code, Codex ou Windsurf
• Automação via shell: instale a Helius CLI para scripts e CI/CD
• Integração com API: adicione um prompt de sistema de uma skill à OpenAI API, Claude API ou ao ChatGPT

Leia nossa documentação, explore o repositório no GitHub, proponha uma integração de skill e entre em contato com nossa equipe de suporte se tiver alguma dúvida.