Lucyd mcp

npx add-mcp 'https://mcp.lucyd.trade/mcp'

Servidor MCP de Lucyd

Conecta un agente de IA (Claude, Cursor o cualquier cliente MCP) a Lucyd, un exchange de mercados de predicción. Pide en lenguaje natural para explorar mercados, leer el libro de órdenes, operar, cerrar posiciones y cobrar ganancias.

Lucyd actualmente funciona en la testnet Ethereum Sepolia con USDC de prueba.

Qué puede hacer

Herramienta	Qué hace
list_markets	Mercados con filtros por estado y periodo
get_market	Un mercado: reglas, strike, fecha de finalización, ids de tokens de resultado
get_order_book	Ofertas de compra y venta de un resultado, mejor oferta de compra, mejor oferta de venta, punto medio
list_trades	Operaciones recientes, por mercado o por trader
get_positions	Tokens en posesión, precio medio, valor y beneficio
get_trader_stats	Beneficio, volumen, tasa de acierto de una cartera
get_pnl_history	Beneficio a lo largo del tiempo
top_traders	Clasificación
get_status	Si el servicio, la liquidación y las operaciones en vivo están en buen estado
get_wallet	Tu dirección, saldos de ETH y USDC, aprobaciones
get_open_orders	Tus órdenes en reposo
get_order_history	Tus órdenes pasadas y actuales con estado y ejecuciones
place_order	Orden limitada o de mercado (comprar o vender al alza o a la baja)
close_position	Vender de inmediato todo lo que tengas en un mercado
cancel_orders	Cancelar por id, todas en un mercado, o todas
approve_trading	Aprobaciones únicas para el contrato Exchange
set_auto_redeem	Activar o desactivar el pago automático de ganancias
redeem	Cobrar el pago de un mercado resuelto

Ejemplos de peticiones:

• "Muestra los mercados abiertos de 1h y el libro de órdenes del actual"
• "Compra 10 tokens al alza en el mercado actual de 15m a 0.55 o mejor"
• "Cierra mi posición en el mercado de 5m"
• "¿Cuáles son mis posiciones y el beneficio total esta semana?"
• "Cancela todas mis órdenes"

Sin una clave de cartera, el servidor funciona en modo de solo lectura: mercados, libros, operaciones y estadísticas públicas de cualquier cartera.

Alojado, solo lectura

Solo para datos de mercado, sin nada que instalar: añade https://mcp.lucyd.trade/mcp como conector personalizado (servidor MCP remoto, sin autenticación) en Claude, ChatGPT o cualquier cliente que admita Streamable HTTP. Tiene las herramientas de datos de mercado: mercados, libros de órdenes, operaciones, y posiciones y estadísticas de cualquier dirección de cartera. Operar requiere tu propia clave de cartera, así que solo funciona con el servidor local de abajo.

Para ejecutar tu propia copia alojada, define LUCYD_HTTP_ADDR (por ejemplo 0.0.0.0:3006) y LUCYD_HTTP_HOSTS (los nombres de host a los que responde); el servidor entonces sirve MCP en /mcp y se niega a arrancar con una clave de cartera.

Instalación

La forma más sencilla solo necesita Node.js 18 o superior: el cliente ejecuta npx -y @lucyd/mcp, que descarga el binario para tu sistema en la primera ejecución y verifica su SHA-256. Nada más que instalar, consulta las configuraciones de abajo.

Sin Node.js, descarga el binario para tu sistema desde data.testnet.lucyd.trade/mcp (abre la carpeta de la última versión; SHA256SUMS allí lista las sumas de verificación) y colócalo donde quieras, por ejemplo ~/bin/lucyd-mcp (lucyd-mcp.exe en Windows). En macOS y Linux hazlo ejecutable con chmod +x lucyd-mcp. Luego usa su ruta en lugar de npx en las configuraciones de abajo.

O compila desde el código fuente con Rust:

cargo install --git https://github.com/lucyd-trade/mcp-server

Conecta tu agente

Sustituye la clave por la clave de tu cartera de operaciones. Reinicia el cliente después.

Claude Code

claude mcp add lucyd -e LUCYD_PRIVATE_KEY=0xYOUR_KEY -- npx -y @lucyd/mcp

Claude Desktop: edita claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\).

Cursor: edita ~/.cursor/mcp.json.

Ambos usan el mismo formato:

{
  "mcpServers": {
    "lucyd": {
      "command": "npx",
      "args": ["-y", "@lucyd/mcp"],
      "env": {
        "LUCYD_PRIVATE_KEY": "0xYOUR_KEY"
      }
    }
  }
}

Si el cliente en Windows no puede iniciar npx, usa "command": "cmd" con "args": ["/c", "npx", "-y", "@lucyd/mcp"].

Antes de la primera operación

La cartera necesita USDC para comprar y un poco de ETH de Sepolia para pagar el gas de las aprobaciones únicas y los canjes. Luego pide al agente que compruebe tu cartera y apruebe las operaciones, o llama directamente a approve_trading. Operar en sí no cuesta gas: el exchange liquida las ejecuciones en la cadena.

Configuración

Variable	Predeterminado	Significado
LUCYD_PRIVATE_KEY	ninguno	Clave de cartera que firma órdenes y transacciones. Sin ella, las herramientas de operación están desactivadas
LUCYD_MAX_ORDER_USD	100	Orden de compra máxima en USDC
LUCYD_READ_ONLY	false	true desactiva todas las herramientas que operan o envían transacciones
LUCYD_RPC_URL	https://ethereum-sepolia-rpc.publicnode.com	Nodo RPC de Sepolia
LUCYD_API_URL	https://api.testnet.lucyd.trade	API de mercados
LUCYD_CLOB_URL	https://clob.testnet.lucyd.trade	Libro de órdenes

Seguridad

• La clave nunca sale de tu máquina. El servidor firma localmente y solo envía órdenes y transacciones firmadas.
• Usa una cartera separada para el agente y guarda en ella solo lo que estés dispuesto a operar.
• El servidor indica al agente que te pregunte antes de operar, pero eso depende del agente. Define LUCYD_MAX_ORDER_USD bajo, o LUCYD_READ_ONLY=true si solo quieres datos.

Cómo funciona

El servidor se ejecuta localmente y se comunica con el agente por stdio. Los datos de mercado provienen de la API pública. Las órdenes se firman con EIP-712 y se envían al libro de órdenes por WebSocket (protocolo en la documentación de la API). Las aprobaciones y los canjes son transacciones normales en Sepolia.

Contrato	Dirección
Exchange	0x6588c789c6b6df8f8b6b92e6433f813cc2d1d4d0
ConditionalTokens (tokens de resultado)	0xB62eFc43C16b4E2Bf1aAAD33002368e55708538D
USDC (6 decimales)	0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
AutoRedeemer	0x42Bf669f0A3DCc95510001Ddbc43D56FdE67268F

Licencia

MIT