Search DevTools

Jump to any tool or page

TraderSpy

AI crypto signals, smart money whale positions, live futures prices and indicators

target1m0 stars0 forksDesign & UX
View source

Install

mcp_config.json

{
  "mcpServers": {
    "app-traderspy-traderspy": {
      "url": "https://mcp.traderspy.app/mcp",
      "type": "streamable-http"
    }
  }
}

Documentation

TraderSpy MCP — Crypto Smart Money & AI Signals

Connect Claude, Claude Code, ChatGPT or any MCP client to TraderSpy's live crypto futures data: AI signals, whale positioning, market data and your own account — with one URL.

Every tool is read-only. The connector cannot place, close or modify an order, and it has no withdrawal or transfer tool. It answers questions; you place your trades yourself.

Features

  • AI Trading Signals — Real-time AI-powered crypto futures signals with entry/exit targets, stop loss, and confidence scores
  • Smart Money Tracking — Track whale/elite trader positions across Binance, Hyperliquid, Bybit, and OKX
  • Elite Leaderboard — Top traders ranked by SmartScore (weighted: PnL, win rate, ROI, consistency)
  • Live Positions — See what top traders are trading right now
  • Market Stats — Aggregate market statistics across tracked exchanges
  • Market Data — Real-time prices, OHLCV candles, and 13 technical indicators (RSI, MACD, EMA, Bollinger Bands, ATR, ADX, Stochastic, OBV, VWAP, CCI, MFI, Williams %R, SMA)
  • Your Own Account — Read your Hyperliquid balance, open positions and unrealized PnL (personal key required)
  • Interactive Views — In hosts that support MCP Apps, get_signals and get_signal_details render signal cards and charts instead of plain text

Quick Start

Claude Code

Option 1: Add MCP server directly

claude mcp add --transport http traderspy https://mcp.traderspy.app/mcp

Option 2: Install as plugin

Inside Claude Code, run:

/plugin marketplace add target1m/traderspy-mcp
/plugin install traderspy@traderspy-mcp

ChatGPT

  1. Go to ChatGPT → Settings → Connected Apps
  2. Click "Add MCP Server"
  3. Enter the server URL:
    https://mcp.traderspy.app/mcp
    
  4. Complete the OAuth login flow to connect your TraderSpy account

Cursor

Add TraderSpy to your Cursor MCP config (.cursor/mcp.json):

{
  "mcpServers": {
    "traderspy": {
      "type": "http",
      "url": "https://mcp.traderspy.app/mcp"
    }
  }
}

Cline

Add TraderSpy to cline_mcp_settings.json:

{
  "mcpServers": {
    "traderspy": {
      "type": "streamableHttp",
      "url": "https://mcp.traderspy.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

type must be exactly streamableHttpstreamable-http or a missing type falls back to SSE and the server answers 405. Full walkthrough, including how to get the key and how to verify the connection: llms-install.md.

Windsurf / Other MCP Clients

Add the following to your MCP configuration:

{
  "traderspy": {
    "type": "http",
    "url": "https://mcp.traderspy.app/mcp"
  }
}

Authentication

Two ways to connect, both tied to your TraderSpy account:

  • Personal URL (recommended) — generate it at traderspy.app/mcp or in Settings. The key is embedded in the URL (https://mcp.traderspy.app/mcp?token=mcp_...), so hosts that ask for authentication can be left on "None". Shown once, revocable any time.
  • OAuth — supported for clients that drive the OAuth flow themselves.

Treat the personal URL like a password: it grants read access to your account data. If it leaks, revoke it on the same page and generate a new one.

PlanDaily LimitData
Free5 calls/dayReal-time
Pro100 calls/dayReal-time

Don't have an account? Sign up for free to get started.

Available Tools

Signals

ToolDescription
get_signalsRecent AI trading signals with filtering
get_signal_detailsFull signal details with AI review
get_signal_statsSignal performance statistics

Smart Money

ToolDescription
get_top_tradersRanked traders by exchange and metrics
get_elite_leaderboardTop 10 by SmartScore
get_trader_profileTrader profile with metrics and positions
get_trader_position_historyTrader's closed trade history
get_positionsLive and historical positions
get_market_statsAggregate market statistics
get_exchangesList of tracked exchanges

Market Data

ToolDescription
get_priceReal-time price, 24h high/low, volume, and change% for one or more symbols
get_candlesOHLCV candles (1m, 5m, 15m, 1h, 4h, 1d) for charting and analysis
get_technical_indicatorsCompute RSI, MACD, EMA, SMA, Bollinger, ATR, ADX, Stochastic, OBV, VWAP, CCI, MFI, Williams %R
get_tracked_symbolsList all crypto futures symbols with real-time data available

Your Account

ToolDescription
get_my_accountYour Hyperliquid balance, open positions and unrealized PnL (read-only, personal key required)

Example Prompts

  • "What are the top crypto signals right now?"
  • "Show me the elite trader leaderboard"
  • "What are whales buying on Binance?"
  • "Get the signal performance stats for the last 24 hours"
  • "Show me BTC positions from top traders"
  • "Who are the most profitable traders on Hyperliquid this week?"
  • "What's the overall market sentiment — are more traders long or short on BTC?"
  • "What's the current price of BTC and ETH?"
  • "Show me the last 100 1h candles for SOLUSDT"
  • "Compute RSI and MACD for BTCUSDT on the 4h timeframe"
  • "Which symbols does TraderSpy track?"
  • "Show my TraderSpy account — balance, open positions and PnL"

Links

Sourced from the repository README.

More in Design & UX