
Helius para agentes
Los agentes de IA necesitan herramientas estructuradas, flujos de trabajo claros y el contexto adecuado para crear aplicaciones listas para producción en Solana.
Sin ellos, los agentes adivinan las llamadas a la API, inventan endpoints, codifican de forma rígida comisiones que deberían ser dinámicas y pasan por alto rutas más rápidas como Helius Sender y LaserStream.
Para resolverlo, lanzamos un conjunto de herramientas para agentes que desarrollan con Helius:
- Servidor MCP de Helius
- Habilidades de Helius
- Helius CLI
- Helius Claude Code Plugin
También optimizamos de forma constante nuestros SDK de TypeScript y Rust, además de nuestra documentación, para facilitar que los agentes autónomos y los asistentes de IA recomienden y usen estas herramientas de manera eficaz.
Esto es lo que hace cada herramienta y cómo funcionan juntas:
El servidor MCP de Helius: 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.
El servidor MCP de Helius expone Helius —y Solana— a cualquier cliente MCP.
Sin MCP, un agente que intenta consultar el saldo de una billetera debe abrir un shell, construir un comando curl, enviarlo, analizar la salida JSON y esperar 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 llamada estructurada a una herramienta 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.
El servidor MCP de Helius ofrece herramientas para:
- Registro autónomo: crear cuentas, obtener claves de API, cambiar de plan, etc.
- Datos de blockchain en vivo: RPC, DAS API, ZK Compression y más
- Transmisión 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: saldos, transferencias, análisis de transacciones, identidad de billeteras y análisis de fondos
- Conocimiento de Solana: SIMD, referencias al código fuente de Agave y Firedancer, contenido del blog de Helius y búsqueda en la documentación oficial de Solana
El servidor MCP funciona en Claude Desktop, Cursor, VS Code y Windsurf.
Instalación rápida
Para agregar el servidor MCP de Helius con Claude Code, ejecuta:
claude mcp add helius npx helius-mcp@latestPara Codex, ejecuta:
codex mcp add helius -- npx helius-mcp@latestPara Cursor, VS Code o herramientas similares, agrégalo a tu configuración de MCP:
{
"mcpServers": {
"helius": {
"command": "npx",
"args": ["helius-mcp@latest"]
}
}
}
Luego configura tu clave de API mediante 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 y llama a signup con tu correo electrónico y nombre. Después, pagas el plan que quieras mediante el enlace de pago (o depositas fondos en el par de claves para activar el pago automático).
Habilidades de Helius: 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 nada de 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 elaborados cuidadosamente con lógica de enrutamiento, archivos de referencia y reglas— que enseñan a un agente a ser un desarrollador experto en Solana.
Cuando se carga una habilidad, el agente sabe que searchAssets es mejor que getProgramAccounts para buscar NFT, que las comisiones de prioridad deben obtenerse dinámicamente mediante getPriorityFeeEstimates y que las transacciones deben pasar por Sender para alcanzar las tasas de inclusión más altas. Las habilidades aportan experiencia especializada a tu agente.
Hoy lanzamos cuatro habilidades principales de Helius:
Build
La habilidad Build está diseñada para el desarrollo esencial 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 (como swaps al contado, mercados de predicción, streaming en tiempo real y Proof KYC) con la infraestructura de Helius para enviar transacciones, optimizar comisiones y monitorear la actividad on-chain.
Phantom
La habilidad Phantom sirve para crear aplicaciones frontend con Phantom Connect SDK. Abarca conexiones de billeteras, acceso mediante 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 Solana. Explora cómo se ejecuta el bytecode sBPF, las consideraciones de diseño de Alpenglow, la economía de los validadores y mucho más mediante contenido en vivo del blog de Helius, los SIMD 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 predefinidas del prompt del sistema para funcionar 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 Cursor Rules, 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 necesitan un comando con barra diagonal:
# 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 inicio.
Helius Claude Code Plugin: el paquete
MCP aporta 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 el MCP de Helius, el MCP de DFlow, las cuatro habilidades y archivos de referencia detallados para cada producto de Helius.
Sin configuración manual de MCP. Sin configuración separada de habilidades.
Con una sola instalación, tu agente obtiene acceso estructurado a la blockchain y conocimiento experto de Solana en una única sesión.
Instalación rápida
Así puedes instalar el plugin de Helius 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 diagonal:
| Habilidad | Comando | Qué hace |
| Build | /helius:build | Desarrollo esencial en Solana con todas las API de Helius |
| Phantom | /helius:phantom | dApps frontend creadas con Phantom Connect SDK y Helius |
| DFlow | /helius:dflow | Aplicaciones de trading creadas con DFlow y Helius |
| SVM | /helius:svm | Conocimiento profundo del protocolo Solana |
La configuración de la clave de API es igual que con el MCP independiente: usa una clave existente, habilita el registro autónomo o utiliza Helius CLI.
Cómo funciona 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 mediante la dirección de su billetera 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY. Comienza con el mes pasado (febrero) y genera un archivo CSV que detalle todos sus eventos gravables. Haz que funcione con cualquier billetera y periodo”.
Claude lo resuelve de una sola vez:
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 seleccionar herramientas manualmente ni usar prompts intermedios. El agente lee los archivos de referencia correctos, invoca las herramientas MCP adecuadas y genera una CLI funcional compatible con cualquier billetera y rango de fechas.
Por supuesto, los agentes pueden crear aplicaciones más complejas, como bots de trading:
En 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 y las operaciones de tokens mediante LaserStream.
También le pedimos que mostrara datos del mercado y ofreciera gráficos básicos para poder hacer operaciones simuladas. Eso fue todo. Claude creó este bot de trading, con streaming y operaciones de tokens en vivo, en menos de 10 minutos.
Esa es la diferencia entre dar herramientas a un agente y darle experiencia especializada.
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 las consultas en Solana, el envío de transacciones, la gestión de webhooks, el streaming en tiempo real, el staking, ZK Compression y mucho más.
Aunque recomendamos MCP para los flujos de trabajo impulsados por IA —las llamadas estructuradas a herramientas son mejores que iniciar instancias de shell y analizar su salida—, la CLI es la opción adecuada para scripts de shell, la creación de pipelines de CI/CD o entornos donde MCP no está disponible. Todos los comandos admiten la opción --json para generar una salida legible por máquinas y devuelven códigos de salida estructurados, lo que permite gestionar 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
# Signup requires a valid email and name
helius signup --email you@example.com --first-name Jane --last-name Doe
# Pay via the printed link with any wallet, then:
helius signup --resume # Finalize and get API key
helius projects # List projects
helius apikeys <project-id> # Get API keysPara usuarios existentes, simplemente:
helius config set-api-key YOUR_API_KEYSDK 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 cubren los patrones recomendados para flujos de trabajo comunes de 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
El SDK de TypeScript de Helius ofrece métodos con seguridad de tipos para cada llamada a la API de Helius. La ventaja clave para los agentes es que los métodos específicos de Helius reducen los flujos de trabajo de Solana con varios pasos a una sola llamada.
Por ejemplo, getTransactionsForAddress sustituye el anticuado patrón estándar de dos pasos —obtener firmas y luego transacciones— por una sola llamada con filtrado del lado del servidor, rangos 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 comisiones de prioridad y la confirmación.
sendTransactionWithSender lleva esto al siguiente nivel, con optimización para enviar transacciones con latencia ultrabaja.
Consulta las prácticas recomendadas de TypeScript para ver 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
El SDK de Rust de Helius ofrece bindings asíncronos de Rust con los mismos métodos de Helius, lo que lo hace 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?;
El SDK de Rust también ofrece variantes de error tipadas (por ejemplo, HeliusError::RateLimitExceeded), para que los agentes puedan hacer coincidencias directamente sobre los errores en lugar de analizar cadenas de texto.
Consulta las prácticas recomendadas de Rust para ver los mismos patrones en Rust (como 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 el servidor MCP de Helius 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 de 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.
Artículos relacionados
Suscríbete a Helius
Mantente al día con las novedades del desarrollo en Solana y recibe actualizaciones cuando publiquemos


