Gainium

Gestiona tus bots de trading de criptomonedas, operaciones y backtests desde tu asistente de IA.

Ver en gainium.ioPrueba este MCPPatrocinado

Documentación

TL;DR

Gainium MCP permite que aplicaciones de IA se conecten a tu cuenta de Gainium. El conector que aparece en los directorios de aplicaciones es de solo lectura (ver bots, operaciones, el screener, backtests y presets seleccionados); añade el conector personalizado (mcp.gainium.io/mcp) para lectura + escritura. Conéctate con un inicio de sesión OAuth de un clic — sin necesidad de copiar una clave API. Consulta las guías específicas por aplicación a continuación para la configuración.

Gainium MCP permite que aplicaciones de IA — Claude, ChatGPT, Perplexity y otros clientes compatibles con MCP — se conecten a tu cuenta de Gainium. Pueden leer tus bots, operaciones, saldos, exchanges, backtests, el screener de criptomonedas y presets de estrategias seleccionadas. Con el conector de lectura + escritura, también pueden crear y gestionar bots y operaciones.

Esta es la guía general. Para una configuración paso a paso, salta a tu aplicación a continuación.

También puedes seguir este video tutorial:

Cargando vista previa...

Configuración en tu aplicación de IA#

Elige tu aplicación para instrucciones paso a paso:

Aplicación	Guía de configuración
Claude — claude.ai, Desktop y Code	Conectar Gainium a Claude →
ChatGPT	Conectar Gainium a ChatGPT →
Perplexity	Conectar Gainium a Perplexity →

¿Usas otro cliente MCP (VS Code, Cursor o uno propio)? Las URLs del conector y ejemplos de configuración están en Avanzado: ejecuta tu propio servidor o usa otro cliente, más abajo.

Los dos conectores: solo lectura vs lectura + escritura#

Gainium ofrece dos conectores. Elige según si tu IA solo debe leer tu cuenta o también gestionarla:

	Solo lectura	Lectura + escritura
URL del conector	`https://mcp.gainium.io/read`	`https://mcp.gainium.io/mcp`
Cómo lo añades	Aparece en los directorios de conectores de las aplicaciones de IA — elige Gainium	Añádelo como conector personalizado mediante URL
Qué puede hacer la IA	Ver bots, operaciones, saldos, exchanges, el screener, backtests y presets seleccionados	Todo lo de solo lectura, más crear / iniciar / detener / modificar bots y operaciones
Ideal para	Monitoreo, análisis y screening	Gestión de bots y trading automatizado

El conector que aparece en los directorios de aplicaciones de IA es de solo lectura. No realiza operaciones ni mueve fondos. El trading (lectura + escritura) es un conector separado que añades manualmente mediante URL — no es el que aparece en el directorio.

Antes de empezar#

Una cuenta de Gainium con 2FA activado
La aplicación de IA que quieres conectar (Claude, ChatGPT, Perplexity u otro cliente MCP)

Solo necesitas una clave API de Gainium si alojas el servidor MCP tú mismo (ver Avanzado). Para los conectores del directorio y alojados, autorizas con un inicio de sesión de un clic — sin necesidad de copiar una clave API.

Cómo funciona la conexión#

Cuando añades Gainium desde el directorio de conectores de una aplicación o mediante una URL de conector alojado, la aplicación autoriza con un inicio de sesión seguro de un clic (OAuth):

Inicias sesión en Gainium (con 2FA) y apruebas el acceso.
La aplicación obtiene su propia conexión dedicada, con alcance limitado y revocable. Gainium crea la clave subyacente automáticamente — es independiente de cualquier clave API que crees manualmente y no aparecerá en tu lista de Claves API.
En el conector de lectura + escritura, la pantalla de consentimiento te permite elegir acceso de lectura o trading (escritura), y opcionalmente solo paper-trading o una restricción de bot único. El conector de solo lectura otorga acceso de visualización únicamente.

Gestiona o revoca cualquier conexión en cualquier momento en Gainium → Configuración → Aplicaciones conectadas. Revocar elimina inmediatamente la clave de acceso de esa conexión.

