# TraderSpy

> TraderSpy is a free MCP server for finance and payments. Read-only crypto futures signals, whale positions and indicators for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, Web
- **Website:** https://traderspy.app/mcp
- **Repository:** https://github.com/target1m/traderspy-mcp
- **MCP Registry name:** app.traderspy/traderspy
- **Categories:** finance and payments
- **Listing updated:** 2026-11-15

## About

Aimed at traders who want an assistant to read the market rather than act on it, this connector exposes 17 tools and 3 interactive views and deliberately has no order, withdrawal or transfer tool and cannot see anyone's account. It answers from public market data.

The README maps questions to calls: screening the top 100 coins by 24-hour volume for oversold conditions, pulling 1h, 4h and 1d readings of 19 technical indicators in one call, comparing whale positioning across Binance, Hyperliquid, Bybit and OKX, checking a signal's live price against its entry, take-profit and stop-loss, and running event-study backtests over up to 1000 stored candles. Funding, open interest and derivatives data are also covered.

Claude, Claude Code, ChatGPT, Grok and Gemini sign in with a TraderSpy account over OAuth, and a free account is enough. Clients without a sign-in window, such as Cursor, Cline, Windsurf and n8n, use a personal key beginning mcp_, which can be revoked at any time. The Claude Code plugin also installs six skills.

## Features

- **Condition screener:** Scans the top 100 symbols by volume in one pass for set conditions.
- **Multi-timeframe indicators:** Returns 19 technical indicators across up to three timeframes.
- **Whale positions:** Shows large-trader positioning across four exchanges.
- **Signal tracking:** Compares a signal's live price with its entry, target and stop.
- **Event-study backtests:** Tests what followed a setup over up to 1000 stored candles.
- **Read-only by design:** Offers no tool to place orders, withdraw or view accounts.

## Good for

- Find which coins look oversold right now
- Check whether a trend still holds across timeframes
- See what large traders are doing on major exchanges
- Verify whether an AI signal is still valid
- Backtest what usually happens after a setup

## Install

### Claude Code (Terminal)

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

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

```sh
https://mcp.traderspy.app/mcp
```

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

```json
{
  "mcpServers": {
    "traderspy": {
      "url": "https://mcp.traderspy.app/mcp"
    }
  }
}
```

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

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

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

```json
{
  "mcpServers": {
    "traderspy": {
      "serverUrl": "https://mcp.traderspy.app/mcp"
    }
  }
}
```

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

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

## Tools

- `screen_symbols`: Screens the top 100 symbols by 24h volume against conditions.
- `get_technical_indicators`: Returns indicators across 1h, 4h and 1d in one call.
- `get_positions`: Shows whale positions across four exchanges.
- `get_signal_details`: Checks a signal's live price against entry, take-profit and stop-loss.
- `backtest_condition`: Backtests a condition over up to 1000 stored candles.

## FAQ

### Can it place trades?

No. Every tool is read-only; there is no order, withdrawal or transfer tool.

### Do I need an API key?

Not for Claude, ChatGPT, Grok or Gemini, which use OAuth sign-in. Cursor, Cline and scripts use a personal key from the TraderSpy MCP page.

### Is a paid account required?

The README says a free account is enough.

### Which exchanges does it cover?

Whale positioning covers Binance, Hyperliquid, Bybit and OKX.

### Is TraderSpy free?

Yes. TraderSpy is free to use.

### How do I add TraderSpy to Claude Code?

Run this command in your terminal: claude mcp add --transport http traderspy https://mcp.traderspy.app/mcp

### What are the best alternatives to TraderSpy?

The closest alternatives to TraderSpy 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/traderspy
