Servidor MCP de Helius

El servidor MCP de Helius brinda a las herramientas de IA acceso directo a las API de Helius mediante 10 herramientas públicas: 9 herramientas de dominio enrutadas que cubren toda la funcionalidad de Helius y Solana, además de expandResult para paginar respuestas grandes.

9 Routed Tools

Herramientas agrupadas por dominio (heliusWallet, heliusAsset, heliusTransaction, …): puedes acceder a todas las acciones de Helius mediante una de ellas

Account Signup

Crea una cuenta de Helius desde tu herramienta de IA: paga mediante un enlace alojado o automáticamente con USDC desde un par de claves local

Real-Time Data

Suscríbete a Enhanced WebSockets y LaserStream gRPC directamente desde tu herramienta de IA

Any MCP Client

Funciona con Claude Code, Claude Desktop, Cursor, VS Code, Windsurf, Codex y cualquier herramienta compatible con MCP

¿Qué es MCP?

El 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 externas, herramientas y API. Usa una arquitectura cliente-servidor en la que un host (como Claude) se conecta a un servidor MCP, lo que permite a la IA consultar bases de datos, llamar a API o ejecutar acciones mediante una interfaz universal y estandarizada. Por qué esto es importante para Helius: MCP brinda a Claude acceso directo a datos en vivo de Solana y a la infraestructura de Helius: saldos, metadatos de activos, transacciones analizadas, administración de webhooks, streaming y mucho más. Sin MCP, Claude debe adivinar las respuestas de la API o realizar solicitudes curl repetidas para obtener contexto. MCP permite que Claude interactúe realmente con Solana mediante Helius usando llamadas estructuradas a herramientas.

El sitio de documentación de Helius en helius.dev/docs también expone otro servidor MCP generado automáticamente por Mintlify. Ese servidor se limita únicamente a la búsqueda en la documentación. helius-mcp, documentado aquí, es el servidor integral que cubre toda la funcionalidad de Helius y Solana.

Inicio rápido

Add the MCP server

claude mcp add helius npx helius-mcp@latest

O agrégalo a la configuración de tu host MCP (Claude Desktop, Cursor, Windsurf, VS Code, etc.):

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

Configure your API key

Si ya tienes una clave:

export HELIUS_API_KEY=YOUR_API_KEY

O configúrala dentro de Claude llamando a la acción setHeliusApiKey en heliusAccount. Las claves de API se resuelven en este orden:

Llamada a la acción setHeliusApiKey dentro de la sesión
Variable de entorno HELIUS_API_KEY
~/.helius/config.json (configurada mediante la CLI de Helius)

Si necesitas una cuenta nueva: Consulta Registro a continuación.

Start using tools

Haz preguntas en lenguaje natural; la herramienta y la acción correctas se seleccionan automáticamente:

“¿Qué NFT posee esta billetera?”
“Analiza esta transacción: 5abc...”
“Obtén el saldo de Gh9ZwEm...”
“Envía 1 SOL a 7xKp...”
“Crea un webhook para esta dirección”

Conectarse al servidor MCP de Helius

Ejecuta el siguiente comando:

claude mcp add helius npx helius-mcp@latest

O agrégalo a .mcp.json en tu proyecto:

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

Verifica con:

claude mcp list

¿Quieres las habilidades y MCP en un solo paso? Instala el plugin de Helius. Ejecuta estos como dos comandos separados:

/plugin marketplace add helius-labs/core-ai

/plugin install helius@helius-labs

Abre Settings > Developer > Edit Config y agrega el servidor:

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

Reinicia Claude Desktop para aplicar los cambios.

Abre la paleta de comandos (Cmd/Ctrl + Shift + P), busca MCP: Add Server e ingresa:

Nombre: helius
Comando: npx helius-mcp@latest

O agrégalo a .cursor/mcp.json en tu proyecto:

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

Crea un archivo .vscode/mcp.json en la raíz de tu proyecto:

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

Requiere la extensión GitHub Copilot con la compatibilidad con MCP habilitada.

Abre la paleta de comandos (Cmd/Ctrl + Shift + P), busca Configure MCP Servers y agrega:

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

Ejecuta el siguiente comando:

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

O agrégalo a tu ~/.codex/config.toml (o .codex/config.toml para limitarlo al proyecto):

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

Verifica con:

codex mcp list

Conjunto de herramientas públicas

MCP de Helius expone 10 herramientas públicas: 9 herramientas de dominio enrutadas más expandResult. Puedes acceder a cada acción de Helius y Solana mediante un argumento action en la herramienta enrutada correspondiente.

Herramienta	Alcance
`heliusAccount`	Configuración de cuentas, autenticación, planes y facturación
`heliusWallet`	Saldos de billeteras, tenencias, historial e identidad
`heliusAsset`	Activos, NFT, colecciones y titulares de tokens
`heliusTransaction`	Análisis de transacciones e historial de transacciones de billeteras
`heliusChain`	Estado de la cadena, cuentas de tokens, bloques, estado de la red y cuentas de programas
`heliusStreaming`	Operaciones CRUD de webhooks y configuración de suscripciones (WebSockets, LaserStream)
`heliusKnowledge`	Documentación, guías, precios, solución de problemas, código fuente, blog y SIMD
`heliusWrite`	Transferencias: SOL y tokens SPL
`heliusCompression`	Pruebas de Merkle para NFT comprimidos
`expandResult`	Expande resultados que priorizan el resumen mediante `resultId`

