Skip to content

Lucyd

by lucyd.trade · remote · local (npm) · no sign-in to list tools · v0.1.3 · published by trade.lucyd

Trade Bitcoin Up/Down prediction markets on Lucyd: markets, order books, orders, positions.

Changes · 1

9 tools: 1 change things and 8 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

9 tools

Changes things 1Claude Code: ask
  • top_tradersLeaderboard of traders, best first.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    Leaderboard of traders, best first.

    Annotations the server declares

    • title: Top traders
    • readOnlyHint: true
    • openWorldHint: false
Only reads 8Claude Code: allow
  • get_marketFull details of one market, including its rules and the ids of its up and down outcome tokens.No findings

    Why it is in this group

    • The name "get_market" says "get": a word for reading.
    Description, as the server wrote it
    Full details of one market, including its rules and the ids of its up and down outcome tokens.

    Annotations the server declares

    • title: Get market
    • readOnlyHint: true
    • openWorldHint: false
  • get_order_bookOrder book of a market outcome: bids (best first) and asks with prices in USDC per token and sizes in tokens, plus best bid, best ask and mid.No findings

    Why it is in this group

    • The name "get_order_book" says "get": a word for reading.
    Description, as the server wrote it
    Order book of a market outcome: bids (best first) and asks with prices in USDC per token and sizes in tokens, plus best bid, best ask and mid. Buying down at p is the same book as selling up at 1 - p.

    Annotations the server declares

    • title: Get order book
    • readOnlyHint: true
    • openWorldHint: false
  • get_pnl_historyProfit and loss over time of a wallet, as a series of points.No findings

    Why it is in this group

    • The name "get_pnl_history" says "get": a word for reading.
    Description, as the server wrote it
    Profit and loss over time of a wallet, as a series of points. Defaults to the configured wallet.

    Annotations the server declares

    • title: Get P&L history
    • readOnlyHint: true
    • openWorldHint: false
  • get_positionsPositions of a wallet: tokens held per market and outcome, average price, current value and profit.No findings

    Why it is in this group

    • The name "get_positions" says "get": a word for reading.
    Description, as the server wrote it
    Positions of a wallet: tokens held per market and outcome, average price, current value and profit. Settled markets show the payout. Defaults to the configured wallet.

    Annotations the server declares

    • title: Get positions
    • readOnlyHint: true
    • openWorldHint: false
  • get_statusHealth of the Lucyd service: API and database, settlement of ended markets on time, live trade stream.No findings

    Why it is in this group

    • The name "get_status" says "get": a word for reading.
    Description, as the server wrote it
    Health of the Lucyd service: API and database, settlement of ended markets on time, live trade stream. Use it when something looks stuck, e.g. a market is not resolving.

    Annotations the server declares

    • title: Service status
    • readOnlyHint: true
    • openWorldHint: false
  • get_trader_statsStats of a wallet: total and realized profit, volume, markets traded, win rate.No findings

    Why it is in this group

    • The name "get_trader_stats" says "get": a word for reading.
    Description, as the server wrote it
    Stats of a wallet: total and realized profit, volume, markets traded, win rate. Defaults to the configured wallet.

    Annotations the server declares

    • title: Get trader stats
    • readOnlyHint: true
    • openWorldHint: false
  • list_marketsList prediction markets on Lucyd.No findings

    Why it is in this group

    • The name "list_markets" says "list": a word for reading.
    Description, as the server wrote it
    List prediction markets on Lucyd. Each market asks whether the BTC price will be Up or Down at its end date versus the strike (strike is the price times 1e8). Returns address (the market id), state, period, start and end dates, strike, winner and volume.

    Annotations the server declares

    • title: List markets
    • readOnlyHint: true
    • openWorldHint: false
  • list_tradesRecent trades, newest first.No findings

    Why it is in this group

    • The name "list_trades" says "list": a word for reading.
    Description, as the server wrote it
    Recent trades, newest first. Filter by market and/or trader. Amounts are in USDC and tokens.

    Annotations the server declares

    • title: List trades
    • readOnlyHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.1.3. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__lucyd__get_market",
      "mcp__lucyd__get_order_book",
      "mcp__lucyd__get_pnl_history",
      "mcp__lucyd__get_positions",
      "mcp__lucyd__get_status",
      "mcp__lucyd__get_trader_stats",
      "mcp__lucyd__list_markets",
      "mcp__lucyd__list_trades"
    ],
    "ask": [
      "mcp__lucyd__top_traders"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as lucyd. Review it before you use it.