---

Connect Claude, Claude Code, ChatGPT, Grok, Cursor, Cline or any MCP client to TraderSpy's live crypto futures data: AI-generated signals with real targets, whale positioning across four exchanges, prices, candles, indicators, derivatives, a condition screener, an event-study backtester — and your own account.

You ask:                             It calls:                     It reads:

"Which coins are oversold?"      →  screen_symbols()           →  top 100 by 24h volume, one pass
"Is BTC still trending?"         →  get_technical_indicators() →  1h + 4h + 1d in a single call
"What are the whales doing?"     →  get_positions()            →  Binance · Hyperliquid · Bybit · OKX
"Is this signal still valid?"    →  get_signal_details()       →  live price against entry / TP / SL
"What happens after this setup?" →  backtest_condition()       →  up to 1000 stored candles
"How close am I to liquidation?" →  get_my_account()           →  your own Hyperliquid account

Every tool is read-only. This connector cannot place, close or modify an order — not even on a paper account — and it has no withdrawal or transfer tool. It answers questions; you place your own trades. See Security.

---

Contents

Quick start · What it answers · Tool catalogue · Interactive views · Skills · Authentication · Security · Data sources · Architecture · Prompts to try · Changelog

---

Quick start

Everything below points at the same endpoint: https://mcp.traderspy.app/mcp. Generate a personal key at traderspy.app/mcp (Settings → MCP) — it starts with mcp_, is shown once, and is revocable at any time. A free account is enough.

Claude Code

As a plugin — also installs the six skills:

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

The plugin asks for your key when you enable it. Claude Code stores it in your keychain and sends it as a bearer token; it never lands in settings.json or in your repo.

Or as a plain MCP server:

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

ChatGPT

1. ChatGPT → Settings → Connected Apps
2. Add MCP Server
3. URL: https://mcp.traderspy.app/mcp
4. Complete the OAuth login to link your TraderSpy account

Grok (xAI)

grok.com/connectors → New Connector → Custom, then paste your personal URL — the key is embedded, so the host's authentication can stay on "None":

https://mcp.traderspy.app/mcp?token=mcp_YOUR_KEY

From the terminal, Grok Build takes the same URL:

grok mcp add --transport http traderspy "https://mcp.traderspy.app/mcp?token=mcp_YOUR_KEY"

The same endpoint works as a remote MCP tool in the xAI API. Grok speaks Streamable HTTP and SSE — so does this server.

Cursor

As a plugin — also installs the six skills. This repo is a Cursor plugin (.cursor-plugin/plugin.json + mcp.json): install TraderSpy from the Cursor Marketplace (listing in review), or clone the repo into ~/.cursor/plugins/local/traderspy and run Developer: Reload Window. Cursor asks for your key as TRADERSPY_API_KEY at install (change it later under Plugins → Configure) and sends it as a bearer token; it never lands in your repo.

Or as a plain MCP server — .cursor/mcp.json:

{
  "mcpServers": {
    "traderspy": {
      "url": "https://mcp.traderspy.app/mcp",
      "headers": {
        "Authorization": "Bearer mcp_YOUR_KEY"
      }
    }
  }
}

Cline

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 streamableHttp. streamable-http, or leaving type out, falls back to SSE and the server answers 405. Full walkthrough: llms-install.md.

Windsurf and other MCP clients

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

---

What it answers

The server publishes this routing to the model itself, so you rarely have to name a tool:

You ask about	It calls
Price, 24h change, volume	get_price — several symbols in one call
OHLCV for charting	get_candles
"Analyse X", oversold, trend, support/resistance	get_technical_indicators — up to 3 timeframes per call
Funding, open interest, long/short, taker flow	get_derivatives
"Which coins are…", "find setups", "compare A B C"	screen_symbols
"What usually happens after…"	backtest_condition
AI signals, their detail, their track record	get_signals · get_signal_details · get_signal_stats
Whales, best traders, who is long X	get_top_traders · get_elite_leaderboard · get_trader_profile · get_trader_position_history · get_positions
Coverage and venue context	get_tracked_symbols · get_exchanges · get_market_stats
Your own balance, positions, unrealized PnL	get_my_account

Batch, don't loop. Calls are metered per day, and the tools are built so one call replaces many: several symbols in a single get_price, three timeframes in a single get_technical_indicators (one quota unit, and you get the confluence across them), and screen_symbols instead of running indicators symbol by symbol.

---

Tool catalogue

18 tools, every one read-only, every one annotated readOnlyHint: true.

Signals — 3 tools

Tool	What it returns
get_signals	Recent AI signals with filtering — symbol, side, entry, TP1–TP3, stop, strength, validation score
get_signal_details	One signal in full: AI review, trigger conditions, every level as an absolute price, realised outcome, and the live price to judge whether it still applies
get_signal_stats	Track record over a period — win rate, profit factor, resolution breakdown

Smart money — 7 tools

