Helius para agentes

Helius MCP Server: las herramientas

Model Context Protocol (MCP) es un estándar de código abierto presentado por Anthropic que permite a los modelos de IA conectarse de forma segura con fuentes de datos, herramientas y API externas. Sustituye las integraciones personalizadas por una interfaz universal y estandarizada. 

Helius MCP Server expone Helius —y Solana— a cualquier cliente MCP.

Sin MCP, un agente que intenta consultar el saldo de una billetera debe abrir una shell, crear un comando curl, enviarlo, analizar la salida JSON y confiar en haber usado el endpoint y los parámetros correctos.

Multiplica eso por cada llamada a la API de un flujo de trabajo y obtendrás interacciones lentas, frágiles y propensas a errores, atascadas por la necesidad de iniciar instancias de shell para cada comando.

Con MCP, nada de eso ocurre.

El agente llama a getBalance como una herramienta estructurada y recibe una respuesta tipada. Sin shell. Sin curl. Sin analizar la salida: simplemente funciona.

Lo mismo se aplica a parseTransaction, getAssetsByOwner, createWebhook y las más de 60 herramientas restantes. Ahora los agentes pueden usar Helius directamente con los parámetros correctos y recibir datos estructurados. 

Helius MCP Server ofrece herramientas para:

• Registro autónomo: crear cuentas, obtener claves de API, actualizar el plan, etc.
• Datos de blockchain en vivo: RPC, DAS API, ZK Compression y más
• Streaming de datos:  WebSockets (estándar y mejorados), LaserStream gRPC (latencia a nivel de shred)
• Envío de transacciones: Priority Fee API, transferencias SPL y Sender
• Webhooks: crear, actualizar y eliminar notificaciones basadas en eventos
• Billeteras e historial: consultar saldos y transferencias, analizar transacciones, identificar billeteras y realizar análisis de fondos
• Conocimiento de Solana: SIMDs, referencias al código fuente de Agave y Firedancer, contenido del blog de Helius y búsqueda en la documentación oficial de Solana

Instalación rápida

Para agregar Helius MCP Server con Claude Code, ejecuta:

claude mcp add helius npx helius-mcp@latest

Para Codex, ejecuta:

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

Para Cursor, VS Code o herramientas similares, agrega lo siguiente a tu configuración de MCP:

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

Luego configura tu clave de API con la herramienta setHeliusApiKey o una variable de entorno (por ejemplo, HELIUS_API_KEY) y comienza a publicar.

Si eres un usuario nuevo, tu agente puede crear una cuenta por ti de forma autónoma: genera un par de claves, tú agregas fondos y después llamas a agenticSignup para comprar el plan que quieras desde $1. 

Helius Skills: el cerebro

MCP da a los agentes acceso a más de 60 herramientas. Sin embargo, el acceso por sí solo no basta: un agente con un catálogo de herramientas es como un desarrollador con varias pestañas de documentación abiertas y sin experiencia. Puede llamar a las herramientas, pero no sabe cuál elegir, cómo combinarlas para una tarea específica ni qué errores evitar. 

Las habilidades son el cerebro. Son conjuntos de instrucciones especializadas —prompts cuidadosamente diseñados con lógica de enrutamiento, archivos de referencia y reglas— que enseñan a un agente a convertirse en un desarrollador experto de Solana.

Cuando se carga una habilidad, el agente sabe que searchAssets es mejor que getProgramAccounts para buscar NFT, que las tarifas de prioridad deben obtenerse de forma dinámica mediante getPriorityFeeEstimates y que las transacciones deben pasar por Sender para maximizar la tasa de inclusión. Las habilidades aportan a tu agente experiencia en el dominio.

Hoy lanzamos cuatro Helius Skills principales:

Build

La habilidad Build está diseñada para el desarrollo principal en Solana. Dirige a las herramientas adecuadas para DAS, Sender, WebSockets, LaserStream, Webhooks, Enhanced Transactions, análisis de billeteras e incorporación. Es la habilidad predeterminada para crear cualquier cosa en Solana con Helius. 

