Skip to main content
Glama
TradeStaq MCP

TradeStaq MCP

Official
by the-staq

TradeStaq MCP Server

npm version License: MIT

Website · Docs · MCP / AI Tools · Pricing

46 AI-powered trading tools for Claude, Cursor, and any MCP client.

Create strategies, backtest them, deploy trading bots, copy top traders, monitor positions, and manage your crypto portfolio, all from conversation. Supports Binance, Bybit, OKX, Bitget, Hyperliquid, dYdX, and more.

"Show me my portfolio" → get_portfolio
"Backtest GhostRider on BTC/USDT for 3 months" → what_if_backtest
"Deploy it on my Binance account" → deploy_bot
"Who are the top traders this month?" → list_top_traders
"Generate a momentum strategy for ETH" → generate_strategy

Quick Start

Option A: Remote server (no install needed)

For MCP clients that support HTTP transport:

{
  "mcpServers": {
    "tradestaq": {
      "url": "https://mcp.tradestaq.com/mcp"
    }
  }
}

No clone, no build. Just add to your MCP config:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "tradestaq": {
      "command": "npx",
      "args": ["-y", "@the-staq/tradestaq-mcp"]
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "tradestaq": {
      "command": "npx",
      "args": ["-y", "@the-staq/tradestaq-mcp"]
    }
  }
}

Claude Code:

claude mcp add tradestaq -- npx -y @the-staq/tradestaq-mcp

Option C: Clone and build

git clone https://github.com/the-staq/tradestaq-mcp.git
cd tradestaq-mcp
npm install
npm run build

Then point your MCP client to dist/index.js.

Related MCP server: Trading MCP Server

Authenticate

After adding the server, ask your AI assistant to log in:

  • "Log me in to TradeStaq" — uses email/password directly

  • "Authenticate with TradeStaq" — opens a browser window for secure OAuth login

Credentials never enter the chat when using the browser flow. Token is stored locally at ~/.tradestaq/mcp-config.json with restricted permissions (0600).

Tools

Auth

Tool

Description

login

Log in with email and password

authenticate

Log in via browser (OAuth + PKCE)

check_auth

Check authentication status

set_token

Manually set a JWT token

connect_exchange

Connect an exchange account via browser

logout

Remove stored credentials

Market Data

Tool

Description

get_price

Current price, 24h change, volume

get_candles

OHLCV candlestick data (1m to 1d)

list_exchanges

List connected exchange accounts

search_markets

Find trading pairs on a specific exchange

Portfolio

Tool

Description

get_portfolio

Total balance, exchanges, active bots

get_positions

Open positions with live PnL

Strategies

Tool

Description

list_strategies

Browse marketplace or your own strategies

get_strategy

Full strategy details and performance

explain_strategy

Plain-English explanation with risk profile

compare_strategies

Side-by-side metrics comparison

create_strategy

Create a strategy from TradeDroid code

generate_strategy

Generate a strategy from natural language using AI

Backtesting

Tool

Description

what_if_backtest

Run a historical backtest (async, 30-120s)

get_backtest_results

Check status of a running backtest

Bot Management

Tool

Description

list_bots

All bots with status and performance

get_bot_status

Detailed bot metrics and config

get_bot_logs

Run-by-run history: why a bot did or did not trade, dropped signals, errors

deploy_bot

Deploy a strategy as a trading bot

update_bot

Edit a bot: rename, switch strategy or apply a preset, timeframe, execution mode, strategy parameters, version channel, risk settings, notifications, stopAfterClose

start_bot

Start a paused or stopped bot

stop_bot

Stop a running bot now (open positions are left unmanaged)

delete_bot

Delete a bot (refused while it has an open trade)

close_position

Close an open position (full or partial)

list_bot_share_links

A bot's public chart links (tradestaq.com/chart/...)

create_bot_share_link

Make a public link to a bot's live chart (choose expiry and whether PnL shows)

revoke_bot_share_link

Turn a public chart link off