Tool	What it returns
get_top_traders	Ranked traders per exchange, by the metric you choose
get_elite_leaderboard	Top 10 by SmartScore (weighted PnL, win rate, ROI, consistency, longevity, depth, recency)
get_trader_profile	One trader: metrics plus their open positions
get_trader_position_history	That trader's closed trades
get_positions	Live and historical smart-money positions, filterable by symbol and exchange
get_market_stats	Aggregate long/short and notional across tracked traders
get_exchanges	Which venues are tracked and enabled

Market data & research — 7 tools

Tool	What it returns
get_price	Real-time price, 24h high/low, volume and change% — one or many symbols
get_candles	OHLCV for 1m, 5m, 15m, 1h, 4h, 1d
get_technical_indicators	19 indicators — RSI, MACD, EMA, SMA, Bollinger, ATR, ADX, Stochastic, OBV, VWAP, CCI, MFI, Williams %R, ROC, SuperTrend, Ichimoku, Keltner, pivots, swing S/R. Each carries value + previous bar + direction + a history series. Multi-timeframe (intervals, ≤ 3) with a per-timeframe summary and a cross-timeframe confluence; custom periods; RSI/MACD divergence, Fibonacci retracement, volume profile, ATR percentile, TTM squeeze and candlestick patterns
get_derivatives	Funding (current, 24h/3d average, annualised), open interest (24h/4h change, OI×price regime), top-trader and all-account long/short ratios, taker flow — up to 5 Binance perpetuals, with the interpretation traders actually quote
screen_symbols	Scan the most-traded pairs (≤ 100, ranked by 24h volume) or an explicit list, for up to 3 AND-ed conditions over 17 metrics — rsi, stochastic, cci, mfi, williamsR, adx, roc, macdHistogram, atrPct, volumeRatio, bbPercentB, bbWidthPct, priceVsEma, emaSpread, supertrend, changePct, price — with lt / gt / crossAbove / crossBelow. One quota unit. Drop the conditions and pass symbols to get a comparison table instead
backtest_condition	Event study on one symbol and timeframe: every occurrence over the stored tape (≤ 1000 candles), forward return / win rate / best and worst excursion per horizon, the unconditional baseline and the edge over it, the last five episodes, and whether the condition is live right now
get_tracked_symbols	Every symbol with real-time data available

Your account — 1 tool

Tool	What it returns
get_my_account	Your Hyperliquid balance, open positions, unrealized PnL and paper account. Read-only, personal key required

---

Interactive views

In hosts that support MCP Apps, four tools render a real interface instead of a wall of text. Every view is a single self-contained HTML bundle with a deny-all CSP — it makes no network call of its own, because the data arrives inside the tool result.

Tool	View
get_signals	A card carousel — each card charts 24h of price with the entry, the next unreached take-profit and the stop drawn across it. Pages through the full result set, it never shows a silent slice
get_signal_details	One signal: chart with a price scale, the live price, entry / exit / level-hit markers judged on wicks, every level as an absolute price, the realised outcome and the validation meters
get_my_account	Balance and position cards, each charting entry against liquidation, with the strip coloured by how close you are
get_technical_indicators	Per timeframe a 96-bar chart with EMA lines, the SuperTrend band and swing / pivot support-resistance drawn across it, the summary's notes, one chip per indicator and a levels table. Several timeframes become tabs; footer buttons re-run the tool for 1h / 4h / 1d

Verified on claude.ai web with the deployed connector. Hosts without MCP Apps get the same data as text and structured content — nothing degrades.

---

Skills

The plugin ships six skills: playbooks that tell the assistant which tools answer which question, how to read the fields, and how to present the result without turning market data into advice. They live in skills/<name>/SKILL.md (Agent Skills format) and load automatically in Claude Code and Cursor. For the ChatGPT plugin portal, run scripts/package-skills.sh and upload the ZIPs from dist/skills/.

Skill	Triggers on	Tools it drives
market-briefing	"what's happening in crypto", "morning brief", "market update"	price, derivatives, screener, signal stats, signals
technical-analysis	"analyse BTC", "is SOL oversold", support/resistance, funding, open interest	technical indicators (multi-timeframe), derivatives, price, candles
market-screener	"which coins are oversold", "find setups", "compare BTC ETH SOL", "what happened after…"	screener, backtest
trading-signals	"latest AI signals", "is this signal still valid", "how are the signals doing"	signals, signal details, signal stats
smart-money	"what are whales doing", "best traders on Hyperliquid", "research this trader"	leaderboard, top traders, positions, profile, history, market stats
position-check	"check my positions", "how far am I from liquidation", "what do you think of my long"	account, technicals, derivatives, positions

Every skill carries the same conduct rules: report what the data shows and leave the decision to the user, never present a hit rate or a backtest as a forecast, and say plainly that the connector cannot place, close or move anything.

---

Authentication and limits

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

