Communitygithub.com

nakazanie-ton/myrocket

Servidor MCP, habilidad de agente y plugin Codex no oficial de xRocket, con seguridad como prioridad.

¿Qué es myrocket?

Este es un servidor MCP no oficial, habilidad de agente y plugin Codex para la API de Exchange de xRocket, diseñado con un enfoque de seguridad primero. Su objetivo es permitir que agentes de IA como Claude, Cursor y Codex interactúen con datos de mercado públicos, consulten cuentas de forma privada y ejecuten acciones financieras (órdenes, transferencias, retiros) en Exchange de xRocket, pero siempre con un comportamiento de 'fallo cerrado' (fail-closed) para prevenir acciones no intencionadas en mainnet. La habilidad proporciona herramientas semanticas para datos de mercado, consultas de cuenta y acciones financieras preparadas y ejecutadas en dos pasos. Exige una configuración explícita del entorno, identificadores únicos de cliente y aprobación de previsualizaciones antes de ejecutar escrituras. Sigue documentación de referencia para la selección de herramientas, seguridad y manejo de errores. Es especialmente útil para desarrolladores que desean integrar agentes de IA con Exchange de xRocket de forma segura y controlada.

Compatible con~Claude Code✓Codex CLI~Cursor
npx skills add nakazanie-ton/myrocket

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

xRocket Exchange

Usa herramientas semánticas de xRocket MCP. Mantén el análisis público rápido y cada acción privada o financiera con fallo cerrado.

Comenzar de forma segura

  1. Identifica el entorno y la operación solicitados. El entorno se fija cuando el servidor MCP se inicia: cuando el usuario no especifica uno, exige un servidor configurado en testnet y verifica el environment devuelto por las herramientas antes de cualquier escritura.
  2. Usa public para datos de mercado. Usa private-read solo cuando se necesite el estado de la cuenta. Usa full solo cuando el usuario solicite explícitamente una acción financiera compatible.
  3. Nunca pidas el token API en el chat ni lo pases como argumento de herramienta. Si una herramienta privada no está disponible, explica la configuración de entorno requerida sin solicitar el secreto.
  4. Lee references/api-map.md para la selección de herramientas. Lee references/safety.md antes de cualquier escritura, references/errors.md para fallos, y references/advanced-workflows.md para trabajo de varios pasos.

Flujo de trabajo de mercado público

  1. Resuelve el activo/símbolo con xrocket_market_symbols o xrocket_asset_info antes del análisis.
  2. Obtén solo la evidencia necesaria: cotización, instantánea del libro de órdenes, operaciones, velas, tasas o comisiones de trading.
  3. Preserva marcas de tiempo y cadenas decimales. Etiqueta campos obsoletos o faltantes; no sintetices tasa de financiación, interés abierto, posiciones, apalancamiento o datos de derivados porque la API auditada no los expone.
  4. Describe el resultado como una instantánea REST de xRocket, no como un flujo WebSocket en vivo.

Flujo de trabajo de lectura privada

  1. Confirma que el usuario quiere sus datos de cuenta y que private-read o full está configurado localmente.
  2. Usa xrocket_account_balances, xrocket_orders, xrocket_transfers, xrocket_withdrawals, o xrocket_withdrawal_quotas.
  3. Minimiza la divulgación en la respuesta. No repitas el token bearer, direcciones completas de retiro o datos de cuenta no relacionados.
  4. Distingue saldos de trading y financiación. Describe las transferencias en Exchange solo como movimientos internos de funding ↔ trading.

Flujo de trabajo de escritura financiera

Nunca saltes directamente a una herramienta de ejecución.

  1. Lee las reglas actuales del símbolo/activo, los saldos relevantes y, cuando corresponda, la cuota de retiro.
  2. Exige un identificador de cliente único para cada nueva orden, transferencia interna o retiro. La cancelación puede identificar la orden existente por orderId.
  3. Llama a la herramienta *_prepare correspondiente e inspecciona su vista previa exacta.
  4. Presenta entorno, operación, activo/símbolo/red, dirección/lado, cantidad/tamaño/fondos decimal, precio/precio límite, comisión/estimación, destino/cuenta e identificador de cliente. Solicita la aprobación explícita de esa vista previa.
  5. Ejecuta solo después de la aprobación actual del usuario, pasando únicamente el approvalReceipt de corta duración devuelto. El servidor recupera la intención exacta almacenada; no reenvíes ni reconstruyas la carga útil.
  6. Lee el estado devuelto por identificador de cliente. En caso de tiempo de espera/desconexión/respuesta ambigua del upstream, reporta resultado desconocido y concilia antes de proponer otro intento. Nunca reintentes automáticamente una escritura.

Mainnet requiere una decisión explícita separada del usuario y XROCKET_ALLOW_MAINNET_WRITES=true. Una aprobación previa en testnet no autoriza mainnet.

Depósitos e incorporación

La API de Exchange auditada no tiene un endpoint de dirección de depósito. No inventes ni aceptes una dirección no verificada. Usa xrocket_onboarding_links para instrucciones de interfaz, divulga que sus CTAs contienen el código de referido kaban y pueden beneficiar al mantenedor, luego actualiza los saldos de financiación después de que el usuario complete el depósito.

Nunca añadas el código de referido a las URLs de API, WebSocket, documentación, repositorio, soporte o MCP. Los CTAs de bots de producción y testnet gestionados por el proyecto devueltos por la herramienta usan la carga útil start=kaban; no inventes otras formas de URL de referido.

Límites estrictos

  • No trates las transferencias internas de Exchange como pagos de usuario a usuario. xRocket Pay es un producto separado y no está disponible a través de estas herramientas.
  • No conviertas cadenas decimales financieras a través de punto flotante binario.
  • No afirmes reconstrucción del libro de órdenes delta, reproducción o integridad de eventos privados; 0.1.0 expone instantáneas REST.
  • No copies comportamiento de ofertas/acuerdos no compatible de tutoriales en llamadas API.
  • No uses TON como identificador de activo donde los metadatos actuales de Exchange requieren TONCOIN; la red TON y el activo TONCOIN son campos diferentes.
  • No despliegues perfiles privados/de escritura detrás de un endpoint MCP público no autenticado.

Skills relacionados