Full Tool Catalog

Todas las acciones agrupadas por herramienta enrutada, con detalles sobre la estructura de las llamadas y el uso de expandResult

Estructura de las llamadas a herramientas enrutadas

Cada una de las 9 herramientas enrutadas comparte una estructura común:

action: el nombre de la acción de Helius que se ejecutará, como getBalance o createWebhook
parámetros específicos del dominio, por ejemplo, address, signatures o webhookURL
detail opcional: summary, standard o full
campos de telemetría: _feedback, _feedbackTool, _model

Ejemplo de llamada:

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

Respuestas que priorizan el resumen e `expandResult`

Las respuestas pesadas priorizan el resumen. Las herramientas enrutadas devuelven un resumen compacto y un resultId cuando la respuesta completa sería grande o cuando se solicita detail: "summary". Usa expandResult con ese resultId para obtener bajo demanda una sección, intervalo, página o segmento de continuación específicos. Esto mantiene bajo el uso de tokens en las consultas exploratorias y permite que los agentes profundicen en la carga útil completa cuando sea necesario.

Registro

Crea una cuenta de Helius desde tu herramienta de IA mediante un enlace de pago alojado o pagando USDC directamente desde un par de claves local. El flujo de registro usa la herramienta enrutada heliusAccount:

Generate a keypair

La IA llama a heliusAccount con action: "generateKeypair"; esto crea una billetera de Solana y devuelve la dirección.

Create the payment intent

La IA llama a heliusAccount con action: "signup" e mode: "link"; devuelve un paymentUrl (por ejemplo, https://dashboard.helius.dev/pay/<id>) que el usuario abre para pagar con cualquier billetera. También puedes pasar mode: "autopay" para enviar USDC automáticamente desde el par de claves local (la billetera debe contener ~0.001 SOL más el importe del plan en USDC).

Resume after payment

Después de pagar mediante el enlace, la IA llama a heliusAccount con action: "signup" e mode: "resume"; esto consulta periódicamente la intención de pago, finaliza el aprovisionamiento de la cuenta y configura automáticamente la clave de API.

Información de contacto: cada registro nuevo, incluido el plan Agent, requiere email, firstName e lastName. upgradePlan requiere lo mismo.

También puedes hacer lo mismo desde la terminal con la CLI de Helius:

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

Configuración de red

El servidor MCP usa mainnet-beta de forma predeterminada. Cambia a devnet mediante una variable de entorno:

export HELIUS_NETWORK=devnet

También puedes llamar a la acción setNetwork en heliusAccount dentro de una sesión.

Prompts del sistema

El paquete helius-mcp incluye prompts del sistema predefinidos que enseñan a los modelos de IA a usar eficazmente las herramientas de Helius. Se encuentran en 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 uno contiene tres variantes:

openai.developer.md: para la API OpenAI Responses/Chat Completions (mensaje developer)
claude.system.md: para la API de Claude (prompt del sistema)
full.md: autocontenido, con todas las referencias incorporadas (Cursor Rules, ChatGPT, etc.)

Consulta la guía de integración helius-skills/SYSTEM-PROMPTS.md para ver ejemplos de código.

Habilidades

Las habilidades son conjuntos de instrucciones especializadas que enseñan a Claude a dirigir tus solicitudes a las acciones MCP y a los archivos de referencia correctos. Van más allá del acceso básico a herramientas: incluyen lógica de enrutamiento, patrones correctos del SDK y reglas que evitan errores comunes.

Skills Overview

Hay seis habilidades disponibles: Build (desarrollo general de Solana), Phantom (dApps de frontend), Jupiter (DeFi), DFlow (aplicaciones de trading), OKX (trading e inteligencia) y SVM (componentes internos del protocolo)

Más información

Claude Code Plugin

Instalación de MCP y habilidades con un solo clic

Helius CLI

Administración de cuentas desde la línea de comandos

MCP Specification

Obtén información sobre el estándar Model Context Protocol

helius-mcp on npm

Detalles del paquete e historial de versiones

Changelog

Historial de versiones y notas de las versiones

Contribute

Guía para contribuir a helius-mcp

9 Routed Tools

Account Signup

Real-Time Data

Any MCP Client

​¿Qué es MCP?

​Inicio rápido

​Conectarse al servidor MCP de Helius

​Conjunto de herramientas públicas

Full Tool Catalog

​Estructura de las llamadas a herramientas enrutadas

​Respuestas que priorizan el resumen e expandResult

​Registro

​Configuración de red

​Prompts del sistema

​Habilidades

Skills Overview

​Más información

Claude Code Plugin

Helius CLI

MCP Specification

helius-mcp on npm

Changelog

Contribute

¿Qué es MCP?

Inicio rápido

Conectarse al servidor MCP de Helius

Conjunto de herramientas públicas

Estructura de las llamadas a herramientas enrutadas

Respuestas que priorizan el resumen e `expandResult`

Registro

Configuración de red

Prompts del sistema

Habilidades

Más información