TraderSpy MCP

Crypto smart money & AI signals, wired straight into your AI assistant.

18 read-only tools · 4 exchanges · 19 technical indicators · 4 interactive views One URL. No install, no daemon, no broker, no API keys of your own.

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

Related MCP server: Simsar MCP

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

.cursor/mcp.json:

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

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:

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

Smart money — 7 tools

Market data & research — 7 tools

Your account — 1 tool

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.

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. For the ChatGPT plugin portal, run scripts/package-skills.sh and upload the ZIPs from dist/skills/.

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.

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.

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

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

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