xRocket Exchange MCP

Prepara, revisa y ejecuta órdenes de xRocket CEX mediante un cliente de IA compatible con MCP. El servidor local obtiene la estimación del exchange, la tarifa, las reglas de mercado, los saldos relevantes y la intención exacta antes de una ejecución aprobada por separado.

El endpoint alojado sigue siendo una demo pública de datos de mercado y una vía de incorporación; nunca recibe credenciales de cuenta y no puede operar. Este paquete no está afiliado a xRocket ni respaldado por xRocket. Configurar el trading o abrir xRocket.

Inicio rápido de trading

1. Inicia sesión en xRocket y abre Menú → Ajustes → Ajustes del exchange → Token de API.

2. Genera una configuración MCP solo de órdenes, con prioridad para testnet:

   npx -y xrocket-mcp@0.5.0 trading-config

3. Pega el JSON generado en tu cliente MCP local. Sustituye SET_YOUR_XROCKET_API_TOKEN_LOCALLY únicamente en la configuración local de secretos y de entorno del cliente.

4. Pide al cliente que prepare una orden y muestre la estimación, la tarifa, los saldos, las reglas y la intención exacta sin ejecutarla. Aprueba explícitamente solo después de revisar esa vista previa.

Usa npx -y xrocket-mcp@0.5.0 trading-config --mainnet solo después de validar en testnet. Activa la puerta de órdenes de mainnet por separado; las transferencias y los retiros siguen deshabilitados.

El token upstream tiene un acceso amplio a la cuenta en lugar de ámbitos granulares documentados. Nunca lo pongas en un chat, en el endpoint alojado, en un archivo confirmado, en una incidencia ni en un registro.

Related MCP server: tossinvest-openapi-mcp

Demo de mercado alojada

Usa la página de conexión o copia el endpoint público de mainnet sin instalar nada ni aportar credenciales:

https://xrocket-mcp-production.up.railway.app/mcp

Expone únicamente las 10 herramientas públicas y no puede leer tokens de la cuenta ni habilitar escrituras financieras. Cuando se le pide operar, su herramienta de incorporación remite al usuario a la configuración local descrita arriba.

Inicio rápido local

npx -y xrocket-mcp@0.5.0 doctor
npx -y xrocket-mcp@0.5.0 config

Se requiere Node.js 20 o superior. Las lecturas públicas de mercado funcionan sin configuración:

XROCKET_PROFILE=public
XROCKET_ENVIRONMENT=mainnet

Instala el complemento Codex todo-en-uno desde el marketplace del repositorio:

codex plugin marketplace add nakazanie-ton/myrocket --ref main
codex plugin add xrocket-exchange@xrocket-agents

Ejemplo de cliente MCP:

{
  "mcpServers": {
    "xrocket": {
      "command": "npx",
      "args": ["-y", "xrocket-mcp@0.5.0"],
      "env": {
        "XROCKET_ENVIRONMENT": "mainnet",
        "XROCKET_ENABLE_TRADING": "false",
        "XROCKET_ENABLE_TRANSFERS": "false",
        "XROCKET_ENABLE_WITHDRAWALS": "false",
        "XROCKET_ALLOW_MAINNET_WRITES": "false"
      }
    }
  }
}

Para el desarrollo del código fuente, ejecuta npm ci, npm test y npm run build en este directorio.

Perfiles y puertas de escritura

• public: 10 herramientas sin autenticación, incluida la herramienta compuesta xrocket_market_snapshot.

• private-read: herramientas públicas más saldos, resumen general de la cuenta, órdenes, transferencias, retiros y cuotas; se infiere cuando se detecta XROCKET_API_TOKEN.

• full: todas las herramientas, pero cada familia de execute permanece deshabilitada a menos que su propia puerta esté con valor true.

Las puertas de escritura son XROCKET_ENABLE_TRADING, XROCKET_ENABLE_TRANSFERS y XROCKET_ENABLE_WITHDRAWALS; todas están en false por defecto. Las escrituras en mainnet también requieren XROCKET_ALLOW_MAINNET_WRITES=true.

Cada escritura financiera guarda la intención exacta preparada en la memoria del servidor y devuelve un recibo de aprobación breve, vinculado a la solicitud y de un solo uso. Los identificadores de cliente que faltan se generan durante la preparación y se muestran en la vista previa. La ejecución solo acepta ese recibo. Las escrituras no se reintentan automáticamente tras un resultado de red ambiguo; primero se concilia con el identificador del cliente.

El recibo vincula los datos de la solicitud, pero no demuestra el consentimiento humano. Si tu cliente MCP no tiene una interfaz de aprobación de confianza ni una política de operador fuera de banda, mantén deshabilitadas todas las puertas de ejecución.

Límites

• La API de Exchange no tiene un endpoint de dirección de depósito; la incorporación es solo una guía de interfaz de usuario.

• Las transferencias del exchange son internas entre funding ↔ trading, no pagos entre usuarios.

• xRocket Pay es un producto aparte y no está incluido.

• Los canales de WebSocket están auditados, pero la versión 0.5.0 usa snapshots REST acotados.

• Mantén los valores de los activos como cadenas decimales y usa TONCOIN cuando la API actual lo requiera.

La documentación completa, la cobertura, la política de seguridad, el aviso de privacidad y los términos se pueden en el repositorio del proyecto.