Connected apps page in Settings with a Revoke control on each authorized app

Página de aplicaciones conectadas en Configuración con un control de Revocar en cada aplicación autorizada

Qué puede hacer tu IA#

Lectura (ambos conectores): listar e inspeccionar bots DCA, Combo y Grid y sus operaciones; consultar saldos y exchanges conectados; ejecutar el screener de criptomonedas; revisar backtests; y explorar presets de estrategias seleccionados y probados con backtests.

Escritura (solo conector de lectura + escritura): crear, clonar, iniciar, detener, archivar y modificar bots; abrir, ajustar y cerrar operaciones; añadir o reducir fondos de operaciones; establecer take-profit y stop-loss.

El backtesting a través de MCP usa créditos consumibles#

Cuando tu IA ejecuta un backtest a través de MCP, se ejecuta en los servidores de Gainium (un backtest del lado del servidor), no en tu navegador. Cada ejecución usa créditos consumibles:

Pide a tu IA que estime el costo primero. La estimación es gratuita, y el backtest solo comienza si tienes suficientes créditos.
El plan gratuito incluye 0 créditos consumibles, por lo que los backtests de MCP requieren un plan de pago (cada uno incluye una asignación mensual) o créditos que compres por separado. Consulta Precios.
Si no tienes suficientes créditos, el backtest es rechazado y nunca se ejecuta, y tu IA recibe un error de "Créditos insuficientes". Si tu IA dice que ejecutó un backtest pero no aparece ningún resultado en tu cuenta, esta es la razón más probable.
Backtesting ilimitado en el cliente (incluido en todos los planes, también en el gratuito) significa backtests que ejecutas tú mismo en la aplicación de Gainium, que se calculan en tu navegador. MCP no puede ejecutar esos.

Seguridad: paper trading y restricciones#

Usa por defecto el conector de solo lectura a menos que tu IA necesite colocar o modificar operaciones.
En el conector de lectura + escritura, mantén solo paper trading activado mientras pruebas, o pasa paperContext: true en cada solicitud.
Puedes restringir una conexión a un bot único en la pantalla de consentimiento (o con una restricción de clave API / variable de entorno de autoalojamiento).

Consulta Paper Trading (Pruebas en vivo) para saber cómo funciona el modo paper dentro de Gainium.

Ejemplos de prompts para probar#

Lo que puedes hacer depende de qué conector añadiste — solo lectura o lectura + escritura.

Con el conector de solo lectura#

Estos solo leen tu cuenta y el mercado — seguros de ejecutar en cualquier momento:

Encuentra oportunidades:

Encuentra las 5 monedas más volátiles en el screener de Gainium y resume sus movimientos de precio y volumen en 24 horas.
Evalúa estrategias:

Muestra los mejores presets DCA seleccionados de Gainium para BTC en Binance y compara los niveles de riesgo corto, medio y largo por ROI y drawdown máximo.
Revisa tu portafolio:

Resume mis bots, operaciones y saldos abiertos con par, estado, % de take-profit y P&L no realizado, y señala cualquier operación abierta que no tenga stop-loss configurado.

Con el conector de lectura + escritura#

Estos también crean o gestionan bots y operaciones — mantén la conexión en paper trading mientras pruebas:

Crea desde el screener:

Encuentra las 3 monedas más volátiles y crea un bot DCA de paper que las opere con un take-profit del 2% y una escalera de seguridad de 3 órdenes.
Aplica una estrategia seleccionada:

Crea un bot de paper desde el preset DCA largo de riesgo medio de Gainium para BTC en Binance.
Ajusta una operación:

Establece un take-profit del 20% en mi operación de paper BNBUSDT abierta.

Los prompts 1–3 funcionan en cualquiera de los dos conectores; los prompts 4–6 requieren el conector de lectura + escritura — mantenlo solo en paper (o pasa paperContext: true) hasta que estés listo para operar con dinero real.