deploy_bot defaults to paper trading. Pass live: true for real money. The bot trades on the strategy's own timeframe; pass timeframe (e.g. 4h) only to override it. Leave out name and the server names the bot. The bot starts trading as soon as it is created, so give it its settings in the same call: presetId (a preset's ID or slug, of the same strategy), parameterOverrides and executionMode; the server applies them in the create itself (with a preset the bot is created paused, then started). strategyId takes an ID or a slug. start: false creates it paused for start_bot.

update_bot sends everything you pass in one update, after merging it onto the bot's current settings (position sizing, spin settings and parameter overrides are never wiped by a partial change). Size and leverage change only when you pass them. strategyId and presetId take an ID or a slug (trade-wind, trade-wind-long-short). A strategy or timeframe change needs the bot to be flat: pause it with stopAfterClose: true first, wait until get_bot_status shows no open position, then switch, then start_bot. A live bot needs the mcp:live scope for any change; a paper bot mcp:paper. The reply is the resulting config (strategy, version, timeframe, mode, overrides, size, leverage, status) plus server warnings.

For example, switching a paused 15m GhostRider bot to Trade Wind on 4h with its Long & Short preset, and renaming it:

{ "id": "6ab7c2d60014ba19b0c54258", "presetId": "trade-wind-long-short", "timeframe": "4h", "name": "Trade Wind · SUI · 4h" }

Trade History

Tool

Description

get_trade_history

Closed trades, one row per close: direction, entry/exit prices, PnL, return on position size

get_performance_metrics

ROI, win rate, Sortino ratio, PnL breakdown

Copy Trading

Tool

Description

list_top_traders

Browse the leaderboard of top traders

follow_trader

Subscribe to copy a trader's trades

Advisor

Tool

Description

suggest_strategies

Match strategies to your risk profile

get_market_context

Trend, volatility, support/resistance for a symbol

Prompt Templates

Trading Assistant — Start a conversation about your portfolio and positions. The AI calls get_portfolio and get_positions to ground its responses in your actual data.

Strategy Builder — Walk through creating, backtesting, and deploying a strategy. Pass an optional goal like "momentum strategy for ETH" to get focused suggestions.

Portfolio Reviewer — Deep analysis of your portfolio, positions, trade history, and performance. Identifies what's working, what isn't, and suggests improvements.

Resources

MCP resources provide browsable data that AI clients can read directly:

Resource

URI

Description

Portfolio

tradestaq://portfolio

Balances, positions, and active bots

Bots

tradestaq://bots

All bots with status and PnL

Strategies

tradestaq://strategies

Strategy catalog with ratings

Architecture

                    stdio                                    HTTPS
┌──────────────┐◄──────────►┐                  ┌────────────────►┌──────────────┐
│Claude Desktop│             │                  │                 │              │
│Cursor / CLI  │             │  tradestaq-mcp   │   Bearer JWT    │  TradeStaq   │
└──────────────┘             │  46 tools        │◄────────────────│  API         │
                             │  3 prompts       │                 │              │
┌──────────────┐  HTTP+SSE  │  3 resources      │                 └──────────────┘
│ Any MCP      │◄──────────►│                  │
│ client (web) │             └──────────────────┘
└──────────────┘
  • Two transports: stdio (local, default) and HTTP+SSE (remote, --http flag)

  • Hosted at https://mcp.tradestaq.com/mcp for remote clients

  • JWT auth via OAuth PKCE or email/password login

  • All tools return structured JSON with error contract

  • Token auto-refresh before the access token expires. Several local copies (say an interactive session plus headless claude -p runs) can share one sign-in: they refresh one at a time under a lockfile next to ~/.tradestaq/mcp-config.json, and a copy whose tokens another one rotated picks up the new pair from the file

Development

npm run dev        # watch mode with tsx
npm run build      # compile TypeScript
npm run lint       # type check without emitting
npm test           # run tests
npm start          # run server (stdio)
npm run start:http # run server (HTTP+SSE on port 3100)

Releasing

npm run release:patch   # or release:minor / release:major

