Skip to content
MCP server

Lucyd

Trade and read Bitcoin Up/Down prediction markets on Lucyd from an AI agent

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.lucyd.trade/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.lucyd.trade/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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-only
  • LUCYD_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

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government