# Lucyd

> Lucyd is an open-source MCP server for finance and payments. Trade and read Bitcoin Up/Down prediction markets on Lucyd from an AI agent. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://lucyd.trade/mcp
- **Repository:** https://github.com/lucyd-trade/mcp-server
- **MCP Registry name:** trade.lucyd/mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.lucyd.trade/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.lucyd.trade/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.lucyd.trade/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.lucyd.trade/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.lucyd.trade/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.lucyd.trade/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/lucyd