This bumps the version (and the server.json versions), files the CHANGELOG's [Unreleased] notes under it, commits, tags vX.Y.Z and pushes. The tag triggers .github/workflows/publish.yml:

  1. Approve the run. The publish job waits in the npm environment for a maintainer's approval (Actions, then the run, then Review deployments).

  2. It type-checks, tests and publishes to npm through trusted publishing (no npm token anywhere), with provenance.

  3. It updates the listing on the official MCP Registry.

Then run the Deploy MCP workflow to update the hosted server at mcp.tradestaq.com.

Error Handling

All tool errors return structured responses:

{
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Human-readable description",
    "retryable": true,
    "retryAfterMs": 5000
  }
}

Error codes: AUTH_EXPIRED, TIMEOUT, RATE_LIMITED, NETWORK_ERROR, HTTP_4xx, HTTP_5xx.

Security

  • Credentials never enter AI conversation history

  • OAuth PKCE flow with browser-based authentication

  • Token stored with 0600 file permissions

  • Localhost-only OAuth callbacks

  • deploy_bot, stop_bot, close_position, and follow_trader are destructive operations (AI confirms with user)

License

MIT

Available Tools

34 tools
authenticateA

Log in to TradeStaq via browser. Opens a login page in your browser — you authenticate there and the token is saved automatically. No credentials enter the chat.

Scope controls what the agent can do: "mcp:read" (view-only research agents), "mcp:paper" (paper-trade bots, safe default — cannot touch live money), "mcp:live" (full access including live-money deploys, live exchange connections, and wallet charges). Scopes are hierarchical: live implies paper implies read. When in doubt, pick paper first — the server returns 403 insufficient_scope if the agent tries a live action, and the user can always re-authorize with a broader scope.

Inputs: scope.

check_authA

Preflight check before invoking other tools. Returns the authenticated user, OAuth scope on the current token (mcp:read / mcp:paper / mcp:live), tier capabilities (allowLiveTrading, allowAIBuilder, allowNewsTrading, allowMcpServer), Strategy Lab wallet balance (for cost-charging tools like generate_strategy), and the OAuth client name/expiry. Agents should call this at the start of a workflow to pick the narrowest scope needed and to surface cost/balance to the user before committing to a charge. Response is cached server-side for 30s per token.

Inputs: no named parameters.

close_positionB

Close an open trading position. WARNING: This executes a market order to close your position.

Inputs: symbol (required), tradeId (required), exchangeId (required), percentage.

compare_strategiesC

Compare multiple strategies side by side on key metrics.

Inputs: ids (required).

connect_exchangeA

Connect a new exchange account via browser. Opens a page where you securely enter your exchange API keys. Keys never enter the chat.

Inputs: no named parameters.

create_paper_exchangeA

Create a paper-trading exchange with a simulated balance. No API keys required. Paper exchanges let agents test strategies, deploy bots, and place trades without risking real money. Recommended starting point for first-time users and any scope=mcp:paper workflow.

Requires OAuth scope mcp:paper or mcp:live. Session-cookie users (dashboard) can always call this.

Inputs: platform (required), accountLabel, exchangeType, initialBalanceUsdt.

create_strategyC

Create a new trading strategy from TradeDroid code.

Inputs: code (required), name (required), market, timeframe, +1 more.

deploy_botA

Deploy a strategy as a trading bot. Defaults to paper trading for safety.

Inputs: exchangeId (required), strategyId (required), live, name, +4 more.

explain_strategyA

Get a plain-English explanation of a strategy: what it does, risk profile, best market conditions.

Inputs: id (required).

export_backtestA

Get export links for a completed backtest. Returns CSV and PDF download URLs.

Inputs: id (required).

export_bot_tradesB

Export a bot's trade history as structured data. Returns all trades with PnL, entry/exit prices, and performance summary.

Inputs: id (required), format.

follow_traderA

Subscribe to copy a top trader's trades. WARNING: This commits capital to copy trading.

Inputs: masterId (required), exchangeId (required), multiplier.

generate_strategyB

Generate a trading strategy from a natural language description using AI. Describe what you want and AI creates the TradeDroid code.

Inputs: description (required), market, timeframe.

get_backtest_resultsA

Check status/results of a previously started backtest.