Avanzado: ejecuta tu propio servidor o usa otro cliente#

La mayoría de los usuarios pueden omitir esta sección. Úsala si tu cliente no es una aplicación de directorio — o si quieres ejecutar Gainium MCP tú mismo con tu propia clave API.

Necesitarás una clave y secreto API de Gainium (crea una). Cuando crees la clave puedes limitarla a solo lectura y establecer un modo de trading o restricción de bot único; esos límites se aplican del lado del servidor.

Stdio local (recomendado para autoalojamiento)#

Tu cliente ejecuta gainium-mcp localmente; las credenciales permanecen en tu máquina:

{
  "mcpServers": {
    "gainium": {
      "command": "npx",
      "args": ["-y", "gainium-mcp"],
      "env": {
        "GAINIUM_API_KEY": "YOUR_GAINIUM_API_KEY",
        "GAINIUM_API_SECRET": "YOUR_GAINIUM_API_SECRET"
      }
    }
  }
}

Añade "GAINIUM_PAPER_ONLY": "true" y/o "GAINIUM_ALLOWED_BOT_ID": "<botId>" para forzar paper trading o bloquear el servidor a un solo bot, independientemente de los permisos de la clave API.

HTTP alojado con clave API#

Para clientes que autentican con encabezados en lugar del conector OAuth:

{
  "mcpServers": {
    "gainium": {
      "transport": "http",
      "url": "https://mcp.gainium.io/mcp",
      "headers": {
        "X-API-Key": "YOUR_GAINIUM_API_KEY",
        "X-API-Secret": "YOUR_GAINIUM_API_SECRET"
      }
    }
  }
}

Cualquier restricción de modo de trading o ID de bot incorporada en la clave API también se aplica aquí. (¿Te conectas desde Claude, ChatGPT o Perplexity? Usa el conector de un clic en tu guía por aplicación — no necesitas encabezados.)

HTTP y SSE local#

Ejecuta el servidor en modo HTTP si tu cliente necesita un endpoint HTTP o SSE local:

export GAINIUM_API_KEY=YOUR_GAINIUM_API_KEY
export GAINIUM_API_SECRET=YOUR_GAINIUM_API_SECRET
export GAINIUM_MCP_TRANSPORT=http
export GAINIUM_MCP_HOST=127.0.0.1
export GAINIUM_MCP_PORT=3000
node dist/server.js

Luego conéctate a http://127.0.0.1:3000/mcp. Los endpoints SSE heredados (GET /sse, POST /messages?sessionId=...) también están disponibles; prefiere /mcp cuando tu cliente admita MCP moderno sobre HTTP.

Solución de problemas#

El conector no autoriza / el inicio de sesión falla. Asegúrate de haber iniciado sesión en Gainium con 2FA y de que las ventanas emergentes estén permitidas para la ventana de inicio de sesión. Puedes revisar o eliminar la conexión en Configuración → Aplicaciones conectadas e intentar de nuevo.

Se rechaza una acción de escritura. El conector de solo lectura no puede crear ni modificar nada — añade el conector de lectura + escritura para eso. Si estás en lectura + escritura, verifica que la conexión (o tu clave API) no esté restringida a solo lectura, solo paper o un solo bot.

Autoalojamiento: "faltan credenciales". Establece GAINIUM_API_KEY y GAINIUM_API_SECRET en el proceso del servidor (stdio/HTTP local), o envía los encabezados X-API-Key / X-API-Secret (HTTP alojado con clave API).

Tu cliente solo admite SSE. Ejecuta el servidor en modo HTTP local y conéctate a /sse (ver Avanzado).

Valores predeterminados recomendados#

Usa el conector de solo lectura a menos que tu IA necesite colocar o modificar operaciones.
Para trading, usa el conector de lectura + escritura y mantén solo paper trading activado mientras pruebas.
¿Autoalojamiento? Prefiere stdio local con una clave API con alcance limitado, y establece GAINIUM_PAPER_ONLY / GAINIUM_ALLOWED_BOT_ID si quieres límites aplicados por el servidor.