Lucyd mcp

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

Servidor MCP Lucyd

Conecte um agente de IA (Claude, Cursor ou qualquer cliente MCP) ao Lucyd, uma exchange de mercados de previsão. Peça em linguagem natural para navegar pelos mercados, ler o livro de ofertas, negociar, fechar posições e coletar ganhos.

O Lucyd atualmente roda na testnet Ethereum Sepolia com USDC de teste.

O que ele pode fazer

Ferramenta	O que faz
list_markets	Mercados com filtros por estado e período
get_market	Um mercado: regras, strike, data de encerramento, ids dos tokens de resultado
get_order_book	Lances e ofertas de um resultado, melhor lance, melhor oferta, mid
list_trades	Negociações recentes, por mercado ou trader
get_positions	Tokens em posse, preço médio, valor e lucro
get_trader_stats	Lucro, volume, taxa de acerto de uma carteira
get_pnl_history	Lucro ao longo do tempo
top_traders	Ranking
get_status	Se o serviço, a liquidação e as negociações ao vivo estão saudáveis
get_wallet	Seu endereço, saldos de ETH e USDC, aprovações
get_open_orders	Suas ordens em aberto
get_order_history	Suas ordens passadas e atuais com status e execuções
place_order	Ordem limitada ou a mercado (comprar ou vender up ou down)
close_position	Vender imediatamente tudo o que você possui em um mercado
cancel_orders	Cancelar por id, todas em um mercado, ou todas
approve_trading	Aprovações únicas para o contrato Exchange
set_auto_redeem	Ativar ou desativar o pagamento automático de ganhos
redeem	Coletar o pagamento de um mercado resolvido

Exemplos de pedidos:

• "Mostre os mercados abertos de 1h e o livro de ofertas do atual"
• "Compre 10 tokens up no mercado atual de 15m a 0.55 ou melhor"
• "Feche minha posição no mercado de 5m"
• "Quais são minhas posições e o lucro total desta semana?"
• "Cancele todas as minhas ordens"

Sem uma chave de carteira, o servidor funciona em modo somente leitura: mercados, livros, negociações e estatísticas públicas de qualquer carteira.

Hospedado, somente leitura

Apenas para dados de mercado, sem nada para instalar: adicione https://mcp.lucyd.trade/mcp como um conector personalizado (servidor MCP remoto, sem autenticação) no Claude, ChatGPT ou qualquer cliente que suporte Streamable HTTP. Ele tem as ferramentas de dados de mercado: mercados, livros de ofertas, negociações e posições e estatísticas de qualquer endereço de carteira. Negociar exige sua própria chave de carteira, então funciona apenas com o servidor local abaixo.

Para rodar sua própria cópia hospedada, defina LUCYD_HTTP_ADDR (por exemplo 0.0.0.0:3006) e LUCYD_HTTP_HOSTS (os nomes de host aos quais ele responde); o servidor então serve MCP em /mcp e se recusa a iniciar com uma chave de carteira.

Instalação

O jeito mais fácil exige apenas Node.js 18 ou mais recente: o cliente executa npx -y @lucyd/mcp, que baixa o binário para o seu sistema na primeira execução e verifica seu SHA-256. Nada mais para instalar, veja as configurações abaixo.

Sem Node.js, baixe o binário para o seu sistema em data.testnet.lucyd.trade/mcp (abra a pasta da versão mais recente; SHA256SUMS lá lista as somas de verificação) e coloque-o em qualquer lugar, por exemplo ~/bin/lucyd-mcp (lucyd-mcp.exe no Windows). No macOS e Linux, torne-o executável com chmod +x lucyd-mcp. Depois use o caminho dele em vez de npx nas configurações abaixo.

Ou compile a partir do código-fonte com Rust:

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

Conecte seu agente

Substitua a chave pela chave da sua carteira de negociação. Reinicie o cliente depois.

Claude Code

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

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

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

Ambos usam o mesmo formato:

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

Se o cliente no Windows não conseguir iniciar npx, use "command": "cmd" com "args": ["/c", "npx", "-y", "@lucyd/mcp"].

Antes da primeira negociação

A carteira precisa de USDC para comprar e um pouco de Sepolia ETH para pagar o gás das aprovações únicas e resgates. Depois peça ao agente para verificar sua carteira e aprovar a negociação, ou chame approve_trading diretamente. A negociação em si não custa gás: a exchange liquida as execuções on chain.

Configurações

Variável	Padrão	Significado
LUCYD_PRIVATE_KEY	nenhum	Chave da carteira que assina ordens e transações. Sem ela, as ferramentas de negociação ficam desativadas
LUCYD_MAX_ORDER_USD	100	Maior ordem de compra em USDC
LUCYD_READ_ONLY	false	true desativa todas as ferramentas que negociam ou enviam transações
LUCYD_RPC_URL	https://ethereum-sepolia-rpc.publicnode.com	Nó RPC da Sepolia
LUCYD_API_URL	https://api.testnet.lucyd.trade	API de mercados
LUCYD_CLOB_URL	https://clob.testnet.lucyd.trade	Livro de ofertas

Segurança

• A chave nunca sai da sua máquina. O servidor assina localmente e envia apenas ordens e transações assinadas.
• Use uma carteira separada para o agente e mantenha nela apenas o que você está pronto para negociar.
• O servidor instrui o agente a perguntar a você antes de negociar, mas isso depende do agente. Defina LUCYD_MAX_ORDER_USD baixo, ou LUCYD_READ_ONLY=true se você só quer dados.

Como funciona

O servidor roda localmente e se comunica com o agente via stdio. Os dados de mercado vêm da API pública. As ordens são assinadas com EIP-712 e enviadas ao livro de ofertas via WebSocket (protocolo na documentação da API). Aprovações e resgates são transações comuns na Sepolia.

Contrato	Endereço
Exchange	0x6588c789c6b6df8f8b6b92e6433f813cc2d1d4d0
ConditionalTokens (tokens de resultado)	0xB62eFc43C16b4E2Bf1aAAD33002368e55708538D
USDC (6 casas decimais)	0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
AutoRedeemer	0x42Bf669f0A3DCc95510001Ddbc43D56FdE67268F

Licença

MIT