Inputs: jobId (required).

get_bot_statusC

Get detailed status and performance for a specific bot.

Inputs: id (required).

get_candlesC

Get OHLCV candlestick data for a trading pair.

Inputs: symbol (required), limit, exchange, timeframe.

get_market_contextB

Get market context for a symbol: trend direction, volatility level, support/resistance levels.

Inputs: symbol (required), exchangeId (required), timeframe.

get_performance_metricsB

Get trading performance metrics: ROI, win rate, PnL, Sortino ratio.

Inputs: timeRange, tradeType, exchangeId.

get_portfolioA

Get portfolio overview: total balance, exchanges, and active bots.

Inputs: no named parameters.

get_positionsA

Get all open trading positions with current PnL.

Inputs: exchange.

get_priceB

Get the current price of a trading pair (e.g. BTC/USDT).

Inputs: symbol (required), exchange.

get_strategyB

Get detailed info about a specific strategy.

Inputs: id (required).

get_trade_historyB

Get your closed trade history with PnL, entry/exit prices, and duration.

Inputs: page, limit, symbol, exchange.

list_botsA

List all your trading bots with status and performance.

Inputs: no named parameters.

list_exchangesA

List your connected exchange accounts with their IDs, platform names, and status.

Inputs: no named parameters.

list_strategiesB

List available trading strategies.

Inputs: owned.

list_top_tradersA

Browse the leaderboard of top-performing traders you can copy.

Inputs: limit, period, sortBy.

loginB

Log in to TradeStaq with email and password.

Inputs: email (required), password (required).

logoutB

Remove stored TradeStaq credentials.

Inputs: no named parameters.

search_marketsA

Search for trading pairs on a specific exchange. Use list_exchanges to find your exchange IDs.

Inputs: query (required), exchange (required).

set_tokenC

Manually set a JWT token. For advanced use only.

Inputs: token (required), baseUrl.

stop_botB

Stop a running trading bot. Open positions remain.

Inputs: id (required).

suggest_strategiesA

Suggest trading strategies matching your risk profile. Filters by risk tolerance, max drawdown, preferred assets, and minimum Sharpe ratio.

Inputs: minSharpe, maxDrawdown, riskTolerance, preferredAssets.

what_if_backtestA

Run a backtest on a strategy. Async, may take 30-120 seconds. Returns full performance metrics.

Inputs: exchange (required), strategyId (required), period, symbol, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 34 tools

    Disambiguation4/5

    Most tools have clearly distinct purposes, with only minor overlap among auth-related tools (authenticate, login, set_token) and portfolio vs positions vs trade history. Descriptions are sufficiently detailed to resolve ambiguity.

    Naming Consistency5/5

    Tool names consistently follow the verb_noun pattern (e.g., close_position, create_strategy, list_bots). Only login/logout deviate, but that's standard for auth verbs. The pattern is predictable and uniform.

    Tool Count3/5

    34 tools is above the typical 3-15 range for a well-scoped server. While the domain is broad (strategy management, backtesting, bots, portfolio, copy trading), the number feels heavy and may overwhelm agents.

    Completeness3/5

    The tool surface covers core trading workflows but lacks update and delete operations for strategies and bots. Create and deploy are present, but modifications and deletions are absent, creating notable gaps.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to perform cryptocurrency trading analysis and execution with 38+ tools including real-time market data, technical indicators, risk management, and support for both paper trading and live execution on Hyperliquid.
      7
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Provides a comprehensive suite of 20 tools for cryptocurrency trading and technical analysis across 100+ exchanges like Binance and MEXC via CCXT. It enables users to execute orders, track positions, and scan for market opportunities through Claude Desktop using natural language.
      20
      37 npm
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Open-source MCP server for market analysis: screeners, multi-timeframe technical analysis and backtests for crypto, stocks, forex and futures. 39 tools. Hosted version: TradingMCP.
      37
      1,483 PyPI
      5,292
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      The most complete AI-powered trading toolkit for Claude and MCP clients, offering backtesting, live sentiment, Yahoo Finance, and 30+ technical analysis tools in one MCP server.
      MIT