DFlow

La habilidad DFlow sirve para crear aplicaciones de trading. Combina las API de DFlow (es decir, swaps al contado, mercados de predicción, streaming en tiempo real y Proof KYC) con la infraestructura de Helius para enviar transacciones, optimizar tarifas y monitorear operaciones on-chain. 

Phantom

La habilidad Phantom sirve para crear aplicaciones frontend con Phantom Connect SDK. Incluye conexiones de billeteras, acceso con tokens, acuñación de NFT, pagos con criptomonedas, visualización de portafolios y arquitectura frontend segura.

SVM

La habilidad SVM permite que los agentes comprendan el funcionamiento interno del protocolo de Solana. Explora cómo se ejecuta el bytecode sBPF, las consideraciones de diseño de Alpenglow, la economía de los validadores y más mediante contenido en vivo del blog de Helius, SIMDs y el código fuente de Agave/Firedancer. No requiere una clave de API.

Cómo funcionan las habilidades

Las habilidades son independientes del modelo. Cada una incluye variantes de prompts del sistema listas para usar en todas las plataformas, no solo en Claude.

Usa openai.developer.md para la API de OpenAI, claude.system.md para la API de Claude o full.md para las reglas de Cursor, las instrucciones personalizadas de ChatGPT o cualquier otra herramienta. Consulta la descripción general de las habilidades para ver la configuración específica de cada plataforma.

Las habilidades se instalan automáticamente cuando usas Helius Claude Code Plugin. Las habilidades independientes pueden instalarse como Agent Skills: se invocan automáticamente y no requieren un comando con 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/

Con estas habilidades, los agentes pueden crear prácticamente cualquier aplicación de Solana —desde frontends de trading y aplicaciones de mercados de predicción hasta procesadores de pagos con stablecoins— con los patrones correctos desde el principio.

Helius Claude Code Plugin: el paquete

MCP proporciona las herramientas y las habilidades son el cerebro. Helius Claude Code Plugin es el paquete: una sola instalación que conecta todo. Simplemente funciona.

El plugin incluye Helius MCP, DFlow MCP, las cuatro habilidades y archivos de referencia detallados para cada producto de Helius.

Sin configuración manual de MCP. Sin configurar las habilidades por separado.

Con una sola instalación, tu agente obtiene acceso estructurado a la blockchain y conocimiento experto de Solana en una misma sesión.

Instalación rápida

Así puedes instalar Helius Plugin desde el marketplace de Claude Code:

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

Eso es todo. El plugin inicia automáticamente ambos servidores MCP y actualmente te ofrece cuatro comandos con barra:

La configuración de la clave de API es la misma que con MCP independiente: usa una clave existente, habilita el registro autónomo o usa Helius CLI. 

Cómo se ve en la práctica

Con el plugin instalado, puedes pasar de un solo prompt a una aplicación funcional. Por ejemplo:

“Crea una CLI de informes fiscales para que pueda obtener la actividad on-chain de Toly usando la dirección de su billetera 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Comienza con el mes pasado (febrero) y genera un archivo CSV que detalle todos sus eventos gravables. Créala para que funcione con cualquier billetera y periodo”.

Claude lo resuelve en un solo intento:   

La habilidad /helius:build entra en acción y sugiere correctamente getTransactionsByAddress con paginación y filtrado por marca de tiempo para devolver un historial de transacciones completamente analizado a partir de la actividad reciente de Toly.

Sin selección manual de herramientas ni prompts intermedios. El agente lee los archivos de referencia correctos, invoca las herramientas MCP adecuadas y produce una CLI funcional que admite cualquier billetera e intervalo de fechas.

Por supuesto, los agentes pueden crear aplicaciones más complejas, como bots de trading:

Para este ejemplo, instalamos Helius Claude Code Plugin y pedimos a Claude que creara un bot de trading que rastreara tokens de PumpFun en tiempo real y transmitiera la creación de tokens y las operaciones mediante LaserStream.

