Lucyd
Trade and read Bitcoin Up/Down prediction markets on Lucyd from an AI agent
- Pricing
- Open source
- Platforms
- CLI, API, macOS
- Runs
- Locally or Remotely
- Version
- 0.1.4
- Listing updated
- 3 days ago
About Lucyd
Lucyd is an open-source MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
Lucyd is a prediction-market exchange, and its MCP server turns plain-language requests into market reads and signed orders. The README states Lucyd currently runs on the Ethereum Sepolia testnet with test USDC, so this is not real-money trading today.
The server's 18 tools cover market data (list_markets, get_market, get_order_book, list_trades, get_positions, get_trader_stats, get_pnl_history, top_traders, get_status), your wallet (get_wallet, get_open_orders, get_order_history, approve_trading) and actions such as place_order, close_position, cancel_orders, set_auto_redeem and redeem. Example prompts include the probability that BTC goes Up in the current 15-minute market, or closing a position in the 5-minute market.
The local server runs through npx -y @lucyd/mcp and signs orders with a wallet key that never leaves your computer; without the key it is read-only. LUCYD_MAX_ORDER_USD caps buy orders (default 100) and LUCYD_READ_ONLY disables every trading tool. The site warns that although the server tells an agent to ask before trading, the final call is the agent's, so keep the cap low. A hosted read-only server needs no key. The code is MIT-licensed.
Install
Run in a terminal
claude mcp add --transport http mcp https://mcp.lucyd.trade/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.lucyd.trade/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://mcp.lucyd.trade/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://mcp.lucyd.trade/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"serverUrl": "https://mcp.lucyd.trade/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"type": "http",
"url": "https://mcp.lucyd.trade/mcp"
}
}
}Configuration
LUCYD_PRIVATE_KEYWallet key that signs orders. Without it the server is read-onlyLUCYD_MAX_ORDER_USDLargest buy order in USDC (default 100)LUCYD_READ_ONLYtrue turns off every tool that trades or sends transactions
Tools this server provides (18)
Taken from the project documentation; the running server may differ.
- list_markets
- Lists markets filtered by state and period.
- get_market
- Returns rules, strike, end date and outcome token ids.
- get_order_book
- Returns bids, asks, best bid, best ask and mid.
- list_trades
- Lists recent trades by market or trader.
- get_positions
- Shows tokens held, average price, value and profit.
- get_trader_stats
- Returns profit, volume and win rate of a wallet.
- get_pnl_history
- Shows profit over time.
- top_traders
- Shows the leaderboard.
- get_status
- Reports service, settlement and live-trade health.
- get_wallet
- Shows address, ETH and USDC balances and approvals.
- get_open_orders
- Lists your resting orders.
- get_order_history
- Lists past and current orders with status and fills.
- place_order
- Places a limit or market order.
- close_position
- Sells everything held on a market.
- cancel_orders
- Cancels orders by id, per market or all.
- approve_trading
- Gives one-time approvals for the Exchange contract.
- set_auto_redeem
- Turns automatic payout of winnings on or off.
- redeem
- Collects the payout of a resolved market.
What it does
- Market data
- Read markets, order books, trades and any wallet's positions and stats.
- Local signing
- Orders are signed with a wallet key that stays on your machine.
- Order cap
- LUCYD_MAX_ORDER_USD limits the largest buy order.
- Read-only mode
- Leave out the key or set LUCYD_READ_ONLY to disable trading tools.
- Auto-redeem
- Turn automatic payout of winnings on or off.
- Hosted read-only server
- Market data is available through a keyless remote endpoint.
Good for
- Check the order book of the current 15-minute market
- Place a limit order from a chat prompt
- Review positions and profit for the week
- Look up a wallet's win rate and leaderboard standing
- Close a position quickly
Pricing
Open source
MIT-licensed; testnet with test USDC
Prices change. Check lucyd.trade before you buy.
Lucyd FAQ
Is this real money?
The README says Lucyd runs on the Ethereum Sepolia testnet with test USDC.
Does my private key leave my computer?
No, only signed orders and transactions are sent.
Can I use it read-only?
Yes, omit the key or set LUCYD_READ_ONLY=true, or use the hosted endpoint.
What do I need to run it?
Node.js 18 or newer for npx, or the binary or a Rust build.
Is Lucyd free?
Yes. Lucyd is open source, so you can use and self-host it for free.
How do I add Lucyd to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp https://mcp.lucyd.trade/mcp
What are the best alternatives to Lucyd?
The closest alternatives to Lucyd are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to Lucyd

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government