• Personal URL (recommended) — generate it at traderspy.app/mcp. The key is embedded (https://mcp.traderspy.app/mcp?token=mcp_...), so hosts that ask for authentication can be left on "None". Shown once, revocable any time.
• OAuth — for clients that drive the 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 — revocation takes effect on the very next call, and also invalidates any OAuth bearer issued for that account.

Plan	Daily calls	Data
Free	5	Real-time
Pro	100	Real-time

A multi-timeframe get_technical_indicators and a 100-symbol screen_symbols each cost one call, deliberately — the cheap way to use the connector is also the fast one.

Don't have an account? Sign up free.

---

Security

This connector's security model is mostly a list of things that do not exist.

Scope	How you authenticate	What it can reach
Anonymous	nothing	the tool catalogue only — tools/list, so directories can index it. Every actual call is refused
Personal key	mcp_… as a bearer token or ?token=	all public market data, plus your own account
OAuth	host-driven flow	the same

What no credential can do here:

• No order tool. Placing, closing or modifying an order does not exist — for live or paper accounts. The order tools were not hidden or feature-flagged; they were deleted.
• No withdrawal, transfer or deposit tool.
• No write of any kind. The connector's client toward the trading service exposes read wrappers only, so no code path can reach a mutating route even by mistake.
• No standing rules. It cannot create alerts, subscriptions or automations on your account.

Two reasons, and the second is the load-bearing one. First, the Anthropic Software Directory Policy excludes software that executes financial transactions on a user's behalf — and hiding such tools at call time is not enough, they must not appear in tools/list. Second, an MCP credential is a long-lived bearer token handed to a third-party host: everything it can reach is reachable by whoever holds it. So it reaches reads only.

Trading belongs in the TraderSpy web app or mobile app, where you are present for it.

---

Data sources

Source	What comes from it	Freshness
TraderSpy AI signal engine	Signals, targets, stops, validation scores, realised outcomes	Evaluated on cron; published only after validation
Smart-money trackers	Whale positions, leaderboards, trade history	5–60 min per exchange
Candle store	Prices, OHLCV, every indicator, the screener and the backtester	Live candle plus the last 1000 closed
Binance Futures public API	Funding, open interest, long/short ratios, taker flow	60s cache

Coverage is the Binance USDⓈ-M perpetual universe, plus perpetuals that trade on Hyperliquid but not on Binance. get_tracked_symbols is the authoritative list.

---

Architecture

Your AI client   Claude · Claude Code · ChatGPT · Grok · Cursor · Cline · Windsurf
       │
       │  MCP over Streamable HTTP (+ SSE)
       ▼
mcp.traderspy.app/mcp
       ├── 18 read-only tools       no order · no withdrawal · no transfer
       ├── 4 MCP Apps views         cards and charts where the host supports them
       ├── per-user daily quota     5 free · 100 pro
       └── API key · OAuth · URL token
       │
       ▼
TraderSpy platform
       ├── AI signal engine         entry · TP1–TP3 · stop · validation · outcome
       ├── Smart-money trackers     Binance · Hyperliquid · Bybit · OKX
       ├── Candle store             Binance USDⓈ-M + Hyperliquid-only perpetuals
       └── Binance Futures API      funding · open interest · long/short · taker flow

---

Prompts to try

Morning brief

"Give me a crypto morning brief: what moved, where funding is stretched, and what the AI signals fired overnight."

Find a setup

"Run the screener: RSI under 30 and ADX above 25 on the 4h, top 100 by volume. For anything it finds, show me the multi-timeframe read."

Check a thesis before acting

"Historically, what happened on SOLUSDT 4h after RSI crossed above 30? Compare it against the baseline over the same tape."

Follow the whales

"Who are the most profitable traders on Hyperliquid right now, and what are they positioned in? Then show me the position history of the top one."

Judge a signal

"Is the latest BTC signal still valid? Show me where price is against its entry, targets and stop."

Review your own book

"Show my account. For each open position, how far is liquidation, and what do the 1h/4h/1d indicators say about it?"

Compare coins

"Compare BTC, ETH and SOL on the 4h: trend, momentum, funding and open interest."

---

Changelog

Date	Change
2026-09-22	Cursor plugin: .cursor-plugin/plugin.json + mcp.json, key as TRADERSPY_API_KEY
2026-09-15	Plugin asks for the API key at install instead of connecting keyless (v1.4.0)
2026-09-12	Six playbook skills, packaged per skill for the ChatGPT plugin portal
2026-09-09	screen_symbols and backtest_condition — the condition language; 18 tools
2026-09-09	get_derivatives — funding, open interest and positioning
2026-09-09	get_technical_indicators rebuilt: 19 indicators, multi-timeframe, custom periods, series-aware
2026-08-26	Interactive MCP Apps views
2026-08-15	Read-only by construction — every order tool removed, not disabled

---

Links

• TraderSpy — the platform
• traderspy.app/mcp — generate your key, read the tutorial
• Glama listing — independent inspection and tool grading
• llms-install.md — install walkthrough for AI agents
• Smithery — alternative install path
• Privacy policy · Support

Disclaimer

TraderSpy provides market data and analysis, not financial advice. Signal statistics and backtests describe what already happened; they are not a forecast and not a guarantee. Trading crypto futures carries substantial risk. You are responsible for your own decisions.

License

MIT © TraderSpy