También le pedimos que mostrara datos del mercado y ofreciera gráficos básicos para poder realizar operaciones simuladas. Eso fue todo. Claude creó este bot de trading, con streaming y trading de tokens en vivo, en menos de 10 minutos.

Esa es la diferencia entre dar herramientas a un agente y darle experiencia.

Helius CLI

Helius CLI es una interfaz de línea de comandos completa con más de 95 comandos de CLI que abarcan desde la administración de cuentas hasta consultas en Solana, envío de transacciones, gestión de webhooks, streaming en tiempo real, staking, ZK Compression y más.

Aunque recomendamos MCP para flujos de trabajo impulsados por IA —las llamadas estructuradas a herramientas son mejores que iniciar instancias de shell y analizar la salida—, CLI es la opción adecuada para scripts de shell, creación de pipelines de CI/CD o entornos donde MCP no está disponible. Todos los comandos admiten la opción --json para obtener una salida legible por máquinas y devuelven códigos de salida estructurados, lo que permite que las automatizaciones gestionen errores mediante programación.

Instalación rápida

Para usuarios nuevos, el proceso es sencillo:

# 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 usuarios existentes, simplemente ejecuta:

helius config set-api-key YOUR_API_KEY

SDK optimizados para agentes

Para los agentes que crean aplicaciones mediante programación, publicamos documentación optimizada para agentes sobre nuestros SDK de TypeScript y Rust.

Estas páginas explican los patrones recomendados para flujos de trabajo habituales de los agentes, como el envío de transacciones mediante Sender, el procesamiento por lotes, los datos en tiempo real, la paginación y la gestión de errores. 

SDK de TypeScript

Helius TypeScript SDK ofrece métodos con seguridad de tipos para cada llamada a la API de Helius. La clave para los agentes es que los métodos específicos de Helius convierten los flujos de trabajo de Solana con varios pasos en llamadas únicas. 

Por ejemplo, getTransactionsForAddress sustituye el patrón estándar y obsoleto de dos pasos —obtener las firmas y después las transacciones— por una sola llamada con filtrado del lado del servidor, intervalos de tiempo y compatibilidad con cuentas 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" },
  },
]);

De manera similar, sendSmartTransaction gestiona automáticamente la simulación, la estimación de unidades de cómputo, las tarifas de prioridad y la confirmación.

sendTransactionWithSender lleva esto al siguiente nivel y está optimizado para enviar transacciones con latencia ultrabaja.

Consulta las prácticas recomendadas de TypeScript para conocer el procesamiento por lotes, la paginación, los datos en tiempo real mediante webhook y WebSockets, la obtención incremental de cuentas, la gestión de errores y los errores comunes que los agentes deben evitar. 

SDK de Rust

Helius Rust SDK ofrece bindings asíncronos de Rust con los mismos métodos de Helius, por lo que es ideal para flujos de trabajo de agentes de alto rendimiento:

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?;

Rust SDK también proporciona variantes de errores tipadas (por ejemplo, HeliusError::RateLimitExceeded), para que los agentes puedan comparar los errores directamente en lugar de analizar cadenas de texto.

Consulta las prácticas recomendadas de Rust para ver los mismos patrones en Rust (es decir, procesamiento por lotes, paginación, Sender, estrategias de reintento y errores comunes). 

Comienza ahora

Helius ofrece a los agentes el conjunto de herramientas más completo para crear aplicaciones listas para producción en Solana. Así puedes comenzar:

• Ruta más rápida: instala Claude Code Plugin 
• Cualquier cliente MCP: agrega Helius MCP Server a Claude Desktop, Cursor, VS Code, Codex o Windsurf
• Automatización con shell: instala Helius CLI para scripts y CI/CD
• Integración de API: agrega un prompt del sistema de una habilidad a la API de OpenAI, la API de Claude o ChatGPT

Lee nuestra documentación, explora el repositorio de GitHub, propón una integración de habilidades y contacta a nuestro equipo de soporte si tienes alguna pregunta.